Webhook pós-chamada (chamado pelo provedor de voz)

Endpoint que a provedor de voz chama ao fim de cada conversa (webhook pós-chamada). Não é chamado pelo cliente: serve para configurar o webhook no provedor de voz.

Ao receber post_call_transcription de um agente da allowlist, com o UUID do ticket na dynamic variable configurada (dk_ticket_id por padrão):

abre no ticket um protocolo de Telefonia (receptivo ou ativo conforme a direção, telefone normalizado com 55, duração e transcrição da própria provedor de voz);

se attach_recording, anexa o áudio da ligação (aparece no ticket em alguns minutos);

se create_summary_note, grava a nota interna [Voz IA] Resumo pós-ligação.

Conversa só de texto (sem áudio nem telefone) grava apenas a nota.

Autenticação

Não usa api-key. A autenticação é o header provedor de voz-Signature: t=<epoch>,v0=<hex>, onde v0 é o HMAC-SHA256 de <t>.<corpo cru> com o webhook_secret do tenant. Assinatura inválida ou t com mais de 30 min → 401.

Configure o webhook sem áudio. O evento post_call_audio (base64) passa do limite de 10 MB e é recusado com 413. A gravação é buscada depois pela API do provedor de voz.

Respostas

Condições permanentes respondem 200 (o provedor de voz desativa o webhook depois de 10 falhas seguidas). 409/500 são retentáveis: o provedor de voz reenvia e o reenvio não duplica protocolo, áudio nem nota.

`status`	HTTP	Significado
`delivered`	200	Protocolo/áudio/nota registrados
`duplicate`	200	Conversa já processada (reenvio)
`ignored_type`	200	Evento diferente de `post_call_transcription`
`ignored_agent`	200	Agente fora da allowlist
`no_ticket`	200	Sem a variável do ticket, valor que não é UUID, ou ticket inexistente
`rejected`	200	A conversa já está vinculada a outro ticket
`integration_inactive`	200	Integração inexistente, desativada ou sem `webhook_secret`
`processing`	409	Mesma conversa em processamento agora — reenviar
`retry`	500	Falha transitória — reenviar

Acompanhar a gravação

Use GET /api/v3/telephony/recording/{call_id} com call_id = conversation_id do provedor de voz.

Disponível a partir de 30/09/2026.

curl --location '/api/v3/integrations/voice-ai/elevenlabs/post-call' \ --header 'provedor de voz-Signature: t=1790800000,v0=5f2b…' \ --header 'Content-Type: application/json' \ --data '{ "type": "post_call_transcription", "data": { "agent_id": "agent_9101m3s5y0d1eh79z0cayqtpx8b0", "conversation_id": "conv_0123456789abcdef", "status": "done", "conversation_initiation_client_data": { "dynamic_variables": { "dk_ticket_id": "f747e599-b2d4-4691-b211-ae7b7a7f6574" } }, "metadata": { "call_duration_secs": 42, "start_time_unix_secs": 1790800000, "phone_call": { "direction": "inbound", "external_number": "11974628518", "agent_number": "551130000000" } }, "transcript": [ { "role": "agent", "message": "Olá, em que posso ajudar?" }, { "role": "user", "message": "Preciso de uma peça." } ], "analysis": { "transcript_summary": "Cliente pediu orçamento de peça.", "data_collection_results": { "modelo": { "value": "PC200" } }, "evaluation_criteria_results": { "resolveu": { "result": "success" } } } } }'

Webhook pós-chamada (chamado pelo provedor de voz)

Autenticação#

Respostas#

Acompanhar a gravação#

Requisição

Respostas

Autenticação

Respostas

Acompanhar a gravação