Automações de processos

As automações do módulo Processos executam ações quando algo acontece num fluxo — um card é criado, entra numa fase, vence o SLA, um campo muda — ou quando acontece algo na plataforma. Uma dessas ações é o Webhook (o editor mostra “Enviar para outro sistema”), que chama uma URL sua.

Para receber os fatos do ciclo do card sem montar automação — card criado, mudou de fase, concluído, cancelado, aprovado, reprovado —, assine os eventos de Processos num webhook. Use a ação quando precisar de condição ou de um corpo próprio.

Configurar

Na automação, escolha a ação Webhook e preencha:

Campo	Conteúdo
Endereço do outro sistema	URL HTTPS que recebe a chamada
Método (em Avançado)	POST (padrão), PUT, PATCH, GET ou DELETE
Cabeçalhos (em Avançado)	Pares nome/valor, por exemplo Authorization / Bearer seu-token. Ficam guardados cifrados
Conteúdo enviado (em Avançado)	Modelo JSON com variáveis do card (opcional)
Assinar o envio (em Avançado)	Gera um segredo e assina cada envio — veja Conferir a assinatura

As requisições saem com Content-Type: application/json; charset=utf-8 e os cabeçalhos X-Tai-Entrega e X-Tai-Tentativa — veja Assinar eventos. GET e DELETE não levam corpo.

Corpo padrão

Com o corpo em branco, a TAI envia:

{
  "cardId": 90412,
  "numero": 1287,
  "status": "EM_ANDAMENTO",
  "pipeId": 14,
  "pipeNome": "Compras",
  "faseId": 63,
  "faseNome": "Aprovação"
}

Corpo personalizado

O corpo e os cabeçalhos aceitam variáveis entre chaves duplas, substituídas no momento do envio:

{
  "pedido": "{{card.numero}}",
  "etapa": "{{fase.nome}}",
  "solicitante": "{{criador.email}}",
  "valor": "{{campo.valor_total}}",
  "formulario": "{{formulario.link}}"
}

Variável	Valor
{{card.id}}, {{card.numero}}, {{card.status}}	Identificação e status do card
{{card.dataCriacao}}, {{card.dataVencimentoSla}}, {{card.slaVencido}}	Datas e SLA
{{fase.id}}, {{fase.nome}}	Fase atual
{{pipe.id}}, {{pipe.nome}}	Pipe
{{criador.nome}}, {{criador.email}}	Quem criou o card
{{responsavel.nome}}, {{responsavel.email}}	Responsável pelo card
{{formulario.link}}	Link do formulário da fase
{{campo.<identificador>}}	Valor de um campo do card, pelo identificador do campo

Datas nas variáveis saem como dd/MM/yyyy HH:mm.

Variáveis entram como texto

No corpo de uma automação de card, as variáveis são substituídas como texto, sem escape: um campo com aspas ou quebra de linha pode quebrar o JSON. Para textos livres, mande só {{card.id}} e busque o resto pela API (GET /card/{id}). Números saem no formato 12500.0.

Quando o fluxo ouve um evento

Uma automação de fluxo também pode disparar com Quando acontecer algo na plataforma, escolhendo um evento do catálogo, em um de dois modos:

• Abrir um card neste fluxo — por exemplo, abrir o card de onboarding quando alguém é admitido. As ações seguintes, inclusive o envio, rodam no card novo.
• Agir nos cards deste fluxo que forem do mesmo assunto — um campo do card corresponde a um dado do evento (o colaborador do card = o colaboradorId do evento), e as ações rodam em cada card aberto que corresponder.

Resultado

Uma resposta 2xx conta como sucesso. Falha de rede, 5xx, 408, 425 e 429 entram em novas tentativas sozinhas (até cerca de 21 horas); a execução da automação mostra a falha da primeira tentativa e a hora da próxima. As regras completas estão em Entregas e novas tentativas.