Sincronizar Dados usando Webhook

Envie de volta para o seu sistema tudo o que a Tig.ai aprendeu durante a chamada no momento em que ela termina.

Esta página explica como a Tig.ai envia aquilo que aprendeu de volta para o seu sistema quando uma conversa termina.

Esses dados extraídos ficam em gathered_context. Então o quadro completo é: initial_context é o que o seu backend envia para a chamada e gathered_context é o que a Tig.ai extrai dela. Um nó Webhook é a forma de obter gathered_context de volta.

​

Etapa 1: Adicionar o nó

Clique em Add node, role para baixo e você encontrará o nó Webhook. Adicione-o e abra-o.

​

Etapa 2: Definir o endpoint

A primeira coisa que você verá é a URL do endpoint. Cole aqui a URL do webhook do seu backend. Ainda está testando? Use uma URL gratuita do webhook.site — copie sua URL exclusiva de lá e cole na Tig.ai.

Defina o método como POST. Se o seu backend exigir autenticação, adicione um bearer token ou uma API key logo aqui também.

​

Etapa 3: Montar o template do payload

Esta é a parte importante: ela decide exatamente qual JSON a Tig.ai envia. Inclua os campos initial_context e gathered_context, além do resultado final da chamada vindo de {{gathered_context.call_disposition}}.

{
  "debtor_name": "{{initial_context.debtor_name}}",
  "client_name": "{{initial_context.client_name}}",
  "debt_amount": "{{initial_context.debt_amount}}",
  "amount_user_will_pay": "{{gathered_context.amount_user_will_pay}}",
  "payment_method": "{{gathered_context.payment_method}}",
  "sentiment": "{{gathered_context.sentiment}}",
  "call_disposition": "{{gathered_context.call_disposition}}"
}

Para ver todas as variáveis que você pode referenciar aqui, consulte a referência de desenvolvedor Webhook Payloads.

Os nomes das variáveis no seu payload precisam corresponder exatamente aos campos do seu contexto. Se uma variável não puder ser resolvida, o campo permanece no payload com valor de string vazio.

​

Etapa 4: Salvar e publicar

Salve o nó de webhook e publique o agente.

​

Etapa 5: Testar

Execute uma chamada de teste. Quando ela terminar, volte ao seu receptor de webhooks. Você verá uma única requisição contendo initial_context — os dados que você enviou para a chamada — e gathered_context — o que a Tig.ai extraiu da conversa — no mesmo payload JSON.

Esse é o ciclo completo: seu backend envia initial_context para a Tig.ai, a Tig.ai executa a chamada e extrai gathered_context, e o nó de webhook envia os dados estruturados finais de volta ao seu backend. Em produção, troque a URL do webhook.site pela URL real do seu backend.

​

Próximos passos

• Conecte um número de telefone real: Conectar com Telefonia aborda como configurar o Twilio para que essas chamadas saiam de verdade.
• Lista completa de variáveis e opções de autenticação: veja a referência de Webhook e a referência de desenvolvedor Webhook Payloads.