> 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/sistema/tickets/webhook-de-tickets.md). # Webhook de Tickets ## 📌 **🌐** Webhook de Tickets no Tiflux Markdown ``` 📍 Localização: 📂 Configurações > Mesa de Serviço > Automações ``` *** ### 🎯 Introdução O Webhook de Tickets permite integrar o Tiflux a plataformas e serviços externos por meio de requisições HTTP. A funcionalidade dispara eventos em tempo real para automações externas (como N8N, Make, CRMs ou APIs próprias) sempre que uma condição configurada no sistema for atingida.
*** ### 📚 Sumário 1. 🧾 O que é o Webhook de Tickets? 2. 🔄 Quando o Webhook é Acionado (Gatilhos / Triggers) 3. 🛠️ Como Configurar o Webhook nas Automações 4. 🧪 Exemplo Prático de Integração 5. 📊 Estrutura do Payload (JSON) 6. ⚠️ Avisos Importantes 7. ❓ Perguntas Frequentes (FAQ)
*** ### 🧾 O que é o Webhook de Tickets? É um mecanismo que envia os dados completos de um ticket (ID, status, responsável, solicitante, SLA, campos personalizados, etc.) para uma URL externa sempre que um evento ocorre.
* Casos de uso: Sincronização com CRMs, envio de alertas em canais do Slack/Teams, criação de tarefas no Jira/Notion ou acionamento de fluxos customizados em ferramentas de automação.
*** ### 🔄 Quando o Webhook é Acionado (Gatilhos / Triggers) É possível selecionar a opção Disparar webhook em qualquer um dos 4 gatilhos da seção Quando:
1. Ticket altera o estágio: Disparado ao movimentar o ticket entre etapas da mesa.
2. Ticket permanece por um tempo: Disparado ao atingir o limite configurado de inatividade/permanência.
3. Ticket é aberto: Disparado imediatamente após o cadastro/criação do ticket no sistema.
4. Ticket recebe nova resposta: Disparado a cada nova interação ou resposta registrada no ticket.
*** ### 🛠️ Como Configurar 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 um dos 4 gatilhos disponíveis.
4. Clique na ação `Disparar webhook`.
5. Defina as Condições (filtros de mesa, cliente, prioridade, etc.).
6. Em Ação, preencha os parâmetros de destino:
* Para URL: Endereço da aplicação/endpoint que receberá a requisição.
* Token ou Chave secreta: Token de autenticação da API V2 do usuário.
7. Clique em Criar automação.
*** ### 🧪 Exemplo Prático de Integração Markdown ``` CENÁRIO: Registrar tickets encerrados em um CRM externo via N8N/Make. • Gatilho (Quando): Ticket alterar o estágio • Condição: Estágio igual a "Fechado" • Ação: Disparar webhook • URL Destino: https://sua-instancia.com/webhook/v1/tickets-fechados • Método: POST ``` Após o envio, a ferramenta parceira recebe a estrutura JSON em tempo real para dar sequência ao fluxo desejado.
### 📊 Estrutura do Payload (JSON) JSON ``` { "ticket_number": 12345, "title": "Titulo do Ticket", "description": "Descricao completa em HTML", "status": { "id": 1, "name": "Aberto" }, "priority": { "id": 2, "name": "Alta" }, "stage": { "id": 10, "name": "Em Atendimento", "first_stage": false, "last_stage": false }, "created_at": "2025-11-10T12:00:00Z", "updated_at": "2025-11-10T14:30:00Z", "closed_ticket_total_spent_solving": "02:30", "worked_hours": "04:15", "client": { "id": 100, "name": "Nome do Cliente", "social": "Razao Social LTDA", "social_revenue": "12345678000199" }, "responsible": { "id": 50, "name": "Responsavel Nome", "email": "responsavel@exemplo.com", "active": true, "technical_group_id": 5 }, "requestor": { "id": 200, "email": "solicitante@cliente.com", "name": "Solicitante Nome", "extension": "123", "phone": "+5547999999999" }, "equipment_group": { "id": 15, "name": "Grupo de Equipamentos" }, "equipment": { "id": 300, "equipment_name": "Notebook Dell", "equipment_group_id": 15, "equipment_user_id": 200 }, "service_catalog": { "item_id": 25, "item_name": "Problema de Rede", "area_name": "Infraestrutura", "catalog_name": "TI" }, "followers": ["seguidor1@exemplo.com", "seguidor2@exemplo.com"], "created_by_id": 50, "created_by_way_of": "web", "sla": { "attend_sla": true, "attend_expiration": "2025-11-10T16:00:00Z", "solve_expiration": "2025-11-11T12:00:00Z", "stage_expiration": "2025-11-10T18:00:00Z", "total_sla_time": 120.5, "stopped": false }, "reopen_count": 0, "last_answer_type": "attendant", "parent_ticket_id": null, "parent_ticket_number": null, "child_tickets": [ {"id": 12346, "ticket_number": 12346}, {"id": 12347, "ticket_number": 12347} ], "desk": { "id": 8, "name": "Suporte N1", "description": "Mesa de primeiro atendimento" }, "is_grouped": false, "changed_first_stage_at": "2025-11-10T12:05:00Z", "entities": [ { "id": 1, "name": "Dados Adicionais", "applied_in": "ticket", "entity_field_values": [ { "id": 100, "entity_field_id": 10, "entity_field_name": "Nivel de Urgencia", "field_type": "single_select", "value": "3", "entity_field_option_id": 3, "entity_field_option_value": "Urgente" } ] } ] } ``` ### ⚠️ Avisos Importantes > Reenvio de Falhas: Em caso de erro na resposta do servidor receptor, o Tiflux tenta reenviar a requisição até 3 vezes com intervalo de 5 minutos.\ > Anexos: O payload do webhook transfere metadados e conteúdos em texto. Para download de arquivos e anexos físicos, consuma a API do Tiflux de forma complementar. *** ### ❓ Perguntas Frequentes (FAQ) 🔹 **O que acontece se o webhook falhar?**\ O Tiflux tenta reenviar a requisição até 3 vezes com intervalo de 5 minutos. Após isso, o evento é registrado como falha no log de automações. 🔹 **Posso usar o webhook para atualizar o próprio Tiflux?**\ Sim, desde que você use a API do Tiflux e configure corretamente a autenticação (token ou chave API). 🔹 **Como testo meu webhook antes de ativar?**\ Use serviços gratuitos como [Webhook.site](https://webhook.site/) para capturar e inspecionar o payload enviado. 🔹 **Posso acionar o webhook em vários estágios ao mesmo tempo?**\ Sim! Você pode criar múltiplas automações ou usar uma única automação com condição de “qualquer mudança de estágio”. 🔹 **O webhook envia dados em tempo real?**\ Sim, o disparo é instantâneo assim que o gatilho é acionado (troca de estágio ou pausa por inatividade). 🔹 **Posso incluir anexos ou imagens no payload?**\ Não diretamente. O webhook envia apenas metadados e texto. Para anexos, use a API do Tiflux separadamente. 🔹 **Posso definir diferentes URLs por mesa de serviço?**\ Sim! Ao configurar a automação, você pode filtrar por mesa e definir URLs específicas para cada uma. 🔹 **O webhook funciona com tickets importados ou apenas criados manualmente?**\ Funciona com todos os tickets, independentemente da origem (manual, API, e-mail, etc.). 🔹 **Como vejo o histórico de disparos de webhook?**\ No log de automações: **Configurações > Mesa de Serviço > Automações > Automação específica > Log de Automações**. *** ### 🔍 Palavras-chave para IA, indexação e busca ``` webhook tickets, automações tiflux, ticket webhook, integração tiflux, disparo webhook, mudança de estágio, pausa por inatividade, automatizar tickets, API tiflux, configurar webhook, webhook tiflux, notificação automática, integração com CRM, payload webhook, trigger tiflux ```