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

# Setup Inbound Agent

> Configure a voice AI assistant to handle incoming calls on your phone number.

Route inbound calls to a CallHQ voice AI assistant so callers are greeted and handled by your agent automatically.

## Prerequisites

* A [CallHQ account](https://web.callhq.ai)
* A voice assistant already created under **Build → Assistant**
* A phone number owned by your organization (provisioned or connected in CallHQ)

<Note>
  If you do not have a phone number yet, request one from the **Phone Numbers** section in the dashboard or see [Phone Numbers](/phone/phone-numbers) for provisioning options.
</Note>

***

## Setup Inbound Calls

<Steps>
  <Step title="Open your assistant">
    Go to **Build → Assistant** and select the assistant you want to handle inbound calls.
  </Step>

  <Step title="Click Setup Inbound Call">
    In the top-left corner of the assistant page, click **Setup Inbound Call**.
  </Step>

  <Step title="Select a phone number">
    A list of your available phone numbers appears. Select the number you want to route inbound calls to this assistant.
  </Step>

  <Step title="Save">
    Click **Save** to apply the configuration. Incoming calls to that number will now be handled by the selected assistant.
  </Step>
</Steps>

<Frame caption="Setup inbound call from the assistant page">
  <img src="https://mintcdn.com/callhq/y_ADa9m5wh05NW8J/images/phone-inbound.gif?s=989884d1b0b2ae684eeaf604ce7b537b" alt="Setup inbound call by selecting a phone number and saving" width="1258" height="720" data-path="images/phone-inbound.gif" />
</Frame>

***

## What Happens Next

Once saved, any call placed to the selected phone number is routed to your assistant. The agent answers using the voice, prompt, and tools configured for that assistant.

Test the setup by calling the number from another phone and confirming the assistant responds as expected.

***

## Programmatic Setup

You can also configure inbound routing via the API. See [Setup Inbound Agent](/api-reference/phone/setup-inbound-agent) for the `POST /phone-numbers/inbound/setup` endpoint.

## Related

* [Phone Numbers](/phone/phone-numbers) — Test numbers, bring your own number, and telephony integrations
* [Test Your Assistant](/assistant/testing) — Validate assistant behavior before going live