Da TAI para o seu sistema

Muitas jornadas terminam com a TAI avisando outro sistema: uma admissão concluída cria a conta de e-mail, uma folha aprovada vira remessa no banco, um candidato novo aparece no Slack. Tudo começa num evento: cada fato de cada módulo — colaborador cadastrado, férias aprovadas, parcela vencida, card concluído — é publicado com os seus dados. O catálogo lista todos.

Escolha o caminho

Você quer	Use
Receber sempre um tipo de fato, no formato padrão da TAI	Webhook assinando o evento
Receber num formato próprio (Slack, um endpoint legado), só em alguns casos ou junto de outras ações	Fluxo automatizado com o bloco Chamar outro sistema
Que alguém acompanhe cada aviso, com fases, responsável e prazo	Fluxo (BPM) que ouve o evento e envia a partir do card

Para tratar só parte dos eventos — só contas a receber, só uma etapa —, filtre no seu sistema pelos dados do envio, ou use um fluxo automatizado, cujo gatilho aceita condições em Só quando.

Os três entregam com novas tentativas por cerca de um dia e ficam registrados em Processos › Central de Automações › Webhooks › Entregas.

1. Webhook assinando o evento

O caminho mais curto: nenhuma automação para montar.

1. Em Processos › Central de Automações, aba Webhooks, crie um Novo webhook com o endereço do seu sistema.
2. Em O que enviar, marque os eventos — por exemplo, Uma admissão é concluída — ou Tudo de <módulo>.
3. Marque Enviar também o registro completo se o seu sistema precisa da ficha inteira.
4. Copie o segredo, clique em Testar e ligue o webhook.

O seu sistema recebe:

{
  "id": "evt_48213",
  "tipo": "ADMISSAO_CONCLUIDA",
  "descricao": "Uma admissão é concluída",
  "versao": 1,
  "ocorridoEm": "2026-10-06T12:04:51.233Z",
  "empresa": { "id": 12, "nome": "Sua Empresa Ltda" },
  "dados": {
    "processoId": 42,
    "colaboradorId": 1813,
    "colaboradorNome": "Ana Ribeiro",
    "gestorId": 1544,
    "dataAdmissao": "2026-10-05"
  }
}

Confira a assinatura X-Tai-Assinatura com o segredo e use X-Tai-Entrega para não processar o mesmo envio duas vezes.

Assinar eventos Formato completo, cabeçalhos e o registro completo.

2. Fluxo automatizado com formato próprio

Em Processos › Fluxos › Novo processo › Fluxo automatizado (ou Processos › Central de Automações › Nova automação, que abre o mesmo diálogo), comece Em branco:

1. Comece pelo bloco Quando algo acontece e escolha o evento. Em Só quando, filtre pelos dados do evento, se quiser só parte deles.

2. Acrescente o bloco Chamar outro sistema com a URL (https).

3. Em Corpo (JSON), escreva o conteúdo no formato que o seu sistema espera, usando Inserir informação para os dados do evento (vazio, vão todas as informações do fluxo):

   {
     "text": "{{gatilho.colaboradorNome}} foi admitido(a) em {{gatilho.dataAdmissao}}"
   }

4. Em Cabeçalhos, informe o token se o seu sistema exige um — o envio do fluxo não leva assinatura X-Tai-Assinatura.

5. Publicar liga o fluxo.

O mesmo fluxo pode fazer outras coisas antes ou depois do envio — avisar o gestor no sino, abrir um card, fazer algo na plataforma, desviar com Se / senão. Testar percorre o desenho com dados de exemplo sem enviar nada; depois de publicado, o log de Execuções, com Detalhes técnicos, mostra a requisição e a resposta do seu sistema. Eventos que chegam enquanto o fluxo roda esperam na fila, um de cada vez.

3. Fluxo que ouve o evento

Quando cada aviso precisa de acompanhamento — alguém confere, o ERP devolve um número, o card só fecha quando o outro sistema confirma —, use um fluxo de Processos. Na aba Automações do fluxo, crie uma automação com Quando acontecer algo na plataforma, escolha o evento e o modo Abrir um card neste fluxo; acrescente a ação Webhook (Enviar para outro sistema), que roda no card novo. O seu sistema responde pela API, gravando campos ou movendo o card. O guia Automação com webhook mostra o ciclo completo.

Eventos que saem uma vez por fato

Reprocessar ou registrar de novo o mesmo fato não repete o envio: o id do evento é o mesmo. Alguns eventos são identificados pelo período, não pelo registro — A folha é paga sai uma vez por empresa e competência, por exemplo. Os detalhes estão no guia de cada módulo.

Reconciliação

As novas tentativas cobrem quedas de horas. Uma integração que depende de estar em dia deve também reconciliar pela API REST, de tempos em tempos:

1. Leia paginado o recurso que interessa (GET /<recurso>/page?page=0&size=100&sort=id,desc) e avance page até last ser true — veja Padrão das rotas.
2. Case pelo id da TAI (ou por uma chave sua gravada num campo, como codigoFuncionario no colaborador) e trate só o que mudou desde a última execução.
3. Seja idempotente: o mesmo fato pode chegar pelo webhook e pela reconciliação. Use o id da TAI como chave para não processar duas vezes.

Com sort=id,desc, os registros mais novos vêm primeiro: a rotina pode parar quando encontra um id que já conhece, se o que interessa forem só os registros novos.

O caminho contrário

Para o seu sistema mudar algo na TAI, use a API REST com o usuário de integração — cada guia de módulo mostra as chamadas. Para só avisar a TAI e deixar um fluxo automatizado decidir o que fazer, use um endereço de entrada com o gatilho Quando outro sistema chamar.