Skip to main content
Um evento de conclusão é disparado após o término de cada chamada — telefonia de entrada, telefonia de saída, chamada web ou chamada de teste (sessão de microfone do builder). Ele é não bloqueante: responda com qualquer 2xx. O evento é entregue em ambos os caminhos:

Payload da solicitação (entregas de endpoint)

Motivos de término

Formato da transcrição

Cada entrada em transcripts é um turno de conversa. As funções são user (fala de quem liga), model (fala do agente e chamadas de ferramenta), tool (resultados de ferramentas) e system (eventos da chamada, como trocas de idioma).
Para o histórico de turnos totalmente estruturado (com marcadores de interrupção, prompts de confirmação e posições brutas), use GET /v1/calls/{call_id}/history.

Diferenças do payload legado

O envelope do webhook legado de URL única é {"type": "telephony.complete" | "web.complete", "data": {…}}, sem event_id, e seus data diferem do payload do endpoint:
  • O array de turnos fica em history, não em transcripts (com o mesmo schema de turno mostrado acima).
  • O conjunto de campos é o relatório bruto de fim de chamada e pode incluir campos internos adicionais além da tabela acima — trate campos desconhecidos como informativos.
  • Chamadas web (direction: "web") omitem from_number / to_number e adicionam origin_domain.
  • Chamadas de teste de microfone no Builder são reportadas como telephony.complete no caminho legado (o sistema de endpoints as mapeia para web.complete).
  • Coordenação de transferência: quando uma chamada termina em uma transferência, o webhook legado é chamado de forma síncrona e pode responder {"transfer_ready": false} para sinalizar que o destino da transferência não está pronto. Qualquer outra resposta (ou a ausência de webhook legado) permite que a transferência prossiga. As entregas ao endpoint nunca são consultadas para isso.

Exemplo de manipulador


Casos de uso comuns

Integração com CRM

Armazene a transcrição e a URL da gravação de cada chamada junto aos registros dos seus clientes.

Análises

Envie transcrições para um pipeline de modelagem de tópicos, extração de sinais de CSAT ou monitoramento da taxa de transferências.

Revisão de qualidade

Abra chamadas em uma ferramenta de QA para revisão humana ou processe-as com seu próprio modelo de avaliação.

Notificações

Acione um colega humano em caso de transferência ou falha.

Relacionados

telephony.incoming / web.incoming

A contraparte bloqueante executada no início da chamada.

Catálogo de eventos

Outros tipos de evento que você pode assinar.

API de histórico de chamadas

Os mesmos dados acessíveis via REST para preenchimento retroativo ou reprodução.