Inbound Calling

Overview

Talkr AI supports inbound calling across all supported telephony providers. When someone calls your configured phone number, your voice agent automatically answers and handles the interaction. Inbound and outbound calls share the same telephony configuration.

Supported Providers for Inbound Calls

How Inbound Calling Works

Talkr exposes a single inbound webhook URL for the whole org:

https://talkr.intelstacks.com/api/v1/telephony/inbound/run

When a call arrives:

1. Call Received: Your telephony provider receives the incoming call
2. Webhook Triggered: The provider sends a webhook to /inbound/run
3. Org & Agent Resolved: Talkr identifies the org from the webhook's account credentials, then looks up which agent should answer based on the called number's Inbound workflow assignment in your telephony configuration
4. Audio Streaming: Real-time audio streams between caller and agent via WebSocket
5. Conversation Handled: Your voice agent manages the entire conversation

You don't construct per-workflow URLs anymore — the routing is done by the called number's inbound workflow assignment in Talkr.

Configuration in Talkr AI

Setting up inbound calling takes three steps:

Step 1: Configure Telephony Provider

The telephony configuration for inbound calling is identical to outbound calling. Add (or open) a configuration at /telephony-configurations following your provider's documentation:

• Twilio Configuration
• Vonage Configuration
• Plivo Configuration
• Telnyx Configuration
• Cloudonix Configuration
• Vobiz Configuration
• Asterisk ARI Configuration

Step 2: Assign an Inbound Workflow to the Phone Number

1. Go to /telephony-configurations and open your configuration
2. In the Phone numbers section, edit the number that should receive inbound calls
3. Set its Inbound workflow to the agent that should answer
4. Save

This is what tells Talkr which agent to run when a call comes in for that number.

Step 3: Point Your Provider at /inbound/run

Each provider needs its inbound webhook (Twilio Voice URL / Vonage Answer URL / etc.) set to the global Talkr endpoint:

https://talkr.intelstacks.com/api/v1/telephony/inbound/run

The exact place to set this varies by provider — follow the provider-specific instructions:

• Twilio Inbound Setup
• Vonage Inbound Setup
• Plivo Inbound Setup
• Telnyx Inbound Setup
• Cloudonix Inbound Setup
• Vobiz Inbound Setup
• Asterisk ARI Inbound Setup

Testing Inbound Calls

After completing both the Talkr AI configuration and provider-specific setup:

1. Test Call: Call your configured phone number from another phone
2. Verify Connection: Ensure your voice agent answers and responds appropriately
3. Check Logs: Monitor call logs in both Talkr AI and your provider's dashboard
4. Audio Quality: Verify clear two-way audio communication

Troubleshooting Common Issues

Best Practices

• Single Configuration: Use the same telephony configuration for both inbound and outbound calls
• Testing: Always test inbound calling after configuration changes
• Monitoring: Monitor both Talkr AI logs and provider dashboards for call analytics
• Security: Ensure webhook signature verification is enabled for security

Next Steps

1. Choose your telephony provider and complete the basic configuration
2. Follow the provider-specific setup instructions
3. Assign an inbound workflow to each phone number that should accept calls
4. Test your inbound calling setup