Como conectar o agente de IA do n8n ao WhatsApp

Neste artigo, vamos mostrar como conectar um bot ou agente de IA do n8n ao WhatsApp. Para isso, usaremos as APIs e os webhooks do WhatsApp fornecidos pelo Chakra Chat.

Ao final, você terá um agente de chat completo do n8n respondendo às dúvidas dos usuários pelo seu número do WhatsApp conectado à nuvem.

Pré-requisitos

A) Vamos presumir que você já tem uma conta na nuvem do n8n ou hospeda o n8n em algum lugar acessível pela internet pública.

B) Também é necessário ter uma conta no Chakra Chat e já ter conectado o WhatsApp. Caso ainda não tenha feito isso, siga as etapas abaixo

1. Inscreva-se no Chakra Chat
2. Conecte o WhatsApp

Observe também que este bot pode ser criado com uma conta gratuita do Chakra Chat. 🎉

C) Você também precisará de uma conta da OpenAI e de uma chave da OpenAI, pois usaremos a OpenAI como nosso provedor de IA. Você pode criar uma conta de desenvolvedor da OpenAI nesta página

Etapa 1. Configure um gatilho de webhook no n8n

1.1 Primeiro, faça login na sua conta do n8n e crie um novo fluxo de trabalho clicando no botão "Create Workflow", no canto superior direito do painel principal do n8n

1.2 Clique no nó "Add First Step" e selecione o gatilho "On webhook call"

1.3 Configure a URL do webhook de teste no ChakraHQ

1.3.1 A página de configuração do gatilho de webhook deve estar aberta. Clique na URL do webhook de teste para copiá-la para a área de transferência

1.3.2 Abra sua conta do Chakra Chat, acesse a página WhatsApp Setup e clique na aba More

1.3.3 Role a página para baixo e clique no botão de alternância abaixo de "Enable pass-through webhook".

1.3.4 Cole a URL copiada do webhook de teste do n8n no campo abaixo de "Pass through webhook URL"

1.3.5 Clique no botão Save no canto superior direito da página de configuração do WhatsApp para salvar a configuração

1.4 Certo. Excelente! Agora vamos testar nossa integração.

1.4.1 Volte ao n8n e altere o HTTP Method do gatilho para POST na página de configuração do webhook

1.4.2 Clique no botão "Listen for test event"

1.4.3 Precisamos enviar uma mensagem para o número do WhatsApp usando o número de WhatsApp de outro usuário final, para gerar um evento de webhook de teste

1.4.4 Na página de configuração do gatilho do n8n, você deverá ver agora o evento de webhook correspondente à mensagem que acabou de enviar, como na captura de tela abaixo. Se não encontrar nenhum evento, revise todas as etapas anteriores e confira sua configuração

1.4.5 Certo, agora estamos prontos para configurar um agente de IA. Clique em "Back to Canvas" e salve rapidamente todo o progresso feito até aqui no fluxo de trabalho.

Etapa 2. Configure um agente de IA

Agora vamos configurar um agente de IA da OpenAI no n8n.

2.1 Clique no botão de adição ao lado do gatilho de webhook no editor de fluxo de trabalho do n8n. Um painel com opções de nós deverá abrir à direita. Clique em "AI" para ver todas as opções de nós de IA

2.2 Clique em AI Agent para selecionar e adicionar um nó AI Agent

2.3 A página de configuração do nó AI Agent deverá estar aberta

2.4 Clique no menu suspenso de "Source for Prompt (User Message)". Por padrão, ele está configurado para chat Input, mas precisamos conectá-lo à entrada do gatilho de webhook. Então, clique na opção "Define below"

2.5 A aba Input, à esquerda, mostra o objeto JSON completo enviado pelo webhook. Localize a mensagem que você enviou na entrada à esquerda, clique nela e arraste-a para a caixa de texto Prompt.

2.6 Agora, vamos configurar o modelo de chat. Clique no botão Plus abaixo da opção "Chat Model" na parte inferior da página

2.7 Um submenu com uma lista de modelos de IA disponíveis deverá abrir à direita. Pesquise por OpenAI e clique para selecioná-la.

2.8 A página de configuração do subnó OpenAI deverá estar aberta. Aqui, precisamos configurar as credenciais da OpenAI. Se elas já estiverem disponíveis, selecione-as; caso contrário, clique em create new credentials e informe uma chave de API da OpenAI.

2.9 Agora podemos voltar à tela do canvas clicando em "Go back to canvas" e clicar em "Execute Workflow" para testar a configuração até aqui. Isso fará com que o fluxo de trabalho comece a ouvir eventos no webhook de teste.

2.10 Abra sua conta de WhatsApp de usuário final e envie uma mensagem para o número de WhatsApp conectado. Você não receberá uma resposta, mas deverá ver os registros da resposta da OpenAI no nó AI Agent. O nó AI Agent também deverá ficar contornado em verde, indicando que a execução foi concluída com sucesso

Se a execução não for concluída com sucesso, revise sua configuração refazendo as etapas anteriores.

