Skip to content

SDK Quickstarts #457

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 91 commits into from
Jun 3, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
91 commits
Select commit Hold shift + click to select a range
554aec0
feat: add phone support agent workflow example
goosewin May 26, 2025
4769ff0
feat: update navigation to link new customer support hotline example
goosewin May 26, 2025
44ab9ad
feat: add screenshots for customer support hotline example
goosewin May 26, 2025
a6c90a6
fix: customer support hotline intro paragraph
goosewin May 26, 2025
e7f9bf0
fix(customer-support-hotline): image URLs
goosewin May 26, 2025
e9ad9e1
fix(customer-support-hotline): remove broken link from outro
goosewin May 26, 2025
6a69671
chore (customer-support-hotline): refine copy, add videos
goosewin May 26, 2025
07ced34
chore(customer-support-hotline): delete unnecessary screenshots
goosewin May 26, 2025
d9f31a0
fix(customer-support-hotline): slug
goosewin May 26, 2025
568958d
feat(appointment-scheduling): initial commit
goosewin May 26, 2025
69221a1
feat(banking-customer-support): update example to cover a banking use…
goosewin May 26, 2025
77aaefd
Merge branch 'main' into feature/customer-support-hotline-example
goosewin May 26, 2025
18c313b
feat: create dedicated `examples` page
goosewin May 26, 2025
5947486
feat(web): add web sdk quickstart
goosewin May 26, 2025
c793def
chore(dashboard): update dashboard quickstart for consistency
goosewin May 26, 2025
9d52489
chore: update navigation
goosewin May 26, 2025
721c0b3
chore(inbound-support): address review feedback, fix system prompt
goosewin May 26, 2025
b1afd64
Merge branch 'feature/customer-support-hotline-example' into feature/…
goosewin May 26, 2025
2a61406
feat(quickstart/web): remove less popular framework starters, expand …
goosewin May 27, 2025
4eecbcb
Merge branch 'main' into feature/web-sdk-quickstart
goosewin May 27, 2025
26591be
chore(quickstart/web): address PR feedback
goosewin May 27, 2025
35d4096
feat(appointment-scheduling): new workflow example
goosewin May 28, 2025
20676bc
feat(clinic-triage-scheduling): new workflow example
goosewin May 28, 2025
99d9ed0
feat(ecommerce-order-management): new workflow example
goosewin May 28, 2025
35e858b
feat(outbound-sales): new workflow example
goosewin May 28, 2025
cffa8e6
chore: delete pizza example
goosewin May 28, 2025
d87d303
fix: broken video URLs
goosewin May 28, 2025
75b3387
chore: update navigation to include new workflow examples
goosewin May 28, 2025
aa45fae
fix(inbound-support): broken video URL
goosewin May 28, 2025
6515261
chore: update `overview.mdx` to display new examples
goosewin May 28, 2025
40ac27a
feat(call-forwarding): update doc to incentivize use of dashboard
goosewin May 28, 2025
f77e415
feat(using-query-tool): update doc to incentivize use of dashboard
goosewin May 28, 2025
11a6198
feat(custom-tools): update doc to incentivize use of dashboard
goosewin May 28, 2025
0337c2e
Merge branch 'main' into feature/web-sdk-quickstart
goosewin May 29, 2025
6f43a80
Merge branch 'main' into feature/workflow-examples
goosewin May 30, 2025
68a902f
feat(workflows/overview): add doc
goosewin May 30, 2025
f865d93
feat(workflows/quickstart): add doc
goosewin May 30, 2025
372f490
feat(workflows): move docs, add new videos
goosewin May 30, 2025
67b61a9
chore: update nav to include workflow docs
goosewin May 30, 2025
379c224
feat(docs-agent): add code snippets
goosewin May 30, 2025
0b6c1c8
feat(examples/inbound-support): add code snippets
goosewin May 30, 2025
56f4cd5
feat(examples/outbound-call-python): add code snippets
goosewin May 30, 2025
c8d494c
feat(examples/voice-widget): add code snippets
goosewin May 30, 2025
5a551a3
feat(quickstart/dashboard): add code snippets
goosewin May 30, 2025
090f786
feat(workflows/quickstart): add code snippets
goosewin May 30, 2025
58b12c8
feat(workflows/appointment-scheduling): add code snippets
goosewin May 30, 2025
894b5f6
feat(workflows/clinic-triage-scheduling): add code snippets
goosewin May 30, 2025
93783fc
feat(workflows/ecommerce-order-management): add code snippets
goosewin May 30, 2025
908aeb1
feat(workflows/outbound-sales): add code snippets
goosewin May 30, 2025
2755377
feat: create dedicated `examples` page
goosewin May 26, 2025
fc0e854
feat(web): add web sdk quickstart
goosewin May 26, 2025
280b944
chore(dashboard): update dashboard quickstart for consistency
goosewin May 26, 2025
c24d5f7
chore: update navigation
goosewin May 26, 2025
0f615c8
feat(quickstart/web): remove less popular framework starters, expand …
goosewin May 27, 2025
f77704c
chore(quickstart/web): address PR feedback
goosewin May 27, 2025
f09603c
Merge branch 'feature/web-sdk-quickstart' of https://github.com/VapiA…
goosewin May 30, 2025
e9436df
feat(quickstart): introduce SDK quickstarts
goosewin May 30, 2025
919b808
Merge branch 'main' into feature/examples-code
goosewin Jun 1, 2025
64f655f
Merge branch 'feature/examples-code' into feature/sdk-quickstarts
goosewin Jun 1, 2025
009a9b4
Merge branch 'main' into feature/examples-code
goosewin Jun 3, 2025
06c324e
chore: delete `.DS_Store`
goosewin Jun 3, 2025
b5a5f4b
Merge branch 'main' into feature/examples-code
goosewin Jun 3, 2025
d822315
feat(workflows/quickstart): new code examples
goosewin Jun 3, 2025
a8c3dbb
feat(examples/docs-agent): new code examples
goosewin Jun 3, 2025
f30f81c
feat(examples/inbound-support): new code examples
goosewin Jun 3, 2025
551bd36
feat(examples/voice-widget): new code examples
goosewin Jun 3, 2025
ca02191
feat(quickstart/dashboard): new code examples
goosewin Jun 3, 2025
d2ad299
feat(quickstart/phone): new code examples
goosewin Jun 3, 2025
c45b072
feat(workflows/outbound-sales): new code examples
goosewin Jun 3, 2025
df4ecd3
feat(workflows/ecommerce-order-management): new code examples
goosewin Jun 3, 2025
6650fd1
feat(workflows/appointment-scheduling): new code examples
goosewin Jun 3, 2025
7e6fa59
feat(workflows/clinic-triage-scheduling): new code examples
goosewin Jun 3, 2025
ffc7375
chore: add other pm install options, cleanup
goosewin Jun 3, 2025
ab24710
chore: replace `gpt-4` occurrences with `gpt-4o` to stay up-to-date
goosewin Jun 3, 2025
924a316
chore: replace `gpt-3.5-turbo` occurrences with `gpt-4o` to stay up-t…
goosewin Jun 3, 2025
a41fb3a
chore: delete `outbound-call-python` example
goosewin Jun 3, 2025
54a286a
fix: code examples
goosewin Jun 3, 2025
b4dd48a
fix: delete duplicate merge doc
goosewin Jun 3, 2025
a8d3d8d
chore: cleanup video assets
goosewin Jun 3, 2025
538001b
chore: cleanup merge duplicates, restructure dirs for consistency
goosewin Jun 3, 2025
7ece6f1
Merge branch 'feature/examples-code' into feature/sdk-quickstarts
goosewin Jun 3, 2025
053c0d4
feat: merge `client-sdk.mdx` and `server-sdk.mdx` pages into `web.mdx`
goosewin Jun 3, 2025
96c77d4
feat: examples library, update examples on introduction page
goosewin Jun 3, 2025
6399b60
chore: reorganize examples into assistant- and workflow-based sections
goosewin Jun 3, 2025
7e1f655
fix: typo
goosewin Jun 3, 2025
de9f930
Merge branch 'main' into feature/sdk-quickstarts
goosewin Jun 3, 2025
c8cf4f1
fix: broken links
goosewin Jun 3, 2025
305cb15
fix: typo
goosewin Jun 3, 2025
184602d
fix: broken links
goosewin Jun 3, 2025
8ba972a
fix: example links
goosewin Jun 3, 2025
a46a821
fix: remove old examples link
goosewin Jun 3, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Documentation agent
subtitle: Build a voice assistant that answers questions about your docs
slug: examples/docs-agent
slug: assistants/examples/docs-agent
---

