curl "https://app.talkover.ai/api/v1/callback-agents/agent-uuid-1" \
-H "Authorization: Bearer talq_your_environment_token_here"
{
"success": true,
"data": {
"agent": {
"id": "agent-uuid-1",
"name": "Callback Handler",
"direction": "inbound",
"current_status": "published"
},
"source_agents": [
{ "id": "agent-uuid-2", "name": "Sales Outbound" },
{ "id": "agent-uuid-3", "name": "Survey Outbound" }
],
"stats": {
"total_callbacks_received": 184,
"callbacks_answered": 142
}
}
}
Callback Agents
Get Callback Agent
Retrieve callback configuration and stats for a specific agent
GET
/
api
/
v1
/
callback-agents
/
{agent_id}
curl "https://app.talkover.ai/api/v1/callback-agents/agent-uuid-1" \
-H "Authorization: Bearer talq_your_environment_token_here"
{
"success": true,
"data": {
"agent": {
"id": "agent-uuid-1",
"name": "Callback Handler",
"direction": "inbound",
"current_status": "published"
},
"source_agents": [
{ "id": "agent-uuid-2", "name": "Sales Outbound" },
{ "id": "agent-uuid-3", "name": "Survey Outbound" }
],
"stats": {
"total_callbacks_received": 184,
"callbacks_answered": 142
}
}
}
Get Callback Agent
Retrieve detailed callback configuration for a single agent, including its source agents and recent callback activity.Endpoint
GET /api/v1/callback-agents/{agent_id}
Path parameters
string
required
UUID of the callback agent.
Request headers
string
required
Bearer token. Format:
Bearer talq_your_environment_token_hereExamples
curl "https://app.talkover.ai/api/v1/callback-agents/agent-uuid-1" \
-H "Authorization: Bearer talq_your_environment_token_here"
Response
{
"success": true,
"data": {
"agent": {
"id": "agent-uuid-1",
"name": "Callback Handler",
"direction": "inbound",
"current_status": "published"
},
"source_agents": [
{ "id": "agent-uuid-2", "name": "Sales Outbound" },
{ "id": "agent-uuid-3", "name": "Survey Outbound" }
],
"stats": {
"total_callbacks_received": 184,
"callbacks_answered": 142
}
}
}
Error responses
404 — Not a Callback Agent
{
"success": false,
"message": "Agent is not configured as a callback agent"
}
Notes
- To configure an agent as a callback, use Set Agent as Callback.
Was this page helpful?