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

​
Prerequisites

  • A CallHQ account
  • A voice assistant already created under Build → Assistant
  • A phone number owned by your organization (provisioned or connected in CallHQ)
If you do not have a phone number yet, request one from the Phone Numbers section in the dashboard or see Phone Numbers for provisioning options.

​
Setup Inbound Calls

1

Open your assistant

Go to Build → Assistant and select the assistant you want to handle inbound calls.
2

Click Setup Inbound Call

In the top-left corner of the assistant page, click Setup Inbound Call.
3

Select a phone number

A list of your available phone numbers appears. Select the number you want to route inbound calls to this assistant.
4

Save

Click Save to apply the configuration. Incoming calls to that number will now be handled by the selected assistant.
Setup inbound call by selecting a phone number and saving

​
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 for the POST /phone-numbers/inbound/setup endpoint.