Try our live implementation using the voice widget in the bottom-right corner of this page.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Inbound customer support
subtitle: Build a banking customer support agent that can process inbound phone calls and assist with common banking issues.
slug: examples/inbound-support
slug: assistants/examples/inbound-support
description: Build a voice AI banking support agent with tools for account lookup, balance and transaction retrieval.
---

Expand Down Expand Up @@ -33,10 +33,10 @@ We will be creating a customer support agent for VapiBank, a bank that wants to
<Steps>
<Step title="Download the spreadsheets">
<div className="flex gap-2">
<Download src="../static/spreadsheets/inbound-support/accounts.csv">
<Download src="../../static/spreadsheets/inbound-support/accounts.csv">
<Button intent="primary">Download accounts.csv</Button>
</Download>
<Download src="../static/spreadsheets/inbound-support/transactions.csv">
<Download src="../../static/spreadsheets/inbound-support/transactions.csv">
<Button intent="primary">Download transactions.csv</Button>
</Download>
</div>
Expand All @@ -48,7 +48,7 @@ We will be creating a customer support agent for VapiBank, a bank that wants to
2. Click **Choose file** and upload both `accounts.csv` and `transactions.csv`
3. Note the file IDs for use in creating tools

<video autoPlay loop muted src="../static/videos/upload-files.mp4" type="video/mp4" style={{ aspectRatio: '16 / 9', width: '100%' }} />
<video autoPlay loop muted src="../../static/videos/upload-files.mp4" type="video/mp4" style={{ aspectRatio: '16 / 9', width: '100%' }} />
</Tab>
<Tab title="TypeScript (Server SDK)">
```typescript
Expand Down Expand Up @@ -132,7 +132,7 @@ We will be creating a customer support agent for VapiBank, a bank that wants to
- Select `Blank Template` as your starting point.
- Change assistant name to `Tom`.

<video autoPlay loop muted src="../static/videos/inbound-support/create-assistant.mp4" type="video/mp4" style={{ aspectRatio: '16 / 9', width: '100%' }} />
<video autoPlay loop muted src="../../static/videos/inbound-support/create-assistant.mp4" type="video/mp4" style={{ aspectRatio: '16 / 9', width: '100%' }} />
</Step>
</Steps>
</Tab>
Expand Down Expand Up @@ -527,7 +527,7 @@ You have access to CSV files with account and transaction data:
<Tab title="Dashboard">
Click `Talk to Assistant` to test it out.

<video autoPlay loop muted src="../static/videos/inbound-support/configure-assistant.mp4" type="video/mp4" style={{ aspectRatio: '16 / 9', width: '100%' }} />
<video autoPlay loop muted src="../../static/videos/inbound-support/configure-assistant.mp4" type="video/mp4" style={{ aspectRatio: '16 / 9', width: '100%' }} />
</Tab>
<Tab title="TypeScript (Server SDK)">
```typescript
Expand Down Expand Up @@ -662,7 +662,7 @@ You have access to CSV files with account and transaction data:
- In the expanded accordion, add `get_balance` and `get_recent_transactions` tools.
- Click `Publish` to save your changes.

