Visão geral dos webhooks

Tudo o que acontece na TAI vira um evento: um colaborador cadastrado, uma admissão concluída, a folha aprovada, uma parcela vencida, um card que muda de fase. Os webhooks levam esses eventos ao seu sistema, assinados e com novas tentativas — e trazem dados do seu sistema para dentro da TAI.

Três formas de enviar

Forma	Quando usar	Assinada
Webhook assinando eventos	O seu sistema quer receber um tipo de fato, sempre: “todo colaborador cadastrado”, “tudo do Financeiro”	Sempre
Bloco “Chamar outro sistema” num fluxo automatizado (ou a ação Enviar para outro sistema numa automação de quadro)	Com o corpo no formato que o seu sistema espera (um incoming webhook do Slack, um endpoint legado), com condições ou junto de outras ações	Só a ação do quadro, com Assinar o envio; o fluxo autentica por cabeçalho
Ação nos gatilhos do Atendimento	Mandar o chamado inteiro quando um gatilho do service desk dispara	Não

As três passam pela mesma entrega: registro de cada envio, novas tentativas por cerca de um dia quando o seu sistema está fora e Reenviar pela tela.

Assinar eventos Crie o webhook, escolha os eventos e veja o formato do envio.

Conferir a assinatura HMAC-SHA256 com o segredo do webhook, em Node.js e Python.

Entregas e novas tentativas O que conta como entregue, quando a TAI tenta de novo e quando desiste.

Catálogo de eventos Todos os eventos, por módulo, com os dados de cada um.

Receber dados de outro sistema Um endereço da TAI que o seu sistema chama para disparar automações.

Automações de processos A ação de envio nos fluxos (BPM): corpo, variáveis e exemplos.

Quem configura

Webhooks e endereços de entrada ficam em Processos › Central de Automações, aba Webhooks, e são configurados pelo dono da conta e por administradores. Fluxos automatizados nascem em Processos › Novo processo › Fluxo automatizado; as automações de um quadro ficam na aba Automações da configuração do quadro, para quem gerencia o quadro.

Os guias de cada módulo mostram quais eventos usar em cada jornada — comece por Da TAI para o seu sistema.