Skip to main content
GET

Obter resultado da chamada

Retorna o que o agente capturou em uma conversa: se uma pessoa atendeu, o resultado, os dados que o agente foi configurado para coletar, um resumo e a transcrição completa. É a mesma informação que o webhook event_call_report entrega, disponível por consulta. Use para reconciliar uma chamada sem depender do webhook, ou para ler o resumo e a transcrição, que não entram em Listar chamadas por causa do tamanho.

Endpoint

Parâmetros de path

string
obrigatório
O id da chamada, como devolvido por Listar chamadas ou Fazer chamada.

Cabeçalhos da requisição

string
obrigatório
Token Bearer. Formato: Bearer talq_seu_token_de_ambiente

Exemplo de requisição

Resposta

Resposta de sucesso (200 OK)

Campos da resposta

boolean
obrigatório
Se a requisição foi bem-sucedida.
object
obrigatório
human_detected, objective_achieved, call_result, collected_data e summary são null sempre que analysis_status não for completed. Um false nesses campos é resultado real da análise, nunca ausência dela.

Como ler analysis_status

A análise roda depois que a chamada termina, normalmente em menos de um minuto. Uma chamada consultada logo após o fim ainda não tem resultado. Uma chamada nunca volta de unavailable para completed. Quando vir unavailable, pare de consultar. Chamadas voicemail seguem o fluxo normal (pending, depois completed ou unavailable), porque o agente pode ter falado antes de a caixa postal ser detectada.

Respostas de erro

404 Não encontrado

A chamada não existe ou pertence a outro ambiente.

401 Não autorizado

Notas

duration: null em chamadas voicemail, no-answer, failed e busy significa que não houve tempo de conversa medido. Não é zero.
Reconciliação em lote. Para reconciliar um dia, use Listar chamadas com include=insight, pelo menos 30 minutos depois do fim da última chamada. O pending desaparece e você faz uma requisição por página em vez de uma por chamada.
Fora de propósito. O SID do provedor, flags internos de roteamento e os demais campos da análise (sentimento, objeções, conclusão do script) não fazem parte desta resposta.

Endpoints relacionados

  • Listar chamadas: GET /api/v1/calls?include=insight — o mesmo bloco, sem summary e transcript, para uma página inteira de chamadas.
  • Obter chamadas do agente: GET /api/v1/agents/{agent_id}/calls?include=insight
  • Obter URL da gravação: GET /api/v1/calls/{call_id}/recording-url