Page cover
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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


❓ 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?


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


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

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

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.

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

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

  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.

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.

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.

💡 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

Atualizado