WhatsApp Group Welcome Message Automation with Evolution API - n8n Workflow

Community managers or administrators running large WhatsApp groups.
Technical users needing a reliable way to automate member onboarding.
Developers utilizing the Evolution API for WhatsApp messaging solutions.
Anyone looking for robust n8n templates for instant communication automation.

Managing large WhatsApp communities requires efficient onboarding. Manually welcoming every new member can be time-consuming and inconsistent. This powerful n8n workflow solves this problem by providing an immediate, personalized, and scalable solution.

This n8n automation utilizes the Evolution API's webhook capability to instantly capture group events. By centralizing all critical configuration data (like group ID, API keys, and the message content) into a single Set n8n node, the resulting n8n template is incredibly easy to maintain and customize. Furthermore, the inclusion of a delay node ensures the welcome message is delivered naturally, enhancing the user experience. This end-to-end n8n solution ensures every new member receives the attention they deserve without requiring manual intervention.

This comprehensive n8n workflow operates entirely on event-driven logic:

1. Webhook Trigger: The process begins with the Webhook n8n trigger, configured to listen for POST requests at a specific path (/whatsapp-group-welcome). This URL must be configured within your Evolution API instance to receive group event notifications.


2. Configuration Setup: The incoming data immediately passes through the 'Set Variables' n8n node, which ensures the necessary credentials (API Key, instance name, target group ID, welcome message, and desired wait time) are available for subsequent nodes.


3. Target Group Filtering: A Filter n8n node checks if the incoming event's group ID matches the groupId set in the configuration. If the group IDs do not match, the automation stops, preventing irrelevant actions.


4. New Member Verification: An If n8n node performs a crucial check, verifying that the group action in the payload is exactly 'add'. This guarantees the workflow only proceeds when a new member joins, ignoring actions like members leaving or being removed.


5. Adding Natural Delay: The Wait n8n node introduces a configurable delay (in minutes) to prevent the welcome message from being sent instantaneously, making the interaction feel more authentic and less robotic.


6. Sending the Message: Finally, an HTTP Request n8n node executes the core action. It constructs a POST request to the Evolution API endpoint, dynamically passing the new member's WhatsApp number (extracted from the webhook payload) and the personalized welcomeMessage as the body. The required API key is included in the headers.

To deploy this automated n8n workflow template, follow these steps:

1. Import the n8n Workflow: Copy the provided JSON data and paste it into your n8n instance via the 'Import from JSON' option.


2. Configure the Webhook Trigger: Activate the 'Webhook - Receive Group Events' n8n trigger node and copy the generated test or production URL.


3. Evolution API Setup: Configure the copied n8n webhook URL within your Evolution API instance to send group event notifications (specifically member join/leave events).


4. Set Variables Node: Open the 'Set Variables - Configure Here' n8n node and update the following values with your environment specifics:

1. Activate: Save and activate the n8n workflow. Test by having a new user join the target WhatsApp group.

The functionality of this n8n workflow relies on the following key nodes:

Webhook n8n Trigger:
Function: Serves as the starting point, listening for group event notifications from the Evolution API via a POST request.
Key Configuration: Path set to /whatsapp-group-welcome.
Set n8n Node (Set Variables - Configure Here):
Function: Centralizes all necessary configuration parameters (API credentials, URLs, Group ID, message content) for easy management throughout the n8n automation.
Filter n8n Node (Filter - Check if Target Group):
Function: Ensures the incoming event belongs exclusively to the designated target WhatsApp group ID defined in the configuration variables.
If n8n Node (If - New Member Joined):
Function: Directs the flow only if the event action is 'add', confirming a new member has joined the group.
Wait n8n Node (Wait - Natural Delay):
Function: Pauses the execution for a dynamic, configurable number of minutes, improving the perceived authenticity of the automated welcome message delivery.
HTTP Request n8n Node (Send Welcome Message):
* Function: Executes the final action, sending a private text message to the new member via the Evolution API, using dynamic data for the recipient's number and including the required API key as a header.