Pular para o conteúdo principal
Ações

Enviar os dados da chamada para o seu sistema

Depois de cada chamada, envie o resumo, a transcrição e os dados recolhidos para o seu CRM, webhook ou base de dados.

A Chamada de API envia a chamada para o seu próprio sistema depois de terminar — o resumo, a transcrição, o estado de espírito e tudo o que o agente recolheu. Use-a para criar um lead no seu CRM, iniciar uma automatização ou manter os seus próprios registos. Se o seu sistema estiver em baixo, o pedido é repetido e nada se perde.

Configurar​

  1. Adicione a ação

    Abra o agente → Ações → Adicionar ferramenta → Post call → Chamada de API.

  2. Aponte-a para o seu endpoint
    CampoO que introduzir
    Nomep. ex. Sincronização de leads no CRM
    CondiçãoQuando enviar, p. ex. se quem liga quiser comprar. Vazio: depois de cada chamada
    URL do endpoint da APIO seu endpoint, p. ex. https://hooks.example.com/hanc
    Método HTTPPOST para a maioria dos sistemas; GET, PUT, PATCH e DELETE também funcionam
    Cabeçalhos, Parâmetros de consultaOpcionais, p. ex. uma chave API
  3. Dê forma ao pedido (opcional)
    • Corpo (JSON) — os seus próprios campos. Escreva {{ para inserir uma variável da chamada, p. ex. {"lead": "{{firstname}} {{lastname}}", "phone": "{{call_from}}"}.
    • Enviar apenas os meus campos — omite os dados padrão da chamada, para um sistema que só aceita a sua própria estrutura.
  4. Decida o que acontece em caso de falha
    • Novas tentativas em caso de erro — as pausas antes de cada nova tentativa quando o seu endpoint não responde com 2xx. Por defeito: 1 min, 5 min, 30 min, 2 h, 6 h, 24 h, 48 h.
    • Notificação de falha — um email depois da última tentativa (por defeito), depois de cada tentativa falhada, ou nunca. Enviar para: vazio significa o proprietário da conta.

O que vai receber o meu endpoint? no editor mostra o pedido exato.

O que o seu endpoint recebe​

Para POST, PUT e PATCH, um corpo JSON — os seus campos combinados com os campos da chamada:

{
  "id": "6ac7ea6eca60c6024b465c70",
  "agent_id": "6ac2a93e36bad261cf088684",
  "call_from": "+431234567890",
  "call_to": "+439876543210",
  "direction": "inbound",
  "call_type": "phone",
  "call_status": "success",
  "start_timestamp": 1730000000000,
  "end_timestamp": 1730000187000,
  "duration": 187000,
  "transcription": [
    { "speaker": "agent", "content": "Hello…", "timestamp": 1730000001000 },
    { "speaker": "user", "content": "Hi…", "timestamp": 1730000003000 }
  ],
  "call_summary": "Customer asked about pricing…",
  "task_achieved": true,
  "sentiment": { "sentiment": "positive", "explanation": "…" },
  "custom_analysis_data": { "name": "John", "email": "john@example.com" },
  "collected_data": {},
  "transfer_history": [],
  "recording_url": "https://…",
  "disconnection_reason": "user_hangup",
  "is_anonymous": false,
  "is_simulation": false,
  "created_at": 1730000000000,
  "updated_at": 1730000187000
}

Para GET e DELETE, os mesmos campos vão na query string, sem os campos aninhados (transcrição, estado de espírito, dados recolhidos).

Cada pedido leva X-Hanc-Delivery-Id — igual em todas as tentativas de uma mesma entrega, para que possa ignorar duplicados — e X-Hanc-Attempt com o número da tentativa. Cada tentativa expira ao fim de 30 segundos. Todas as tentativas aparecem em CRM → Comunicações, onde uma entrega falhada pode ser reenviada. Detalhes: Webhooks e entrega.

Casos de uso​

  • Criar um lead ou um ticket no seu CRM.
  • Iniciar uma automatização no-code com os dados da chamada.
  • Manter o seu próprio arquivo de chamadas.
Nesta página