Bot-initiated calls and callbacks
Allow a bot to call a destination or schedule a callback within a controlled framework.
Two skills allow the bot to trigger a call outside the current conversation.
Both actions are initiated by the bot from an existing conversation. They do not constitute a direct call route in the public API. An external integration requesting a call uses an outbound campaign, optionally restricted to a single contact.
Immediate outbound call
The Outbound call skill allows the bot to call a predefined list of numbers. For each destination, explain when it may be used. The bot passes the reason and relevant context to the new call.
Contact callback
The Contact callback skill lets you schedule a date and time. The current number is suggested when known. An option can allow the caller to provide a different number.
Common rules
- Confirm the number and timing before scheduling.
- Pass only necessary context.
- Inform the caller of the call's purpose.
- Respect operating hours, consent, and applicable commercial rules.
- Account for carrier costs, which are separate from AI costs.
The /internal/api routes are reserved for BeAI runtimes. They are neither supported nor authenticable with a public API key.
Voicemail
The bot attempts to detect voicemail. When permitted and possible, it leaves a message after the tone and records this in the wrap-up and conversation summary.