<video autoPlay loop muted src="../static/videos/inbound-support/assistant-tools.mp4" type="video/mp4" style={{ aspectRatio: '16 / 9', width: '100%' }} />
<video autoPlay loop muted src="../../static/videos/inbound-support/assistant-tools.mp4" type="video/mp4" style={{ aspectRatio: '16 / 9', width: '100%' }} />
</Step>
</Steps>
</Tab>
Expand Down Expand Up @@ -915,7 +915,7 @@ You have access to CSV files with account and transaction data:
- Under `Inbound Settings` find `Assistant` dropdown and select `Tom` from the list.
- Changes are saved automatically.

<video autoPlay loop muted src="../static/videos/inbound-support/assign-phone-number.mp4" type="video/mp4" style={{ aspectRatio: '16 / 9', width: '100%' }} />
<video autoPlay loop muted src="../../static/videos/inbound-support/assign-phone-number.mp4" type="video/mp4" style={{ aspectRatio: '16 / 9', width: '100%' }} />
</Step>
</Steps>
</Tab>
Expand Down Expand Up @@ -998,7 +998,7 @@ You have access to CSV files with account and transaction data:
- Accept the generated test case.
- Click `Run Test Suite` to execute the tests.

<video autoPlay loop muted src="../static/videos/inbound-support/create-test-suite.mp4" type="video/mp4" style={{ aspectRatio: '16 / 9', width: '100%' }} />
<video autoPlay loop muted src="../../static/videos/inbound-support/create-test-suite.mp4" type="video/mp4" style={{ aspectRatio: '16 / 9', width: '100%' }} />
</Step>
<Step title="Run the test suite">
Click `Run Tests` to execute the tests.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: Web Snippet
subtitle: >-
Easily integrate the Vapi Voice Widget into your website for enhanced user
interaction.
slug: examples/voice-widget
slug: assistants/examples/voice-widget
---

