> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voicerix.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Inbound Calling

> Configure inbound calling so your agent automatically answers incoming calls.

## 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

<Steps>
  <Step title="Call arrives">
    Your telephony provider receives an incoming call on your phone number.
  </Step>

  <Step title="Webhook triggered">
    The provider sends a webhook to Voicerix's inbound endpoint.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Call handled">
    Real-time audio streams between the caller and your voice agent over WebSocket. Your agent manages the entire conversation.
  </Step>
</Steps>

***

## Voicerix Inbound Webhook URL

```
https://client.voicerix.ai/api/v1/telephony/inbound/run
```

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:

* [Twilio](/configuration/integrations/twilio#configuration)
* [Telnyx](/configuration/integrations/telnyx#configuration)
* [Plivo](/configuration/integrations/plivo#configuration)
* [Vonage](/configuration/integrations/vonage#configuration)
* [Cloudonix](/configuration/integrations/cloudonix#configuration)
* [Vobiz](/configuration/integrations/vobiz#configuration)

### 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:

* [Twilio — verify webhook](/configuration/integrations/twilio#step-2-verify-in-twilio-console)
* [Telnyx — verify webhook](/configuration/integrations/telnyx#step-2-verify-in-telnyx-portal)
* [Plivo — verify answer URL](/configuration/integrations/plivo#step-3-verify-in-plivo-console)
* [Vonage — verify answer URL](/configuration/integrations/vonage#step-3-verify-in-vonage-dashboard)
* [Cloudonix — verify application URL](/configuration/integrations/cloudonix#step-4-verify-the-application-url)
* [Vobiz — verify answer URL](/configuration/integrations/vobiz#step-3-verify-in-vobiz-console)

### Step 4: Test

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

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Calls go to voicemail instead of the agent">
    * 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
  </Accordion>

  <Accordion title="Agent doesn't respond to incoming calls">
    * 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
  </Accordion>

  <Accordion title="Workflow not found error">
    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.
  </Accordion>

  <Accordion title="Account validation failed">
    Verify your account credentials in your Voicerix telephony configuration match your telephony provider settings exactly.
  </Accordion>

  <Accordion title="Phone number not configured">
    Add this phone number under **Phone numbers** in your telephony configuration in Voicerix and ensure it is also active in your provider account.
  </Accordion>

  <Accordion title="Signature validation failed">
    * 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
  </Accordion>

  <Accordion title="Poor audio quality on inbound calls">
    * Check network bandwidth and latency from provider to Voicerix
    * Verify audio pipeline configuration matches provider requirements
    * Review WebSocket connection stability
  </Accordion>
</AccordionGroup>

## 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