diff --git a/fern/debugging.mdx b/fern/debugging.mdx
index 2adce35a..4df5e0b6 100644
--- a/fern/debugging.mdx
+++ b/fern/debugging.mdx
@@ -8,12 +8,20 @@ slug: debugging
Voice agents involve multiple AI systems working together—speech recognition, language models, and voice synthesis. When something goes wrong, systematic debugging helps you quickly identify and fix the root cause.
-**Common debugging scenarios:**
-- Agent doesn't understand user input correctly
-- Responses are inappropriate or inconsistent
-- Call quality issues or audio problems
-- Tool integrations failing or returning errors
-- Workflow logic not executing as expected
+**Most common issues fall into these categories:**
+
+
+
+ * Agent doesn't understand user input correctly
+ * Responses are inappropriate or inconsistent
+ * Agent sounds robotic or unnatural
+
+
+ * Call quality issues or audio problems
+ * Tool integrations failing or returning errors
+ * Workflow logic not executing as expected
+
+
## Quick diagnostics
@@ -23,31 +31,59 @@ Start with these immediate checks before diving deeper:
Test your voice agent directly in the [dashboard](https://dashboard.vapi.ai/):
- - **Assistants**: `Dashboard > Assistants > [Select Assistant] > Talk to Assistant`
- - **Workflows**: `Dashboard > Workflows > [Select Workflow] > Call`
+
+
+ Click "Talk to Assistant" to test
+
+
+ Click "Call" to test workflow
+
+
+
+ **Benefits:**
- Eliminates phone network variables
- - Provides real-time transcript view
+ - Provides real-time transcript view
- Shows tool execution results immediately
Navigate to the `Observe` section in your [dashboard](https://dashboard.vapi.ai/) sidebar:
- - **Call Logs**: Review call transcripts, durations, and error messages
- - **API Logs**: Check API requests and responses for integration issues
- - **Webhook Logs**: Verify webhook deliveries and server responses
+
+
+ Review call transcripts, durations, and error messages
+
+
+ Check API requests and responses for integration issues
+
+
+ Verify webhook deliveries and server responses
+
+
Use [dashboard](https://dashboard.vapi.ai/) testing features:
- - **Voice Test Suites**: `Test > Voice Test Suites` (assistants only)
- - **Tool Testing**: `Tools > [Select Tool] > Test` with sample payloads
+
+
+ Automated testing for assistants
+
+
+ Test tools with sample data
+
+
Check if AI service providers are experiencing issues:
- - Visit [Vapi Status Page](https://status.vapi.ai/) for real-time provider status
- - Review speech-to-text, language model, and voice synthesis availability
- - Check for ongoing maintenance or outages
+ **Core Services:**
+ - Visit [Vapi Status Page](https://status.vapi.ai/) for Vapi service status
+
+ **Provider Status Pages:**
+ - [OpenAI Status](https://status.openai.com/) for OpenAI language models
+ - [Anthropic Status](https://status.anthropic.com/) for Anthropic language models
+ - [ElevenLabs Status](https://status.elevenlabs.io/) for ElevenLabs voice synthesis
+ - [Deepgram Status](https://status.deepgram.com/) for Deepgram speech-to-text
+ - And other providers' status pages as needed
@@ -64,6 +100,8 @@ Navigate to `Observe > Call Logs` to:
- See tool execution results and errors
- Analyze conversation flow in workflows
+
+
### API Logs
Navigate to `Observe > API Logs` to:
@@ -72,6 +110,8 @@ Navigate to `Observe > API Logs` to:
- Verify request payloads and response codes
- Debug integration issues with external services
+
+
### Webhook Logs
Navigate to `Observe > Webhook Logs` to:
@@ -80,6 +120,8 @@ Navigate to `Observe > Webhook Logs` to:
- Debug webhook authentication issues
- Monitor event delivery failures
+
+
### Voice Test Suites
Navigate to `Test > Voice Test Suites` to:
@@ -88,6 +130,8 @@ Navigate to `Test > Voice Test Suites` to:
- Verify assistant behavior across different inputs
- Monitor performance over time
+
+
### Tool Testing
For any tool in your `Tools` section:
@@ -96,6 +140,8 @@ For any tool in your `Tools` section:
- Verify tool responses and error handling
- Debug parameter extraction and API calls
+
+
## Speech and language issues
| Problem | Symptoms | Solution |
@@ -138,7 +184,7 @@ For any tool in your `Tools` section:
| Error Pattern | Likely Cause | Quick Fix |
|---------------|--------------|-----------|
-| **"I didn't understand"** | Speech recognition issue | Check transcriber model, add custom keyterms |
+| **Agent misinterpreting speech** | Speech recognition issue | Check transcriber model, add custom keyterms |
| **Irrelevant responses** | Poor prompt engineering | Be more specific in system prompt |
| **Call drops immediately** | Configuration error | Check all required fields in assistant/workflow settings |
| **Tool errors** | API integration issue | Test tools individually, verify endpoint URLs |
@@ -153,6 +199,9 @@ When you're stuck:
icon="user-group"
href="https://discord.com/invite/pUFNcf2WmH"
>
+
+
+
Join the Vapi Discord for real-time help from the community and team
@@ -161,6 +210,9 @@ When you're stuck:
icon="book"
href="/api-reference"
>
+
+
+
Check the API reference for detailed configuration options
@@ -169,6 +221,9 @@ When you're stuck:
icon="fa-light fa-heartbeat"
href="https://status.vapi.ai/"
>
+
+
+
Check real-time status of Vapi services and AI providers
diff --git a/fern/quickstart/introduction.mdx b/fern/quickstart/introduction.mdx
index 94ade849..543763c4 100644
--- a/fern/quickstart/introduction.mdx
+++ b/fern/quickstart/introduction.mdx
@@ -43,14 +43,15 @@ Vapi offers two main primitives for building voice agents, each designed for dif
iconType="solid"
href="/assistants/dynamic-variables"
>
- **Best for:** Quick kickstart and straightforward conversations
-
+
+
+
+ **Best for:** Quick kickstart for simple conversations
+
Assistants use a single system prompt to control behavior. Perfect for:
- Customer support chatbots
- Simple question-answering agents
- Getting started quickly with minimal setup
-
- *Control everything from one place with natural language instructions.*
+
+
+
**Best for:** Complex logic and multi-step processes
-
+
Workflows use visual decision trees and conditional logic. Perfect for:
- Appointment scheduling with availability checks
- Lead qualification with branching questions
- - Complex customer service flows with escalation paths
-
- *Build sophisticated branching logic without code.*
+ - Complex customer service flows with escalation
@@ -86,8 +88,10 @@ Vapi offers two main primitives for building voice agents, each designed for dif
iconType="solid"
href="/quickstart/phone"
>
- **Start here if you want to:**
- - Create a voice agent that can make and receive phone calls
+
+
+
+ - Create a voice agent for inbound/outbound calls
- Build customer support or sales automation
- Get started with no coding required
@@ -99,7 +103,9 @@ Vapi offers two main primitives for building voice agents, each designed for dif
iconType="solid"
href="/quickstart/web"
>
- **Start here if you want to:**
+
+
+
- Add voice capabilities to your web application
- Integrate voice chat into your existing product
- Build with code and SDKs
@@ -117,11 +123,12 @@ Vapi offers two main primitives for building voice agents, each designed for dif
iconType="solid"
href="/examples/inbound-support"
>
+
+
+
Built with Assistants
Automate inbound support calls with agents that can access your knowledge base and escalate to humans when needed.
-
- *View example →*
+
+
+
Built with Workflows
Make outbound sales calls, qualify leads, and schedule appointments with sophisticated branching logic.
-
- *View example →*
+
+
+
Built with Workflows
Handle booking requests, check availability, and confirm appointments with conditional routing.
-
- *View example →*
@@ -156,6 +165,9 @@ Vapi offers two main primitives for building voice agents, each designed for dif
iconType="solid"
href="/workflows/examples/clinic-triage-scheduling"
>
+
+
+
Built with Workflows
Emergency routing and appointment scheduling for healthcare.
@@ -166,21 +178,11 @@ Vapi offers two main primitives for building voice agents, each designed for dif
iconType="solid"
href="/workflows/examples/ecommerce-order-management"
>
+
+
+
Built with Workflows
Order tracking, returns, and customer support workflows.
-
-## Ready to get started?
-
-Most users start with **phone calls** since it's the easiest way to see Vapi in action. You can create and test a working voice agent in under 5 minutes without writing any code.
-
-
- Create your first voice agent and make your first call
-
diff --git a/fern/static/videos/debugging/api-logs.mp4 b/fern/static/videos/debugging/api-logs.mp4
new file mode 100644
index 00000000..4a8c7ffc
Binary files /dev/null and b/fern/static/videos/debugging/api-logs.mp4 differ
diff --git a/fern/static/videos/debugging/call-logs.mp4 b/fern/static/videos/debugging/call-logs.mp4
new file mode 100644
index 00000000..1c583909
Binary files /dev/null and b/fern/static/videos/debugging/call-logs.mp4 differ
diff --git a/fern/static/videos/debugging/tool-testing.mp4 b/fern/static/videos/debugging/tool-testing.mp4
new file mode 100644
index 00000000..0974217c
Binary files /dev/null and b/fern/static/videos/debugging/tool-testing.mp4 differ
diff --git a/fern/static/videos/debugging/voice-test-suites.mp4 b/fern/static/videos/debugging/voice-test-suites.mp4
new file mode 100644
index 00000000..c06e75a9
Binary files /dev/null and b/fern/static/videos/debugging/voice-test-suites.mp4 differ
diff --git a/fern/static/videos/debugging/webhook-logs.mp4 b/fern/static/videos/debugging/webhook-logs.mp4
new file mode 100644
index 00000000..08ab91b9
Binary files /dev/null and b/fern/static/videos/debugging/webhook-logs.mp4 differ