KCS - Webhook - Como Funciona e Como Configurar o Webhook de Tickets
🌐 Como Funciona e Como Configurar o Webhook de Tickets
🕒 Tempo aproximado para leitura: 00:02:00 min
❓ Dúvida
O que é e como configurar o Webhook de Tickets no TiFlux para integrar a plataforma com sistemas e automações externas (como N8N, Make, CRMs ou APIs próprias)?
🔎 Causa / Contexto
A necessidade de enviar os dados dos chamados em tempo real para aplicações externas exige o uso de requisições HTTP automáticas. O recurso de Webhook dispara um payload estruturado (JSON) com todas as informações do ticket (ID, status, responsável, solicitante, SLA, campos personalizados, etc.) para uma URL externa sempre que uma condição configurada no TiFlux é atingida.
✅ Solução / Passo a Passo de Configuração
1. Gatilhos de Disparo Disponíveis
O Webhook pode ser associado a qualquer um dos 4 gatilhos de automação do TiFlux:
Gatilho / Evento
Momento do Disparo
Ticket altera o estágio
Movimentação do chamado entre etapas da mesa de serviço.
Ticket permanece por um tempo
Atingimento do limite estipulado de inatividade ou permanência na etapa.
Ticket é aberto
Criação ou cadastro imediato do chamado no sistema.
Ticket recebe nova resposta
Registro de qualquer nova interação ou resposta no chamado.
2. Configurando o Webhook nas Automações
Acesse Configurações ➔ Mesa de Serviço ➔ Automações.
Clique no botão "+ Automação" (ou edite uma automação existente).
Na seção "Quando", selecione o gatilho desejado para o disparo.
Defina as Condições de filtro (ex: mesas específicas, clientes, prioridades).
Na seção "Ações", selecione a opção "Disparar webhook".
Preencha os campos de destino:
Para URL: Endereço do endpoint externo que receberá as requisições.
Token ou Chave secreta: Token de autenticação da API V2 do usuário.
Clique em "Criar automação".
3. Regras de Retentativa e Limitações do Payload
Reenvio de Falhas: Em caso de erro na resposta do servidor receptor, o TiFlux realiza até 3 tentativas de reenvio com intervalos de 5 minutos. Se as falhas persistirem, a execução é registrada no log.
Anexos e Arquivos: O payload transfere estritamente metadados e textos. Para realizar o download de arquivos físicos, consuma a API do TiFlux de forma complementar.
💡 Dica de Especialista / Nota: Para testar a estrutura dos dados enviada antes de conectar sua automação definitiva, utilize ferramentas gratuitas de inspeção como o
webhook.sitecomo URL de destino temporária.
🔍 Palavras-chave para busca
Atualizado