External AI Voice Bots

This guide will go over how AI Voice agent can qualify
consumers and reroute call to TrackDrive buyers after
qualification.

External: a third-party AI service (e.g., a custom LLM-driven agent) bridges into the call as an "agent" and drives it via the API. This article covers the external case.

AI Voice Bot Call flow

In the offer click on create a new call flow > choose
Connect AI Voice bot and add in the AI Voice bot.

How an External Bot Joins a Call

The bot is registered as an external agent buyer with key
press flows enabled and a key press flow group assigned.
When the call routes to that buyer:

The system detects that only external agents are being dialed because of the call flow it's on
The dialer brings the bot leg into the conference
The bot's audio is wired to the consumer leg
Key press flows defined on the group dictate what DTMF sequences trigger which actions

Driving the Call from the Bot Side

The bot consumes TrackDrive's call APIs to influence the
live call:

Update call with td_secure_token and td_uuid: PUT /api/v1/secure/:secure_token/calls/:uuid Update a call with td_secure_token and td_uuid passed in a call's SIP headers.
Send a key press: POST to /api/v1/calls/send_key_press to inject a DTMF tone into the conference, triggering whatever the key press flow group has bound to that digit.
Schedule a callback: POST to /api/v1/scheduled_callbacks (Basic Auth with your API public key and private key) to queue a future outbound attempt.

The call UUID and secure token SIP headers (sent by
TrackDrive when bridging the bot leg) let the bot
authenticate per-call without a long-lived developer
access token.

Configuration Surface

Key press flow groups are managed at /key_press_flow_groups and can also be manipulated via /api/v1/key_press_flow_groups.
The "Use with key press flows" and "Key press flow group" settings are configured on the buyer's page
Call leg entries prefixed "External Agent" appear in call logs when the bot leg connects, which is useful for debugging routing decisions.

External AI Voice Bots