What you can do:
Keep the number your customers already call, and route its inbound calls to your AI agent instead of buying a new one.
Use this method when you already own numbers with a carrier or run your own telephony. If you’d rather buy and manage numbers through Twilio, see the Twilio method.
Before you start
- An existing phone number on a PBX, SIP provider, or GSM gateway.
- The ability to configure that trunk’s inbound call routing (origination) to point at an external SIP URI. Where this setting lives depends on your carrier or telephony provider.
- A Chatbase AI agent set up with the voice settings you want callers to hear. Configure voice, language, and greeting on your AI agent’s Build > Voice page.
- The Basic plan or higher.
How to connect a SIP trunk
1
Open the Phone channel
- Navigate to your Chatbase dashboard and select the AI agent you want to enable phone calls for.
- Click Channels in the sidebar and open the Phone channel.
- Go to the Connections tab. This is where you assign phone numbers to the AI agent.
2
Choose the SIP trunk method
- Under Assign phone numbers, click Assign a new number.
- In the dialog, choose SIP trunk: “Connect an existing number from your PBX, SIP provider or GSM gateway.”
- Click Continue.
If you don’t have a Twilio account connected, SIP trunk is already selected for you. The Twilio number option only becomes available once a Twilio account is connected to the AI agent.
3
Enter the number details
In the Connect SIP trunk dialog:
- Enter a Name, a friendly label to help you identify this number later, for example “Main office trunk”.
- Enter the Phone number in E.164 format, including the country code, for example
+15550000000. - Click Connect SIP trunk.
4
Copy the SIP URI
The SIP trunk created dialog shows the SIP URI Chatbase generated. Click the copy icon to copy it. It looks like this:Then click Done.
5
Point your carrier at the SIP URI
In your carrier, PBX, SIP provider, or GSM gateway configuration, route inbound calls for this number to the SIP URI you copied. This is usually configured as the trunk’s origination, outbound routing, or SIP destination for the number.The exact steps vary by provider, but in general you will:
- Open your provider’s trunk or number settings.
- Set the inbound call destination (origination URI / SIP endpoint) to the copied Chatbase SIP URI.
- Turn off any digest authentication or registration for this destination. Chatbase doesn’t use either.
- Save the configuration.
A new SIP trunk number is Active as soon as you create it. In the Connections tab it shows the phone number, Active with the toggle on, its friendly name, and a SIP trunk provider badge. Place a test call to the number and confirm your AI agent answers with the greeting from its voice settings.
How calls work
Once a SIP trunk number is connected and enabled for an AI agent:- Inbound calls to that number are routed through your carrier to Chatbase and answered by the assigned AI agent.
- The AI agent uses its configured voice settings (voice provider, model, and language) to speak with the caller.
- The AI agent greets the caller with the first message defined in its voice settings.
- The conversation follows the AI agent’s instructions, knowledge base, and Actions, just like a chat conversation.
- Each call creates a conversation entry in Activity > Conversations with the source marked as Phone.
Managing phone numbers
Copy the SIP URI again
- On the Connections tab, find the number’s card and click the menu icon (⋯).
- Select Copy SIP URI.
Enable or disable a number
Use the toggle on the number’s card. New SIP trunk numbers start turned on. A disabled number stops receiving calls but stays connected to the AI agent, so you can re-enable it at any time without reconfiguring your carrier.Delete a number
- On the number’s card, click the menu icon (⋯) and select Delete.
- Confirm in the Delete phone number? dialog.
Limitations
- Routing happens at your carrier. Chatbase generates the SIP URI, but calls only reach your AI agent once your provider is configured to send them there.
- The SIP URI must match exactly, including port, transport and the
+in the number, or calls won’t connect. - No keypad input. The AI agent isn’t set up to act on keypad presses (DTMF), so don’t rely on “press 1” style menus after the call reaches it.
- Basic plan or higher. The Phone channel isn’t available on other plans.
Troubleshooting
Calls ring but the AI agent never answers
Calls ring but the AI agent never answers
Check that:
- The number’s toggle is on.
- Your workspace is on the Basic plan or higher.
- Your workspace has more than 6 message credits left, or auto-recharge is on.
- No concurrent or daily call limit has been reached. See Limits.
Frequently asked questions
Does Chatbase need SIP credentials or registration?
Does Chatbase need SIP credentials or registration?
No. There’s no digest authentication and no registration. Calls are accepted only for numbers registered in Chatbase.
Is a new SIP number active right away?
Is a new SIP number active right away?
Yes. New SIP trunk numbers start Active. Turn off the toggle if you want to stop calls while you finish configuring your carrier.
How much does a SIP call cost in Chatbase?
How much does a SIP call cost in Chatbase?
6 message credits per minute, plus the AI model’s message credits for each reply. The first minute is billed when the call starts. Your carrier bills you separately for the line.
Next steps
Twilio
Buy and manage numbers through Twilio instead.
Transfer to phone number
Let the AI agent hand a live call to a human.