Improve your website's user interaction with the Vapi Voice Widget. This robust tool enables your visitors to engage with a voice assistant for support and interaction, offering a smooth and contemporary way to connect with your services.
Expand Down
71 changes: 40 additions & 31 deletions fern/docs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -104,27 +104,9 @@ navigation:
- page: Web calls
icon: fa-light fa-browser
path: quickstart/web.mdx
- section: How Vapi works
icon: fa-light fa-diagram-project
contents:
- page: Core models
path: quickstart.mdx
icon: fa-light fa-microchip-ai
- page: Orchestration models
icon: fa-light fa-network-wired
path: how-vapi-works.mdx
- section: Examples
icon: fa-light fa-code
contents:
- page: Inbound support
path: examples/inbound-support.mdx
icon: fa-light fa-phone-volume
- page: Voice widget
path: examples/voice-widget.mdx
icon: fa-light fa-window-maximize
- page: Documentation agent
path: examples/docs-agent.mdx
icon: fa-light fa-microphone
- page: Example Library
icon: fa-light fa-book-open
path: examples.mdx

- section: Assistants
contents:
Expand Down Expand Up @@ -214,6 +196,18 @@ navigation:
path: customization/custom-llm/using-your-server.mdx
- page: Tool calling integration
path: customization/custom-llm/tool-calling-integration.mdx
- section: Examples
icon: fa-light fa-code
contents:
- page: Inbound support
path: assistants/examples/inbound-support.mdx
icon: fa-light fa-phone-volume
- page: Voice widget
path: assistants/examples/voice-widget.mdx
icon: fa-light fa-window-maximize
- page: Documentation agent
path: assistants/examples/docs-agent.mdx
icon: fa-light fa-microphone

- section: Workflows
contents:
Expand Down Expand Up @@ -382,6 +376,15 @@ navigation:
- page: FAQ
path: faq.mdx
icon: fa-light fa-question
- section: How Vapi works
icon: fa-light fa-diagram-project
contents:
- page: Core models
path: quickstart.mdx
icon: fa-light fa-microchip-ai
- page: Orchestration models
icon: fa-light fa-network-wired
path: how-vapi-works.mdx
- section: Integrations
collapsed: true
icon: fa-light fa-link
Expand Down Expand Up @@ -575,29 +578,29 @@ navigation:
layout:
- section: Client SDKs
contents:
- page: Web
path: sdk/web.mdx
icon: fa-light fa-globe
- link: Web SDK
href: https://github.com/VapiAI/web
icon: fa-brands fa-js
- link: iOS
href: https://github.com/VapiAI/ios
icon: fa-brands fa-app-store-ios
icon: fa-brands fa-apple
- link: Flutter
href: https://github.com/VapiAI/flutter
icon: fa-brands fa-google
icon: fa-light fa-mobile
- link: React Native
href: https://github.com/VapiAI/react-native-sdk
href: https://github.com/VapiAI/react-native
icon: fa-brands fa-react
- link: Python
href: https://github.com/VapiAI/python
icon: fa-brands fa-python
- section: Server SDKs
contents:
- link: Python
href: https://github.com/VapiAI/server-sdk-python
icon: fa-brands fa-python
- link: TypeScript
href: https://github.com/VapiAI/server-sdk-typescript
icon: fa-brands fa-js
- link: Python
href: https://github.com/VapiAI/server-sdk-python
icon: fa-brands fa-python
- link: Java
href: https://github.com/VapiAI/server-sdk-java
icon: fa-brands fa-java
Expand All @@ -606,7 +609,7 @@ navigation:
icon: fa-light fa-gem
- link: C#
href: https://github.com/VapiAI/server-sdk-csharp
icon: fa-light fa-hashtag
icon: fa-light fa-brackets-curly
- link: Go
href: https://github.com/VapiAI/server-sdk-go
icon: fa-brands fa-golang
Expand Down Expand Up @@ -811,3 +814,9 @@ redirects:
destination: /workflows/quickstart
- source: /web-integration
destination: /web
- source: /examples/inbound-support
destination: /assistants/examples/inbound-support
- source: /examples/voice-widget
destination: /assistants/examples/voice-widget
- source: /examples/docs-agent
destination: /assistants/examples/docs-agent
64 changes: 64 additions & 0 deletions fern/examples.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,64 @@
---
title: Examples Library
subtitle: Explore complete examples with step-by-step instructions to build with Vapi
slug: examples
---

