curl "https://app.talkover.ai/api/v1/agents/agent-uuid/active-call/%2B15551234567" \
-H "Authorization: Bearer talq_your_environment_token_here"
{
"success": true,
"data": [
{
"id": "call-uuid-1",
"agent_id": "agent-uuid",
"to": "+5511987654321",
"status": "answered",
"started_at": "2024-01-15T11:00:00Z",
"duration_seconds": 42
}
]
}
Fazer Chamada
Obter Chamada Ativa por Telefone
Encontrar a chamada ativa entre um agente e um número de telefone
GET
/
api
/
v1
/
agents
/
{agent_id}
/
active-call
/
{phone}
curl "https://app.talkover.ai/api/v1/agents/agent-uuid/active-call/%2B15551234567" \
-H "Authorization: Bearer talq_your_environment_token_here"
{
"success": true,
"data": [
{
"id": "call-uuid-1",
"agent_id": "agent-uuid",
"to": "+5511987654321",
"status": "answered",
"started_at": "2024-01-15T11:00:00Z",
"duration_seconds": 42
}
]
}
Obter Chamada Ativa por Telefone
Encontra a chamada ativa (se houver) entre um agente e um número de telefone específico. Útil para verificações de deduplicação antes de realizar uma nova chamada, ou para localizar o ID da chamada associado a um chamador de entrada.Endpoint
GET /api/v1/agents/{agent_id}/active-call/{phone}
Parâmetros de caminho
string
obrigatório
UUID do agente.
string
obrigatório
Número de telefone no formato E.164 (ex:
+5511987654321). Codifique em URL o sinal + como %2B.Cabeçalhos da requisição
string
obrigatório
Token Bearer. Formato:
Bearer talq_your_environment_token_hereExemplos
curl "https://app.talkover.ai/api/v1/agents/agent-uuid/active-call/%2B15551234567" \
-H "Authorization: Bearer talq_your_environment_token_here"
Resposta
Chamada Ativa Encontrada
{
"success": true,
"data": [
{
"id": "call-uuid-1",
"agent_id": "agent-uuid",
"to": "+5511987654321",
"status": "answered",
"started_at": "2024-01-15T11:00:00Z",
"duration_seconds": 42
}
]
}
Nenhuma Chamada Ativa
Retorna404 Not Found.
{
"success": false,
"message": "No active call found for this phone number"
}
Observações
- Apenas chamadas com status
initiated,ringingouansweredsão consideradas ativas. - Se múltiplas chamadas ativas existirem (raro — tipicamente apenas uma), todas são retornadas no array.
- Para buscas históricas, use Listar Chamadas com filtro
to.
Esta página foi útil?