Inbound Calls

Configure AI agents to answer incoming phone calls.

Ultravox can power AI agents that automatically answer incoming phone calls from your users. This is perfect for customer service, support lines, or any application where users initiate contact.

How Inbound Calls Work

1. User Dials You

   User dials your phone number purchased from your telephony provider.

2. Incoming Webhook

   Provider routes the call to your configured webhook/application.

3. Create Ultravox Call

   Your server creates an Ultravox call and gets a joinUrl.

4. Connect & Answer

   Connect the call to your provider using the joinUrl. The AI agent answers and begins the conversation.

Using Template Variables

When you use Agents for creating calls, you can define template variables that get passed in a call creation time. For incoming calls, this data might come from an IVR or your own application.

Example: Template Context

// System prompt expects template variables
systemPrompt: "You are calling {{customerName}}..."

// Set templateContext at call creation time
templateContext: {
  customerName: "VIP Customer",
  accountType: "enterprise"
}

For more see Template Context →

Next Steps

• Check out the Inbound Call Quickstart
• Learn about Call Transfers to escalate calls to human agents