<CardGroup cols={2}>
<Card title="Docs Agent" icon="book-open" href="/assistants/examples/docs-agent">
<div className='absolute top-4 right-4'>
<Icon icon="arrow-up-right-from-square" />
</div>
<div class="vapi-badge vapi-badge-assistant">Built with Assistants</div>
<br />
Build a docs agent that can answer questions about your documentation
</Card>
<Card title="Inbound Support" icon="headset" href="/assistants/examples/inbound-support">
<div className='absolute top-4 right-4'>
<Icon icon="arrow-up-right-from-square" />
</div>
<div class="vapi-badge vapi-badge-assistant">Built with Assistants</div>
<br />
Build a technical support assistant that remembers where you left off between calls
</Card>
<Card title="Voice Widget" icon="microphone" href="/assistants/examples/voice-widget">
<div className='absolute top-4 right-4'>
<Icon icon="arrow-up-right-from-square" />
</div>
<div class="vapi-badge vapi-badge-assistant">Built with Assistants</div>
<br />
Easily integrate the Vapi Voice Widget into your website for enhanced user interaction
</Card>
<Card title="Appointment Scheduling" icon="calendar-check" href="/workflows/examples/appointment-scheduling">
<div className='absolute top-4 right-4'>
<Icon icon="arrow-up-right-from-square" />
</div>
<div class="vapi-badge vapi-badge-workflow">Built with Workflows</div>
<br />
Build an appointment scheduling assistant that can schedule appointments for a barbershop
</Card>
<Card title="Medical Triage & Scheduling" icon="stethoscope" href="/workflows/examples/clinic-triage-scheduling">
<div className='absolute top-4 right-4'>
<Icon icon="arrow-up-right-from-square" />
</div>
<div class="vapi-badge vapi-badge-workflow">Built with Workflows</div>
<br />
Build a medical triage and scheduling assistant that can triage patients and schedule appointments for a clinic
</Card>
<Card title="Ecommerce Order Management" icon="shopping-cart" href="/workflows/examples/ecommerce-order-management">
<div className='absolute top-4 right-4'>
<Icon icon="arrow-up-right-from-square" />
</div>
<div class="vapi-badge vapi-badge-workflow">Built with Workflows</div>
<br />
Build an ecommerce order management assistant that can track orders and process returns
</Card>
<Card title="Lead Qualification" icon="phone" href="/workflows/examples/lead-qualification">
<div className='absolute top-4 right-4'>
<Icon icon="arrow-up-right-from-square" />
</div>
<div class="vapi-badge vapi-badge-workflow">Built with Workflows</div>
<br />
Create an outbound sales agent that can schedule appointments automatically
</Card>
</CardGroup>
8 changes: 4 additions & 4 deletions fern/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -42,9 +42,9 @@ Each layer is highly customizable and we support dozens of models across STT, LL
The easiest way to start with Vapi. Build a voice agent in 5 minutes.
</Card>
<Card
title="Web Integration"
href="/quickstart/web-integration">
Integrate voice calls into your web application.
title="Web Calls"
href="/quickstart/web">
Quickly get started making web calls with our SDKs.
</Card>
</CardGroup>

Expand All @@ -58,7 +58,7 @@ Explore end-to-end examples for some common voice workflows:
icon="phone"
iconType="solid"
color="#f5ac4c"
href="/examples/inbound-support"
href="/assistants/examples/inbound-support"
>
We'll build a customer support agent that can process inbound phone calls and assist with common banking issues.
</Card>
Expand Down
16 changes: 12 additions & 4 deletions fern/quickstart/introduction.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -121,7 +121,7 @@ Vapi offers two main primitives for building voice agents, each designed for dif
title="Customer Support"
icon="headset"
iconType="solid"
href="/examples/inbound-support"
href="/assistants/examples/inbound-support"
>
<div className='absolute top-4 right-4'>
<Icon icon="arrow-up-right-from-square" />
Expand Down Expand Up @@ -156,9 +156,6 @@ Vapi offers two main primitives for building voice agents, each designed for dif

Handle booking requests, check availability, and confirm appointments with conditional routing.
</Card>
</CardGroup>

<CardGroup cols={2}>
<Card
title="Medical Triage & Scheduling"
icon="stethoscope"
Expand All @@ -185,4 +182,15 @@ Vapi offers two main primitives for building voice agents, each designed for dif

Order tracking, returns, and customer support workflows.
</Card>
<Card
title="See more examples"
icon="book"
iconType="solid"
href="/examples"
>
<div className='absolute top-4 right-4'>
<Icon icon="arrow-up-right-from-square" />
</div>
See our collection of examples covering a wide range of use cases.
</Card>
</CardGroup>
Loading
Loading