Skip to main content

​
Overview

When inbound calling is set up, anyone who calls your phone number is automatically connected to your voice agent. Voicerix uses a single org-wide webhook URL that works across all supported providers.

​
How It Works

1

Call arrives

Your telephony provider receives an incoming call on your phone number.
2

Webhook triggered

The provider sends a webhook to Voicerix’s inbound endpoint.
3

Agent resolved

Voicerix identifies your org from the webhook credentials and looks up which agent should answer based on the called number’s Inbound workflow assignment.
4

Call handled

Real-time audio streams between the caller and your voice agent over WebSocket. Your agent manages the entire conversation.

​
Voicerix Inbound Webhook URL

This single URL handles inbound calls for your entire organization. Voicerix identifies which agent to run based on the phone number that was called and its inbound workflow assignment.

​
Setup

​
Step 1: Configure Your Telephony Provider

If you haven’t already, add a telephony configuration in Voicerix under Integrations. Follow the provider-specific guide:

​
Step 2: Assign an Inbound Workflow to a Phone Number

  1. In Voicerix, go to Integrations and open your telephony 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
Voicerix will automatically push the webhook URL to your provider. You don’t need to set it manually in most cases.

​
Step 3: Verify on the Provider Side

Each provider stores the inbound webhook URL in a slightly different place. Check the provider-specific guide to confirm the URL was set correctly:

​
Step 4: Test

Call your configured phone number from another phone and verify your voice agent picks up and responds correctly.

​
Troubleshooting

  • Verify the webhook URL is correctly configured at your provider
  • Check that the webhook endpoint is publicly accessible
  • Ensure the phone number has an Inbound workflow assigned in Voicerix
  • Confirm your voice agent workflow is properly configured
  • Check webhook signature validation is working (credentials in Voicerix match those in your provider console)
  • Verify WebSocket connections are established successfully
Open the called number in Integrations and confirm an Inbound workflow is assigned. Without this assignment, Voicerix has no agent to route the call to.
Verify your account credentials in your Voicerix telephony configuration match your telephony provider settings exactly.
Add this phone number under Phone numbers in your telephony configuration in Voicerix and ensure it is also active in your provider account.
  • Verify your auth token or API key in Voicerix matches your provider
  • Ensure webhook requests are coming from your telephony provider’s servers
  • Check that your webhook URL is accessible and responding correctly
  • Check network bandwidth and latency from provider to Voicerix
  • Verify audio pipeline configuration matches provider requirements
  • Review WebSocket connection stability

​
Best Practices

  • Use the same telephony configuration for both inbound and outbound calls
  • Always test inbound calling after configuration changes
  • Monitor both Voicerix call logs and your provider’s dashboard
  • Ensure webhook signature verification is enabled for security