Documentation Index
Fetch the complete documentation index at: https://docs.cawme.com.br/llms.txt
Use this file to discover all available pages before exploring further.
GET /v1/calls/:callId
Retorna o estado atual de uma chamada, incluindo seu status e timestamps.
Requisição
Cabeçalhos
| Cabeçalho | Valor |
|---|
Authorization | Bearer <token> |
Parâmetros de caminho
| Parâmetro | Tipo | Descrição |
|---|
callId | string | O ID da chamada (ex.: call_xyz789) |
Resposta 200
| Campo | Tipo | Descrição |
|---|
id | string | ID único da chamada |
instance_id | string | Instância que realizou a chamada |
type | string | FIXED_TTS, FIXED_AUDIO, DYNAMIC_STREAM ou DYNAMIC_AGENT |
status | string | Status atual da chamada |
target_phone | string | Número de destino |
started_at | string | null | Timestamp ISO 8601 de quando a chamada conectou |
ended_at | string | null | Timestamp ISO 8601 de quando a chamada encerrou |
created_at | string | Timestamp ISO 8601 |
Status da chamada
| Status | Descrição |
|---|
QUEUED | Chamada aguardando para ser realizada |
RINGING | Chamada discando para o destinatário |
IN_PROGRESS | Destinatário atendeu |
COMPLETED | Chamada encerrada com sucesso |
FAILED | Chamada falhou ou foi encerrada |
{
"id": "call_xyz789",
"instance_id": "inst_abc123",
"type": "FIXED_TTS",
"status": "IN_PROGRESS",
"target_phone": "+14155550123",
"started_at": "2026-03-01T10:01:15Z",
"ended_at": null,
"created_at": "2026-03-01T10:01:00Z"
}
Erros
| Código | Descrição |
|---|
401 | Token ausente ou inválido |
404 | Chamada não encontrada ou não pertence ao usuário |
Exemplo
curl https://cawme.com/api/v1/calls/call_xyz789 \
-H "Authorization: Bearer <token>"
