Como configurar Evolution API + n8n em VPS para WhatsApp Business | Tutoriais Toda Solução

Introdução

Integrar o WhatsApp Business com ferramentas de automação pode otimizar a comunicação da sua empresa, melhorando a eficiência e a agilidade no atendimento ao cliente. Neste tutorial, vamos guiá-lo na configuração da Evolution API e do n8n em sua VPS, permitindo que você crie fluxos de trabalho automatizados para gerenciar mensagens do WhatsApp de forma prática e eficiente.

A Evolution API fornece uma interface robusta para interagir com a plataforma do WhatsApp Business, enquanto o n8n é uma ferramenta de automação de fluxo de trabalho que permite conectar diferentes aplicativos e serviços sem a necessidade de programação avançada.

Ao final deste guia, você terá uma solução integrada que permitirá o envio e recebimento de mensagens pelo WhatsApp Business, facilitando o gerenciamento de interações com seus clientes.

Pré-requisitos

Antes de iniciar a configuração do Evolution API e do n8n em sua VPS, é importante garantir que você possui os seguintes pré-requisitos:

node -v
npm -v

docker -v

1. VPS com Linux: Certifique-se de que você tem uma VPS com um sistema operacional Linux (Ubuntu, Debian, CentOS, etc.) e acesso root ou permissões sudo.
2. Node.js e npm: O n8n requer Node.js. Instale-o junto com o npm (gerenciador de pacotes do Node.js). Você pode verificar se já estão instalados utilizando os comandos:
3. Docker: O n8n pode ser executado via Docker. Instale o Docker em sua VPS. Para verificar a instalação, use:
4. Conta no WhatsApp Business: É necessário ter uma conta no WhatsApp Business e acesso à Evolution API. Siga as instruções da documentação oficial da Evolution para obter as credenciais necessárias.
5. Conhecimentos básicos de terminal: Familiaridade com comandos de terminal é essencial para a execução das etapas de instalação e configuração.

Certifique-se de atender a todos os pré-requisitos antes de prosseguir para a instalação do n8n.

Instalação do n8n

Para instalar o n8n em sua VPS, siga os passos abaixo:

ssh usuario@ip-da-vps

sudo apt update && sudo apt upgrade -y

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
source ~/.bashrc
nvm install node

node -v
npm -v

npm install n8n -g

n8n start

1. Conecte-se à sua VPS via SSH:
2. Atualize os pacotes do sistema:
3. Instale o Node.js e o npm. É recomendado usar o Node Version Manager (nvm) para gerenciar versões:
4. Verifique a instalação do Node.js e npm:
5. Instale o n8n globalmente usando npm:
6. Após a instalação, você pode iniciar o n8n com o seguinte comando:

O n8n estará acessível no seu navegador através do endereço http://ip-da-vps:5678. Certifique-se de que a porta 5678 esteja liberada no firewall da sua VPS.

Configuração da Evolution API

Para configurar a Evolution API, siga os passos abaixo:

1. Acesse o painel da Evolution API e faça login na sua conta.
2. No menu principal, vá até a seção Configurações.
3. Clique em Gerar Token de Acesso para criar um novo token. Guarde este token, pois ele será necessário para autenticar suas requisições.
4. Na mesma seção, configure as Webhooks para receber notificações sobre eventos do WhatsApp. Insira a URL do seu n8n, que deve estar acessível publicamente, como por exemplo: https://seu-dominio.com/webhook.
5. Defina os eventos que você deseja monitorar, como mensagens recebidas e status de entrega.
6. Salve as configurações e teste a conexão com o n8n, enviando uma mensagem de teste pelo WhatsApp.

Certifique-se de que a URL do webhook esteja acessível e que o n8n esteja rodando, caso contrário, as notificações não serão recebidas.

Integração com WhatsApp

Após configurar a Evolution API, o próximo passo é integrar o WhatsApp Business ao n8n. Siga os passos abaixo:

1. Acesse a interface do n8n em seu navegador.
2. Clique em “Workflows” no menu lateral e depois em “Create New” para iniciar um novo fluxo de trabalho.
3. Adicione um novo nó clicando em “+” e procure por HTTP Request.
4. Configure o nó da seguinte maneira:

   {
       "to": "NUMERO_DESTINO",
       "type": "text",
       "text": {
           "body": "Sua mensagem aqui"
       }
   }

   • Method: POST
   • URL: https://api.evolution.com.br/v1/messages
   • Headers:
     • Authorization: Bearer SEU_TOKEN_DE_AUTENTICAÇÃO
     • Content-Type: application/json
   • Body: Utilize o formato JSON para enviar a mensagem, por exemplo:
   • Salve o nó e conecte-o ao nó de gatilho que você configurou anteriormente.
5. Teste o fluxo de trabalho clicando em “Execute Workflow” e verifique se a mensagem foi enviada com sucesso.

Após seguir esses passos, você terá integrado com sucesso o WhatsApp Business ao n8n utilizando a Evolution API.

Verificação

Após a configuração da Evolution API e do n8n, é crucial realizar uma verificação para garantir que tudo está funcionando corretamente. Siga os passos abaixo:

1. Acesse o painel do n8n em seu navegador, utilizando o endereço configurado durante a instalação.
2. Crie um novo fluxo de trabalho que utilize a Evolution API como gatilho.
3. Adicione um nó para enviar uma mensagem via WhatsApp. Configure o nó com os parâmetros necessários, como o número de telefone do destinatário e a mensagem.
4. Salve o fluxo e ative-o.
5. Verifique se o fluxo está sendo executado corretamente. No painel do n8n, você pode monitorar a execução dos nós.

Se a mensagem for enviada com sucesso, você verá a confirmação no painel do n8n e no WhatsApp do destinatário. Caso contrário, verifique os logs de execução para identificar possíveis erros e faça os ajustes necessários.

Para uma verificação mais detalhada, você pode testar a API diretamente usando ferramentas como Postman ou curl. Execute o seguinte comando para testar o envio de uma mensagem:

curl -X POST https://sua-evolution-api-url/send \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{"to": "NUMERO_DESTINATARIO", "message": "Sua mensagem aqui"}'

Se a resposta for positiva, sua integração está funcionando corretamente!

Conclusão

Parabéns! Você configurou com sucesso a Evolution API e o n8n em sua VPS para integrar o WhatsApp Business. Essa configuração permite automatizar processos e melhorar a comunicação com seus clientes de forma eficaz.

Para garantir que tudo funcione corretamente, é importante:

1. Monitorar regularmente as mensagens e interações no WhatsApp Business.
2. Verificar se as integrações estão operando sem falhas.
3. Atualizar o n8n e a Evolution API conforme novas versões forem lançadas.

Se você encontrar problemas, consulte os logs do n8n para identificar possíveis erros. Além disso, considere a documentação oficial da Evolution API e do n8n para obter mais informações sobre recursos e soluções de problemas.

Com essa configuração, você está pronto para explorar novas automações e melhorar a eficiência do seu negócio. Boa sorte!