Voice AI: FusionPBX Integration Guide

This guide documents the integration between FusionPBX and Talkative Voice AI. Inbound PSTN calls arrive on FusionPBX via a Twilio SIP trunk, are routed to the Talkative Voice AI bot via a second Talkative-provisioned SIP trunk, and are then transferred back to FusionPBX via SIP REFER based on the bot's outcome.

The full call flow is:

This guide assumes the following are already in place:

Talkative provisions a SIP trunk per company via their Twilio infrastructure. Credentials are obtained from the Engage portal.

Navigate to https://eu.engage.app/voice-routes and edit your Voice Route. The form will display your SIP trunk credentials:

Go to Accounts → Gateways → Add and complete the form with your Talkative trunk credentials:

Save the gateway.

FusionPBX's destination form requires a real extension as its action target. Create a Virtual extension that acts as a routing placeholder for the bot — it never registers but allows the destination to save and route correctly.

Go to Accounts → Extensions → Add:

The dialplan bridges calls destined for extension 50001 out through the Talkative gateway. This must be added via the FusionPBX dialplan manager using the advanced edit view.

Go to Dialplan → Dialplan Manager → Add. Enter a name (e.g. talkative-vai) and save with minimal data. The list will show the new entry — click it to open the full edit view.

In the full edit view, configure the following:

In the conditions/actions table at the bottom, set up the rows:

The complete configuration will look something like this:

After saving, reload the dialplan:

The inbound DID destination needs to route calls to extension 50001, which triggers the talkative-vai dialplan and bridges to the bot.

Go to Destinations → edit your DID destination. Change the Action to extension 50001 (it will now appear in the dropdown since you created the Virtual extension in Step 3). Save the destination.

Call the DID from a mobile phone. Monitor the FreeSWITCH log to confirm the call is matching the dialplan and attempting to bridge to the Talkative gateway:

You should see the dialplan matching talkative-vai and a bridge attempt to the Talkative gateway. If the bridge succeeds, the Talkative bot should answer.

In Talkative Engage → Voice Routes, edit the relevant Voice Route and set the SIP endpoint to match the extension number and domain of your FusionPBX:

This tells the Talkative bot to accept calls arriving at this SIP address and associate them with the configured Voice AI bot.

When the Voice AI bot has finished processing a call, it sends a SIP REFER back to FusionPBX with a Refer-To header indicating the target extension. FusionPBX then routes the call to the appropriate destination.

In the Talkative bot's transfer tool configuration, the REFER target should be a full SIP URI pointing at a FusionPBX extension, queue, or ring group:

These destination can be configured from within the bot itself - simply specify the return destination, as a fully formed SIP address and the bot will be able to use this as a transfer destination.

Create extensions or queues in FusionPBX to receive the returned calls. The REFER targets must exist as valid dialplan destinations. Ensure the Talkative gateway's source IP is whitelisted in your FusionPBX providers ACL so that the REFER is accepted without a 407 challenge.