Outbound Calls
Initiating outbound calls from your AI agents
How Outbound Calls Work
Outbound calling lets your agency or automation start a live phone call from an agent to a contact. This is useful for reminders, follow-ups, lead outreach, and reactivation campaigns.
Common Launch Flow
From the admin side
- Open the client.
- Go to the outbound calling area.
- Choose the phone agent that should place the call.
- Enter the target number in E.164 format.
- Add any helpful context variables.
- Start the call.
By API or workflow
Use the outbound call endpoint when another system should trigger the call for you. This is the better path for reminders, campaign follow-ups, or automated reactivation plays.
POST /admin/clients/{clientId}/outbound-call
{
"agentId": "sales-agent",
"targetPhone": "+155501234",
"dynamicVars": {
"full_name": "Sarah Chen",
"reason": "Follow up on consultation request"
}
}
Required Setup
Before an outbound call will work, confirm:
- the client is active
- the phone agent is enabled
- outbound calling is enabled for that agent
- the destination phone number is valid
- the agent has room under its concurrency limit
Choosing the Right Agent
If you do not pass an agentId, the system usually falls back to the client's
primary phone agent. If you do pass one, make sure it is the correct live agent
for that campaign and that outbound is turned on.
Why Dynamic Variables Matter
Dynamic variables give the agent context before the person even says hello. Good examples include:
- the contact's full name
- why you are calling
- the appointment or case reference
- a short internal note
- the offer or campaign name
This helps the call sound prepared instead of generic.
Standard Outbound Flow
- The platform starts the call through Twilio.
- Twilio dials the contact.
- When the contact answers, the live session begins.
- The agent speaks using its prompt plus the dynamic variables you passed in.
- The agent uses tools if the workflow allows it.
- Post-call processing runs after the conversation ends.
Inbound and Outbound Are Different
| Area | Inbound | Outbound |
|---|---|---|
| Who starts the call | The customer | Your team, workflow, or API |
| First context source | Caller phone number and CRM lookup | Dynamic variables and campaign context |
| Main operator risk | Bad routing or weak handoff | Weak targeting or poor pre-call context |
| Post-call processing | Yes | Yes |
Good Outbound Use Cases
- appointment reminders
- missed lead follow-up
- estimate or consultation follow-up
- win-back campaigns
- schedule changes that need a live explanation
Operator Advice
Outbound quality depends heavily on targeting and context. If results are weak, do not only tune the prompt. Also check whether the right list, right agent, and right call reason were sent into the session.
