3. Como ler e responder textos

Confira abaixo como ficará a integração após seguir esse tutorial.

📘
Para baixar o fluxo pronto, o JSON com todos os passos está nesse link.
Você poderá criar seu próprio fluxo, para facilitar você pode baixar o nosso fluxo e alterar.

Como fazer

Montando o escopo da integração

Crie uma conta no N8N.
Clique em "Add workflow".
Em seguida, clique em "Add first step".
Selecione o node "On webhook call".
Altere o método "HTTP" para "Post".

Armazenando variáveis

Crie um node "Edit Fields".
Crie uma variável chamada text e armazene nessa variável o valor lastMessagesAggregated. Veja imagem abaixo:

Configurando o node do assistente

Logo após criar o webhook, é preciso criar o node do assistente IA.
Para isso, clique em "+", digite "OpenAI" e selecione "Message an assistant".
Adicione a credencial que foi criada dentro da plataforma da OpenAI, essa credencial será a chave da API que você criou no passo 3 da etapa Criar um assistente.
Nas opções "Resource" e "Operation" deixe ambos default.
Em "Assistant" selecione o assistente que você criou na etapa Criar um assistente.
Em "Prompt" selecione a opção "Define below", no campo "text" passe a variável text que gravamos no node anterior "Edit Fields".

Em "Memory" defina para "Use memory connector". Será criado um nó abaixo do nome "Window Buffer Memory", nele é preciso passar o ID da sessão (presente no webhook).

📘
Atenção
Definir a memória é muito importante, ela que fará com que o assistente consiga entender o contexto da conversa.

Ferramentas do assistente IA

O assistente possui ferramentas (Tools), que permitem interações com outros sistemas através de requisições HTTP. Isso torna-se útil e abre um leque de opções: você pode fazer requisições para buscar um boleto em um banco de dados e retorná-lo para o contato, por exemplo. Nesse documento vamos abordar três funcionalidades, mas o céu é o limite tratando-se dessa funcionalidade.

1. Buscar equipes

Nessa primeira etapa vamos realizar uma requisição na API para buscar as equipes de uma conta. Essa lista de equipes dará uma base ao seu agente para transferir o contato de acordo com o contexto da conversa.

Clique em tools e crie uma requisição HTTP.
Em "Description" você deve dar instruções para o agente da função, segue uma sugestão: "Nesta função você consegue listar as equipes disponíveis para transferência".
Configure a requisição de acordo com a documentação.
Ao configurar o header defina o "Value Provided" como "Using Field Below". Veja imagem abaixo:

2. Transferir equipe

Nessa etapa vamos configurar a função de transferência de equipe. Também vamos criar uma requisição HTTP, para o endpoint de transferir conversas.

Assim como na etapa anterior vamos dar algumas instruções para nosso assistente IA sobre como usar essa função, segue uma sugestão:

Setores para transferência.

Algumas diretrizes:

Seja rápido e objetivo ao responder perguntas frequentes, buscando entender detalhadamente o problema do contato.

Explique de maneira simples qualquer processo técnico de baixa complexidade.

Demonstre paciência ao lidar com questões delicadas ou frustrações dos clientes.

Utilize um tom positivo e otimista, mesmo ao comunicar informações difíceis ou negativas.

Não solicite dados do contato como e-mail, Id, números de protocolo ou documentos.

Configure a requisição de acordo com a documentação.
Marque a opção "Send Body" e cole o JSON abaixo no body da requisição.

{
  "type": "DEPARTMENT",
  "newDepartmentId": "{departmentId}"
}

Você deve usar um placeholder para quaisquer dados a serem preenchidos pelo modelo. Veja imagem abaixo:

3. Concluir atendimento

Por fim, a função de concluir atendimento. Nessa etapa vamos configurar uma outra requisição para finalizar o atendimento quando solicitado pelo contato. Siga os passos abaixo:

No campo "Description" passe as instruções para seu assistente IA.
Configure a requisição de acordo com a documentação.
Marque a opção "Send Body" e cole o JSON abaixo no body da requisição:

{
  "reactivateOnNewMessage": true
}

Configuração do node de enviar mensagem ao contato

O primeiro passo é instalar o módulo do WTS em seu N8N. É possível encontrar essa informação para a instalação em "Ajustes" > "Integrações" > "Automações via N8N".
Após instalar o módulo WTS, crie uma chave de API dentro da plataforma em "Ajustes" > "Integrações" > "Integrações Via API" > "Novo" > "Nomeie a chave" > "Salve" > "Copie".
Clique para adicionar um novo nó e digite "WTS", procure por "Session Actions" > "Send Message Text".
Em "Credential to connect with", caso você já tenha uma chave de API criada, basta selecioná-la. Caso não, basta criar uma nova em "Create new credential" e colar a chave API criada na plataforma.
O output em questão é a resposta do seu agente, você deve passá-lo dentro da requisição para disparar essa resposta para o contato.
No campo "Text" coloque o output retornado por seu agente IA, no campo "Session ID" informe o id da sessão (essa informação você encontra no output do webhook, procure por sessionId).

Seguindo esse tutorial, será possível ler e responder textos usando o ChatGPT. Além disso será possível executar funções de transferência e conclusão de atendimentos. Você também pode adicionar outras funções ao seu assistente, como buscar boletos em uma API externa por exemplo. Existem diversas possibilidades que você pode explorar utilizando as ferramentas do seu assistente.