3. Envie a resposta da IA de volta ao usuário

Agora que nosso agente de IA pode responder às mensagens recebidas no chat, vamos começar a enviá-las de volta pelo WhatsApp

3.1 No editor de fluxo de trabalho do n8n, clique no botão + à direita do nó AI Agent. Isso abrirá o menu de seleção de nós. Na barra de pesquisa, digite "HTTP request" e clique no tipo de nó HTTP Request .

3.2 Configure o nó HTTP Request para enviar uma mensagem usando a API de envio de mensagens do WhatsApp.

Confira os detalhes sobre essa API na documentação da API. A configuração deverá ser parecida com a abaixo

• Método: POST

URL: https://api.chakrahq.com/v1/ext/plugin/whatsapp/{{chakraPluginId}}/api/v22.0/{{whatsappPhoneNumberId}}/messages

• Cabeçalhos:

Authorization: Bearer {{chakraAccessToken}}

• Corpo: Deve ser do tipo json

• Corpo: O objeto JSON completo deve ser assim

As informações necessárias para configurar a API acima estão disponíveis na sua conta do Chakra Chat. Abaixo está uma breve descrição de cada uma

Como encontrar o chakraPluginId

Na página de configuração do WhatsApp do Chakra Chat, localize o ícone de três pontos ao lado do botão de salvar, no canto superior direito. Clique nele e, em seguida, no botão "Copy Plugin Id". O ID do plugin será copiado. Você pode colá-lo onde precisar

Como encontrar o WhatsAppPhoneNumberId

Na página de configuração do WhatsApp do Chakra Chat, clique no ícone de engrenagem ao lado de "📞 WhatsApp Phone Number. s". No painel que abrir, você encontrará o ID da Meta de cada número de telefone na coluna de números de telefone

Como obter um chakraAccessToken

Para usar as APIs da Chakra, primeiro você precisa criar uma chave de API para seu caso de uso na seção API Keys do Chakra Chat.

Crie uma chave de API

Para criar uma chave de API, você precisa fornecer as seguintes informações:

• Nome - Nome da chave. Use um nome significativo. Isso facilita o gerenciamento das chaves.
• Descrição (opcional) - Descrição do acesso das chaves de API
• Função - Escolha uma role para a nova chave de API. Ela herdará os privilégios fornecidos pela função atribuída e ficará limitada a eles. Verifique se as chaves de API expostas publicamente têm a função com os menores privilégios necessários para realizar a tarefa.

Depois de criar uma chave de API, você encontrará o chakraAccessToken na seção "Access Tokens" da chave de API criada.

3.3 Depois de configurar o HTTP Request, volte ao Canvas e clique no botão de executar etapa acima do nó HTTP Request. Se tudo estiver configurado corretamente, o nó executará a etapa e você receberá a saída de teste da OpenAI na conta de WhatsApp do usuário final 🥳

4. Publique seu fluxo de trabalho

4.1 Salve seu fluxo de trabalho e marque-o como ativo

4.2 Clique duas vezes no webhook e clique em Production URL, em URLs do webhook. Em seguida, clique na URL para copiá-la

4.3 Agora, abra sua conta do Chakra Chat e acesse a página de configuração do WhatsApp. Em seguida, clique na aba Mais. Cole a URL do webhook copiada no campo abaixo de "URL do webhook de passagem."

4.4 Clique em Salvar no canto superior direito da página para salvar essa configuração. Agora, os eventos do WhatsApp serão enviados para a URL do webhook de produção.

Conclusão

Pronto! Agora você pode testar seu bot e, em seguida, modificar o agente para atender a casos de uso mais complexos. O agente de IA descrito acima é bastante básico. Para casos de uso práticos, você precisará adicionar outros recursos, como memória ou processamento de imagens. Mas o princípio básico continua o mesmo

Apêndice

A. Adicione uma condição if para filtrar eventos que não sejam de mensagem

O webhook de passagem geralmente recebe muitos eventos do WhatsApp. Alguns são eventos de mensagem, enquanto outros podem ser eventos de status ou de cobrança. O ideal é adicionar um nó de condição if após o nó Webhook para filtrar os eventos que não sejam de mensagem.

Depois de fazer isso, lembre-se de alterar a expressão do prompt do usuário no nó AI Agent para selecionar corretamente os dados do webhook. Ela ficará mais ou menos assim

{{ $('Webhook').item.json.body.entry[0].changes[0].value.messages[0].text.body }}

B. Use a memória para acompanhar uma conversa

Em algum momento, você vai querer usar a memória para acompanhar uma conversa com um usuário. Os eventos de mensagem também incluem o número de telefone do usuário final; esse número é uma ótima chave para agrupar todas as mensagens

C. Acesse mídias enviadas pelos usuários

Talvez você queira processar imagens ou documentos enviados pelos usuários. Nesse caso, os eventos do webhook do WhatsApp geralmente incluem um ID de mídia do WhatsApp. Você pode buscar a mídia associada a esse ID usando a API de exibição de mídia