Automação de Mensagem de Boas-Vindas para Grupos de WhatsApp com a Evolution API - Fluxo de trabalho n8n

Gerentes de comunidade ou administradores que gerenciam grandes grupos de WhatsApp.
Usuários técnicos que precisam de uma forma confiável para automatizar o processo de integração (onboarding) de membros.
Desenvolvedores que utilizam a Evolution API para soluções de mensagens no WhatsApp.
Qualquer pessoa que procura templates n8n robustos para automação de comunicação instantânea.

Gerenciar grandes comunidades no WhatsApp exige um processo de integração eficiente. Dar as boas-vindas manualmente a cada novo membro pode ser demorado e inconsistente. Esta poderosa automação n8n resolve esse problema fornecendo uma solução imediata, personalizada e escalável.

Esta automação n8n utiliza a capacidade de webhook da Evolution API para capturar eventos do grupo instantaneamente. Ao centralizar todos os dados críticos de configuração (como ID do grupo, chaves de API e o conteúdo da mensagem) em um único nó n8n do tipo Set, o template n8n resultante fica incrivelmente fácil de manter e customizar. Além disso, a inclusão de um nó de atraso garante que a mensagem de boas-vindas seja entregue de forma natural, melhorando a experiência do usuário. Esta solução n8n de ponta a ponta garante que cada novo membro receba a atenção que merece, sem exigir intervenção manual.

Este fluxo de trabalho n8n abrangente opera inteiramente com base em lógica orientada a eventos:

1. Gatilho (Webhook Trigger): O processo começa com o gatilho Webhook do n8n, configurado para escutar requisições POST em um caminho específico (/whatsapp-group-welcome). Este URL deve ser configurado na sua instância da Evolution API para receber notificações de eventos do grupo.


2. Configuração das Variáveis: Os dados recebidos passam imediatamente pelo nó n8n 'Set Variables' (Definir Variáveis), que garante que as credenciais necessárias (Chave da API, nome da instância, ID do grupo de destino, mensagem de boas-vindas e tempo de espera desejado) estejam disponíveis para os nós subsequentes.


3. Filtragem do Grupo Alvo: Um nó Filter (Filtro) do n8n verifica se o ID do grupo do evento recebido corresponde ao groupId definido na configuração. Se os IDs dos grupos não coincidirem, a automação é interrompida, prevenindo ações irrelevantes.


4. Verificação de Novo Membro: Um nó If (Se) do n8n realiza uma verificação crucial, garantindo que a ação do grupo no payload seja exatamente 'add' (adicionar). Isso garante que o fluxo prossiga apenas quando um novo membro entra no grupo, ignorando ações como saída ou remoção de membros.


5. Adicionando Atraso Natural: O nó Wait (Aguardar) do n8n introduz um atraso configurável (em minutos) para evitar que a mensagem de boas-vindas seja enviada instantaneamente, fazendo a interação parecer mais autêntica e menos robótica.


6. Envio da Mensagem: Finalmente, um nó HTTP Request (Requisição HTTP) do n8n executa a ação principal. Ele constrói uma requisição POST para o endpoint da Evolution API, passando dinamicamente o número de WhatsApp do novo membro (extraído do payload do webhook) e a welcomeMessage personalizada como corpo. A chave de API necessária é incluída nos cabeçalhos (headers).

Para implementar este template de fluxo de trabalho n8n automatizado, siga estes passos:

1. Importar o Workflow n8n: Copie os dados JSON fornecidos e cole-os em sua instância n8n através da opção 'Import from JSON'.


2. Configurar o Gatilho Webhook: Ative o nó gatilho n8n 'Webhook - Receive Group Events' e copie o URL de teste ou de produção gerado.


3. Configuração na Evolution API: Configure o URL do webhook do n8n copiado dentro da sua instância da Evolution API para enviar notificações de eventos do grupo (especificamente eventos de entrada/saída de membros).


4. Nó Set Variables: Abra o nó n8n 'Set Variables - Configure Here' e atualize os seguintes valores com as especificações do seu ambiente:

1. Ativar: Salve e ative o fluxo de trabalho n8n. Teste adicionando um novo usuário ao grupo de WhatsApp alvo.

A funcionalidade deste fluxo de trabalho n8n depende dos seguintes nós principais:

Webhook n8n Trigger:
Função: Serve como ponto de partida, escutando notificações de eventos de grupo vindas da Evolution API via requisição POST.
Configuração Chave: Caminho definido como /whatsapp-group-welcome.
Set n8n Node (Set Variables - Configure Here):
Função: Centraliza todos os parâmetros de configuração necessários (credenciais de API, URLs, ID do Grupo, conteúdo da mensagem) para facilitar o gerenciamento em toda a automação n8n.
Filter n8n Node (Filter - Check if Target Group):
Função: Garante que o evento recebido pertença exclusivamente ao ID do grupo de WhatsApp alvo designado, definido nas variáveis de configuração.
If n8n Node (If - New Member Joined):
Função: Direciona o fluxo somente se a ação do evento for 'add' (adicionar), confirmando que um novo membro entrou no grupo.
Wait n8n Node (Wait - Natural Delay):
Função: Interrompe a execução por um número dinâmico e configurável de minutos, melhorando a autenticidade percebida da entrega da mensagem de boas-vindas automatizada.
HTTP Request n8n Node (Send Welcome Message):
* Função: Executa a ação final, enviando uma mensagem de texto privada para o novo membro através da Evolution API, usando dados dinâmicos para o número do destinatário e incluindo a chave de API necessária como cabeçalho.