> 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/geral/integracoes/n8n/kcs-abertura-automatica-de-ticket-via-n8n-a-partir-de-atendimento-por-chat-ou-ia.md).

# KCS - Abertura Automática de Ticket via N8N a partir de Atendimento por Chat ou IA

## 🤖 Abertura Automática de Ticket via n8n a partir de Atendimento por Chat ou IA

🕒 Tempo aproximado para leitura: 00:02:00 min<br>

***

### ❓ Dúvida

É possível automatizar a criação de um ticket no TiFlux a partir de um chat que passou por um fluxo do sistema ou por um agente de IA, utilizando a integração com o n8n via Webhook e chamadas da API v2?<br>

***

### 🔎 Causa / Contexto

Em fluxos de atendimento automatizados, após a interação inicial do cliente com o bot ou IA (seja por conclusão do atendimento ou transbordo técnico), pode ser necessário registrar formalmente as informações conversadas na forma de um ticket.\
Para que os detalhes do atendimento não se percam, o TiFlux permite enviar os dados do evento via Webhook para uma ferramenta de iPaaS (como o n8n), permitindo tratar a conversa, estruturar o chamado e informar o cliente sobre a abertura do ticket.<br>

***

### ✅ Solução / Arquitetura da Integração no n8n

{% hint style="warning" %}
Este é apenas um exemplo de como você pode fazer este fluxo de aturomação
{% endhint %}

A automação do fluxo entre Chat, IA, n8n e API v2 do TiFlux deve seguir as etapas estruturadas abaixo:<br>

#### 1. Disparo do Evento (TiFlux ➔ n8n)

* O atendimento via chat inicia no TiFlux e passa pelo fluxo automatizado ou pelo agente de IA.
* Após o sucesso ou insucesso da tratativa, o TiFlux aciona um gatilho de Webhook configurado para disparar a carga de dados (*payload*) para o n8n.<br>

#### 2. Consulta de Dados do Chat (n8n ➔ API v2)

No n8n, ao receber a requisição do Webhook:<br>

1. Exibir Chat: Faça uma chamada HTTP GET para a rota `/api/v2/chats/{id}` para obter o contexto do cliente e do atendimento.
2. Exibir Mensagens do Chat: Execute uma chamada HTTP GET para a rota de listagem de mensagens do chat (`/api/v2/chats/{id}/messages`) para capturar todo o histórico da conversa.<br>

#### 3. Tratamento dos Dados via Código Javascript

* Utilizando o nó Code do n8n, processe e formate o histórico de mensagens em um texto limpo, organizando as falas do cliente e do bot/IA para que sirvam de descrição técnica do chamado.<br>

#### 4. Criação do Ticket e Resposta ao Cliente

1. Criar Ticket: Faça uma chamada HTTP POST para a rota de criação de tickets (`/api/v2/tickets`), enviando os dados consolidados no nó Code (solicitante, assunto e histórico formatado).
2. Notificar o Chat: Com a API v2, envie uma mensagem de retorno no chat notificando o usuário (ex: *"Seu atendimento gerou o Ticket nº {TICKET\_ID} com sucesso!"*).
3. Ação Final: Conforme a regra de negócio da sua operação, o fluxo no n8n pode encerrar o chat via API ou mantê-lo aberto para transbordo a um atendente humano.<br>

> 💡 Dica de Especialista / Nota: Certifique-se de tratar adequadamente os erros HTTP no n8n (utilizando a opção *Continue On Fail* nos nós da API) para garantir que inconsistências de rede ou falhas no payload não interrompam o ciclo de criação do chamado.

***

### 🔍 Palavras-chave para busca

```
abrir ticket automatico chat n8n,
webhook chat para ticket tiflux,
api v2 criar ticket chat,
integracao ia chat n8n tiflux,
tratar mensagens chat no n8n,
no code n8n historico chat,
transbordo chat para ticket,
fluxo de chat api tiflux
```