curl -X POST "https://app.talkover.ai/api/v1/agents/agent-uuid-1/callback" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"source_agent_ids": ["agent-uuid-2", "agent-uuid-3"]
}'
{
"success": true,
"data": {
"id": "agent-uuid-1",
"name": "Callback Handler",
"direction": "inbound",
"callback_config": {
"source_agent_ids": ["agent-uuid-2", "agent-uuid-3"]
}
}
}
Callback Agents
Set Agent as Callback
Configure an inbound agent to handle callbacks from outbound source agents
POST
/
api
/
v1
/
agents
/
{agent_id}
/
callback
curl -X POST "https://app.talkover.ai/api/v1/agents/agent-uuid-1/callback" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"source_agent_ids": ["agent-uuid-2", "agent-uuid-3"]
}'
{
"success": true,
"data": {
"id": "agent-uuid-1",
"name": "Callback Handler",
"direction": "inbound",
"callback_config": {
"source_agent_ids": ["agent-uuid-2", "agent-uuid-3"]
}
}
}
Set Agent as Callback
Configure an inbound agent to handle callbacks from one or more outbound source agents. When a contact previously called by a source agent dials back, the call is routed to this agent (assuming the agent owns the dialed number).Endpoint
POST /api/v1/agents/{agent_id}/callback
Path parameters
string
required
UUID of the inbound agent. Must have
direction: "inbound".Request headers
string
required
Bearer token. Format:
Bearer talq_your_environment_token_herestring
required
Must be set to
application/jsonRequest body
array
required
Array of outbound agent UUIDs whose contacts should route to this callback agent on inbound returns. Must contain at least one entry.
Examples
curl -X POST "https://app.talkover.ai/api/v1/agents/agent-uuid-1/callback" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"source_agent_ids": ["agent-uuid-2", "agent-uuid-3"]
}'
Response
{
"success": true,
"data": {
"id": "agent-uuid-1",
"name": "Callback Handler",
"direction": "inbound",
"callback_config": {
"source_agent_ids": ["agent-uuid-2", "agent-uuid-3"]
}
}
}
Error responses
422 — Wrong Direction
{
"success": false,
"message": "Agent must have direction=inbound to serve as a callback",
"code": "INVALID_AGENT_DIRECTION"
}
Was this page helpful?