Inbound Calling

Overview#

Lemu 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. The inbound calling configuration in Lemu AI uses the same telephony settings as outbound calling.

Supported Providers for Inbound Calls#

How Inbound Calling Works#

When someone calls your configured phone number:

1. Call Received: The telephony provider receives the incoming call
2. Webhook Triggered: The provider sends a webhook to Lemu AI
3. Agent Activated: Lemu AI activates your configured voice agent workflow
4. Audio Streaming: Real-time audio streams between caller and agent via WebSocket
5. Conversation Handled: Your voice agent manages the entire conversation

Configuration in Lemu AI#

Setting up inbound calling requires three simple steps:

Step 1: Configure Telephony Provider#

The telephony configuration for inbound calling is identical to outbound calling. Follow the Configuration section in your provider's documentation page:

• Twilio Configuration
• Cloudonix Configuration
• Vobiz Configuration
• Asterisk ARI Configuration

Step 2: Get Your Workflow Webhook URL#

1. Find Your Workflow ID:

   • Navigate to your workflow page (e.g., https://app.lemuai.com/workflow/3)
   • Note the workflow ID from the URL (in this example: 3)

2. Construct Webhook URL:

   https://app.lemuai.com/api/v1/telephony/inbound/{workflow_id}
   

   For example, if your workflow ID is 3:

   https://app.lemuai.com/api/v1/telephony/inbound/3
   

Step 3: Configure Provider-Specific Inbound Settings#

Each telephony provider requires additional configuration to route incoming calls to your Lemu AI webhook. Follow the provider-specific inbound setup instructions:

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

Testing Inbound Calls#

After completing both the Lemu 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 Lemu 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 Lemu AI logs and provider dashboards for call analytics
• Backup Numbers: Configure multiple phone numbers for redundancy
• 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 (to be detailed)
3. Test your inbound calling setup
4. Configure your voice agent workflow for optimal caller experience