> For the complete documentation index, see [llms.txt](https://guia-de-uso.tiflux.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guia-de-uso.tiflux.com/faq/duvidas-frequentes/configuracoes/mesa-de-servico/automacoes/kcs-webhook-como-funciona-e-como-configurar-o-webhook-de-tickets.md).

# 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<br>

***

### ❓ 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)?<br>

***

### 🔎 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.<br>

***

### ✅ 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

1. Acesse Configurações ➔ Mesa de Serviço ➔ Automações.
2. Clique no botão "+ Automação" (ou edite uma automação existente).
3. Na seção "Quando", selecione o gatilho desejado para o disparo.
4. Defina as Condições de filtro (ex: mesas específicas, clientes, prioridades).
5. Na seção "Ações", selecione a opção "Disparar webhook".
6. 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.
7. Clique em "Criar automação".<br>

#### 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.<br>

> 💡 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.site` como URL de destino temporária.

***

### 🔍 Palavras-chave para busca

```
webhook de tickets tiflux,
configurar webhook automacao mesa de servico,
integrar n8n make crm tiflux webhook,
gatilhos disparo webhook chamado,
reenvio de falhas webhook tiflux,
payload json ticket webhook,
log de automacoes webhook tiflux
```