WhatsApp + Evolution API: welcome every new member
New people join your WhatsApp group… and then nothing happens. Maybe an admin is busy. Maybe the “welcome” message gets buried. Either way, your first impression slips through the cracks.
This WhatsApp welcome automation hits community managers first, but business owners running customer groups and ops leads supporting internal channels feel it too. A private hello, sent automatically, keeps onboarding consistent without someone babysitting the group all day.
This workflow listens for join events, checks they’re for the right group, waits a natural delay, then sends a direct welcome message via Evolution API. You’ll see how it works, what you need, and where teams typically customize it.
How This Automation Works
The full n8n workflow, from trigger to final output:
n8n Workflow Template: WhatsApp + Evolution API: welcome every new member
flowchart LR
subgraph sg0["Flow 1"]
direction LR
n0["<div style='background:#f5f5f5;padding:10px;border-radius:8px;display:inline-block;border:1px solid #e0e0e0'><img src='https://flowpast.com/wp-content/uploads/n8n-workflow-icons/webhook.dark.svg' width='40' height='40' /></div><br/>Incoming Group Event Hook"]
n1@{ icon: "mdi:swap-vertical", form: "rounded", label: "Define Configuration Values", pos: "b", h: 48 }
n2@{ icon: "mdi:swap-horizontal", form: "rounded", label: "Filter Target Group", pos: "b", h: 48 }
n3@{ icon: "mdi:swap-horizontal", form: "rounded", label: "Confirm New Joiner", pos: "b", h: 48 }
n4@{ icon: "mdi:cog", form: "rounded", label: "Delay for Natural Timing", pos: "b", h: 48 }
n5["<div style='background:#f5f5f5;padding:10px;border-radius:8px;display:inline-block;border:1px solid #e0e0e0'><img src='https://flowpast.com/wp-content/uploads/n8n-workflow-icons/httprequest.dark.svg' width='40' height='40' /></div><br/>Dispatch Welcome Text"]
n4 --> n5
n3 --> n4
n2 --> n3
n1 --> n2
n0 --> n1
end
%% Styling
classDef trigger fill:#e8f5e9,stroke:#388e3c,stroke-width:2px
classDef ai fill:#e3f2fd,stroke:#1976d2,stroke-width:2px
classDef aiModel fill:#e8eaf6,stroke:#3f51b5,stroke-width:2px
classDef decision fill:#fff8e1,stroke:#f9a825,stroke-width:2px
classDef database fill:#fce4ec,stroke:#c2185b,stroke-width:2px
classDef api fill:#fff3e0,stroke:#e65100,stroke-width:2px
classDef code fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px
classDef disabled stroke-dasharray: 5 5,opacity: 0.5
class n2,n3 decision
class n0,n5 api
classDef customIcon fill:none,stroke:none
class n0,n5 customIcon
The Problem: New members join, and nobody follows up
Most WhatsApp groups grow in little bursts. A campaign goes out, a partner mentions you, someone shares an invite link, and suddenly you have 10 new names in the participant list. Then the messy part starts. Admins assume someone else will greet them, or they plan to do it later, then it’s three hours and 200 messages down the timeline. New members don’t know where to start, they hesitate to post, and your group quietly feels colder than it should.
It adds up fast. Not because any single welcome is hard, but because the manual process is fragile.
- Admins end up scanning join notifications and copying numbers into a private chat, which is slow and easy to miss.
- Greeting people publicly in the group clutters the feed, so you avoid it, and the new member gets nothing.
- When you do remember, the welcome text varies every time, which means inconsistent expectations and more repetitive questions later.
- If two people join close together, it’s common to message one and forget the other.
The Solution: Auto-DM every new joiner (with a human-feeling delay)
This n8n workflow gives you a reliable “first touch” the moment someone joins your WhatsApp group. It starts when Evolution API sends a real-time group event to your n8n webhook. The workflow then loads your saved configuration (group ID, message text, Evolution instance details), filters the event so only your chosen group triggers a response, and confirms the event is a join (not someone leaving). Next, it waits for a natural delay you control, so the message doesn’t look like an instant bot blast. Finally, it sends a private welcome message to the new member’s direct chat via Evolution API. Hands-off. Consistent. Always on.
The workflow begins with a webhook notification from Evolution API. Then n8n checks the group ID and the event type, waits a few minutes, and dispatches your welcome text to the member privately. No manual searching. No “oops, missed them.”
What You Get: Automation vs. Results
| What This Workflow Automates | Results You’ll Get |
|---|---|
|
|
Example: What This Looks Like
Say your group adds about 20 new members a week. Manually, welcoming someone usually means noticing the join, opening a private chat, pasting a message, and answering the first follow-up, which is often about 10 minutes per person. That’s around 3 hours a week. With this workflow, the “work” is basically zero: the webhook triggers instantly, you wait about 3 minutes for natural timing, and the DM sends automatically. You get those hours back, and the welcome is consistent every time.
What You’ll Need
- n8n instance (try n8n Cloud free)
- Self-hosting option if you prefer (Hostinger works well)
- Evolution API instance to send WhatsApp events and messages
- WhatsApp Business account connected through Evolution API
- Evolution API key (get it from your Evolution API dashboard)
Skill level: Beginner. You’ll paste values into a “Set Variables” node and connect your Evolution API webhook.
Don’t want to set this up yourself? Talk to an automation expert (free 15-minute consultation).
How It Works
A group event hits your webhook. Evolution API sends a real-time notification to n8n when someone joins or leaves your WhatsApp group.
Your settings load instantly. n8n pulls in your saved configuration values like the target group ID (the one ending in @g.us), your Evolution API URL, your instance name, and your welcome message.
Only real “new member” events continue. The workflow filters for your chosen group and checks the event type so you don’t accidentally DM people who left, rejoined, or triggered a different group’s event.
A short delay makes it feel human. After waiting the number of minutes you set, n8n sends the welcome text via an HTTP request to Evolution API, which then delivers it as a private WhatsApp message.
You can easily modify the welcome message to include rules, links, or a “reply with 1/2/3” prompt based on your needs. See the full implementation guide below for customization options.
Step-by-Step Implementation Guide
Step 1: Configure the Webhook Trigger
Set up the inbound webhook so your workflow starts when a group event is posted.
- Add and configure Incoming Group Event Hook as the trigger.
- Set HTTP Method to
POST. - Set Path to
whatsapp-group-welcome. - Copy the webhook URL generated by Incoming Group Event Hook and configure your group event source to call it.
Step 2: Connect Configuration Values
Define the target group, API details, and the welcome message used downstream.
- Open Define Configuration Values and add the assignments exactly as needed for your environment.
- Set groupId to your target group identifier, replacing
[YOUR_EMAIL]. - Set apiKey to your Evolution API key, replacing
[CONFIGURE_YOUR_API_KEY]. - Set instanceName to
YourInstanceNameor your actual instance name. - Set evolutionApiUrl to
https://your-evolution-api.com. - Set welcomeMessage to your desired text, such as
👋 Welcome to our community! .... - Set waitMinutes to
1or your preferred delay.
[YOUR_EMAIL] or [CONFIGURE_YOUR_API_KEY] will prevent matching and API authentication.Step 3: Set Up Filtering and Joiner Validation
Ensure only the correct group and join events pass through.
- In Filter Target Group, set the condition Left Value to
{{ $json.body.data.id }}and Right Value to{{ $('Define Configuration Values').item.json.groupId }}. - In Confirm New Joiner, set the condition Left Value to
{{ $json.body.data.action }}and Right Value toadd. - Verify the execution flow is Incoming Group Event Hook → Define Configuration Values → Filter Target Group → Confirm New Joiner.
Step 4: Configure Delay and Welcome Message Dispatch
Add a natural delay and send the welcome message via the Evolution API.
- In Delay for Natural Timing, set Unit to
minutesand Amount to{{ $('Define Configuration Values').item.json.waitMinutes }}. - In Dispatch Welcome Text, set URL to
{{ $('Define Configuration Values').item.json.evolutionApiUrl }}/message/sendText/{{ $('Define Configuration Values').item.json.instanceName }}. - Set Method to
POSTand enable Send Body and Send Headers. - Add body parameters: number =
{{ $json.body.data.participants[0] }}and text ={{ $('Define Configuration Values').item.json.welcomeMessage }}. - Add header parameter: apikey =
{{ $('Define Configuration Values').item.json.apiKey }}. - Confirm the flow from Confirm New Joiner → Delay for Natural Timing → Dispatch Welcome Text.
Step 5: Test and Activate Your Workflow
Validate the end-to-end flow and then switch the workflow to active.
- Use Incoming Group Event Hook to send a test POST payload that includes
body.data.id,body.data.action, andbody.data.participants[0]. - Run the workflow manually and confirm that the event passes Filter Target Group and Confirm New Joiner before reaching Delay for Natural Timing.
- Verify Dispatch Welcome Text sends the message to the participant number and returns a successful response from your Evolution API.
- Click Activate to enable the workflow for live group events.
Common Gotchas
- Evolution API credentials can expire or need specific permissions. If things break, check your Evolution API dashboard (API key and instance status) first.
- If you’re using Wait nodes or external processing, timing varies. Bump up the delay if your send-message request fails because the member data isn’t available yet.
- Default welcome text is usually too generic. Add your group’s purpose, one clear next step, and any rules up front or you will keep answering the same questions.
Frequently Asked Questions
About 30 minutes if your Evolution API instance is already running.
No. You’ll paste your group ID and Evolution API details into n8n, then connect the webhook.
Yes. n8n has a free self-hosted option and a free trial on n8n Cloud. Cloud plans start at $20/month for higher volume. You’ll also need to factor in Evolution API hosting costs (your own server or a hosted Evolution provider).
Two options: n8n Cloud (managed, easiest setup) or self-hosting on a VPS. For self-hosting, Hostinger VPS is affordable and handles n8n well. Self-hosting gives you unlimited executions but requires basic server management.
Yes, but you’ll usually duplicate the workflow and change the group ID in the “Define Configuration Values” node for each group. Some teams also tweak the “Confirm New Joiner” check to handle special cases like re-joins. Common customizations include different welcome text per group, a longer or shorter delay in “Delay for Natural Timing,” and adding extra HTTP requests for a follow-up sequence.
Most of the time it’s an API key or instance name mismatch in “Define Configuration Values.” Double-check the Evolution API base URL as well, because a missing path or wrong protocol will cause silent failures. If it worked yesterday and fails today, your instance may have restarted and the credential needs updating in n8n.
A typical small-business setup handles hundreds of joins a day without issues, and self-hosting removes execution caps entirely (your server becomes the limit).
Usually, yes, because WhatsApp via Evolution API tends to require webhook handling, filtering logic, and custom HTTP requests that n8n is comfortable with. You also get self-hosting, which is handy if your community grows and you don’t want every join to become a billable “task.” Zapier and Make can still work if you prefer a simpler UI and your setup is very basic, but you may hit limits faster. Frankly, the best choice depends on how many groups you run and whether you want to add follow-ups later. Talk to an automation expert if you’re not sure which fits.
Once this is live, every new member gets welcomed the same way, every time, without you hovering over the participant list. Set it up once, then let the group grow.
Need Help Setting This Up?
Our automation experts can build and customize this workflow for your specific needs. Free 15-minute consultation—no commitment required.
