Ligações
Ler uma ligação
Devolve uma ligação do alcance do chamador: quem falou com quem, como terminou, o job que a originou e o desfecho comercial resumido. Endereçada só pelo id da ligação — o id do job responde em /call-jobs/{job_id}. Fora do alcance responde 404, igual a uma que não existe.
Autorização
bearer calls:readAutorizaçãoBearer <token>
Credencial da v3: o JWT da sessão (o mesmo da v2) ou um token pessoal dom_pat_…. A lista de escopos de cada operação diz o que ela exige: uma capacidade (agents:read), authenticated ou session-only. Segredo de máquina (X-Agent-Secret, X-API-Token, sdk_…) não é aceito.
Em: header
Escopo: calls:read
Parâmetros de caminho
call_id*string
Id da ligação
Corpo da resposta
application/json
application/json
curl -X GET "https://example.com/calls/string"{ "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978", "answered_at": "string", "contact_name": "string", "contact_phone": "string", "conversation_id": "cc71b11a-25cd-4c2d-9950-df2cc38e3407", "created_at": "string", "direction": "outbound", "duration_ms": 0, "ended_at": "string", "error": null, "from_number": "string", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "job": null, "message_count": 0, "provider": "string", "result_summary": null, "started_at": "string", "status": "pending", "studio": true, "tenant_id": 0, "to_number": "string", "updated_at": "string"}