WHATSAPP n8n INTEGRATION: AUTOMATE WHATSAPP WITH N8N
WHATSAPP N8N INTEGRATION: AUTOMATE WHATSAPP WITH N8N
Need help automating Whatsapp with n8n?
Our team will get back to you in minutes.
Why automate Whatsapp with n8n?
The WhatsApp n8n integration gives you access to 1 powerful trigger and 6 versatile actions that cover the full spectrum of WhatsApp Business API capabilities. From monitoring incoming messages to sending templated communications and managing media assets, you have everything needed to build enterprise-grade messaging automations.
The benefits of automating WhatsApp with n8n are substantial. Significant time savings come first—no more manually sending follow-up messages or downloading media files one by one. Set up smart rules once, and let n8n handle the repetitive work 24/7. Improved responsiveness is another major advantage: trigger instant replies or notifications the moment a customer message arrives, ensuring no inquiry goes unanswered for hours. Zero oversight means the WhatsApp trigger monitors your business account continuously, and every incoming message, status update, or template change immediately fires your workflow without human intervention.
Here's what you can build with this integration: automatically send order confirmations when a purchase is completed in your e-commerce system, forward customer inquiries to your CRM and notify your sales team on Slack, download media files shared by customers and store them in Google Drive, or send appointment reminders using pre-approved templates. The WhatsApp n8n integration connects seamlessly to over 400 other applications in n8n, making it the central hub for all your conversational commerce workflows. For complex automation projects, our n8n Agency can help you build custom solutions.
How to connect Whatsapp to n8n?
! 1 stepHow to connect Whatsapp to n8n?
- 01
Add the node
The WhatsApp n8n integration uses OAuth authentication through the Facebook/Meta ecosystem. This means you'll authorize n8n to access your WhatsApp Business API account through a secure OAuth flow managed by Meta.Basic configuration:Create a Meta Business App: Head to the Meta for Developers portal and create a new app with WhatsApp product enabled. This is your gateway to the WhatsApp Business API.Configure WhatsApp in your Meta App: Add the WhatsApp product to your app and complete the required setup, including verifying your business and connecting a phone number.Add credentials in n8n: In your n8n workflow, click on any WhatsApp node and select "Create New" under credentials. Choose "WhatsApp OAuth account" as the credential type.Complete the OAuth flow: n8n will redirect you to Meta's authorization page. Log in with your Facebook account that has admin access to the business, review the permissions requested, and authorize the connection.Test the connection: Once authorized, n8n will confirm the connection is active. You can now use this credential across all your WhatsApp nodes.
TIP💡 TIP: Due to Facebook API limitations, only one WhatsApp trigger can be active per Facebook App. If you need multiple triggers for different event types, consider using a single trigger configured to listen to all relevant events, then use n8n's Switch or IF nodes to route the workflow accordingly. This constraint is important to keep in mind when designing your automation architecture.- 01
Need help automating Whatsapp with n8n?
Our team will get back to you in minutes.
Whatsapp triggers available in n8n
01 Trigger 01WhatsApp Trigger
The WhatsApp Trigger is your entry point for reactive automations—it monitors your WhatsApp Business account and fires your workflow instantly when specified events occur. This is the foundation for building customer service bots, lead capture systems, and real-time notification pipelines.
What makes this trigger particularly powerful is its flexibility. You can listen for incoming messages, template status changes, account updates, and much more—all from a single node. The trigger maintains a webhook connection to WhatsApp's servers, ensuring minimal latency between an event happening and your workflow executing.
Configuration parameters:
- Credential to connect with: This required dropdown lets you select your WhatsApp OAuth account credential. It handles all authentication with the WhatsApp Business API.
- Trigger On: This multi-select field is where the magic happens. You can choose from multiple event types to monitor simultaneously: Messages (fires when you receive a new message from a customer), Account Review Update (triggers when your business account review status changes), Account Update (monitors changes to your WhatsApp Business account settings), Business Capability Update (detects when new features are enabled or disabled), Message Template Status Update (alerts when a template is approved or rejected), Message Template Quality Update (notifies of template quality score changes), Phone Number Name Update (fires when your display name is updated), Phone Number Quality Update (monitors your phone number quality rating), Security (triggers on security-related events), and Template Category Update (detects template category changes).
Typical use cases: Customer service automation (trigger a workflow when a new message arrives, parse the content, and either respond automatically or create a ticket in your helpdesk), Lead capture (when a potential customer sends a first message, automatically add them to your CRM like HubSpot and notify your sales team), Template management (get instant Slack notifications when a template is approved or rejected, so your marketing team can react quickly), and Compliance monitoring (track account and security updates to ensure your WhatsApp integration remains compliant).
When to use it: Deploy the WhatsApp Trigger whenever you need real-time reactions to WhatsApp events. It's essential for customer-facing automations where response time matters, compliance monitoring where you can't afford to miss updates, and any workflow that should start based on WhatsApp activity rather than a schedule.

Whatsapp actions available in n8n
01 Action 01Send message
The Send message action is your go-to for programmatic WhatsApp communication. It allows you to send text messages to any WhatsApp user who has opted into receiving messages from your business—perfect for notifications, updates, and conversational responses.
Key parameters: Credential to connect with (required dropdown to select your authenticated WhatsApp account), Resource (set to "Message" to work with WhatsApp messages), Operation (set to "Send" to dispatch a message), Sender Phone Number (or ID) (optional text field to specify which business phone number sends the message, useful if you have multiple numbers), Recipient's Phone Number (required field where you enter the destination number including country code, e.g., +33612345678), Message Type (dropdown to select the content type—"Text" for plain text messages), Text Body (the actual message content you want to send), and Additional Fields (optional section for extra customization).
Use cases: Send order confirmation messages when a purchase is completed, notify customers about delivery status updates in real-time, and reply automatically to incoming inquiries during off-hours.

02 Action 02Send template
The Send template action lets you send pre-approved message templates through WhatsApp. Templates are required by WhatsApp's policy for initiating conversations with customers—they ensure compliance and enable business-initiated outreach for notifications, alerts, and marketing.
Key parameters: Credential to connect with (select your WhatsApp OAuth credentials), Resource (set to "Message" for messaging operations), Operation (set to "Send Template" to use a pre-approved template), Sender Phone Number (or ID) (specify the sending phone number), Recipient's Phone Number (the customer's phone number with country code), Template (enter the template name or ID as registered in your WhatsApp Business Manager), and Components (add dynamic components like text variables, headers, or media to personalize the template).
Use cases: Send appointment reminders with date/time variables filled dynamically, dispatch shipping notifications with tracking numbers, and send payment confirmation messages with order details.

03 Action 03Send message and wait for response
This powerful action combines sending a message with synchronous response handling. Your workflow pauses after sending and resumes only when the recipient replies—enabling true conversational automations and approval workflows directly in WhatsApp.
Key parameters: Credential to connect with (your WhatsApp account credentials), Sender Phone Number (or ID) (the business number sending the message), Recipient's Phone Number (where to send the message), Message (the text content of your outgoing message), Response Type (dropdown to define expected response format—"Approval" expects yes/no type responses), Approval Options (configure specific response options the recipient can choose from), and Options (additional configuration for timeout handling and advanced behaviors).
Use cases: Build approval workflows where managers confirm requests via WhatsApp, create interactive surveys that wait for each response before proceeding, and design chatbot conversations with branching logic based on user replies. You can also combine this with OpenAI integration to create intelligent conversational bots.

04 Action 04Upload media
The Upload media action enables you to upload files to WhatsApp's servers, making them available to send in messages. This is essential for sharing images, documents, videos, or audio files with your customers programmatically.
Key parameters: Credential to connect with (required authentication credential), Resource (set to "Media" for file operations), Operation (set to "Upload" to send files to WhatsApp), Sender Phone Number (or ID) (optional field to specify the associated phone number), Property Name (required text field specifying which data property contains the media file—default is "data"), and Additional Fields (optional configurations for advanced upload scenarios).
Use cases: Upload product images from your catalog to send in customer conversations, share PDF invoices or receipts automatically after purchases, and send audio messages or video tutorials to customers.

05 Action 05Download media
The Download media action retrieves media files that customers have shared with you via WhatsApp. When someone sends a photo, document, or voice message, you can automatically download it for processing, storage, or analysis.
Key parameters: Credential to connect with (select your WhatsApp authentication), Resource (set to "Media" for file operations), Operation (set to "Download" to retrieve files), and Media ID (required text field where you enter the unique identifier of the media to download—typically obtained from a preceding WhatsApp Trigger that captured an incoming message with media).
Use cases: Automatically save customer-submitted photos to Dropbox or cloud storage, process ID documents shared for verification workflows, and archive voice messages by transcribing and storing them.

06 Action 06Delete media
The Delete media action removes previously uploaded media from WhatsApp's servers. This is useful for cleaning up after automated processes, managing storage, or ensuring sensitive documents don't persist longer than necessary.
Key parameters: Credential to connect with (your WhatsApp account credentials), Resource (set to "Media" for file operations), Operation (set to "Delete" to remove the file), and Media ID (required field containing the unique identifier of the media to delete).
Use cases: Clean up temporary media after it's been processed and stored elsewhere, remove sensitive documents after a verification workflow completes, and implement data retention policies by deleting old media automatically. For troubleshooting workflow issues, check our n8n troubleshooting guide.

Build your first workflow with our team
Drop your email and we'll send you the catalog of automations you can ship today.
- Free n8n & Make scenarios to import
- Step-by-step setup docs
- Live cohort + community support
Frequently asked questions
Is the WhatsApp n8n integration free to use?
The n8n side of the integration is included with your n8n instance—whether you're using the free self-hosted version or n8n Cloud. However, WhatsApp Business API itself has associated costs. You'll need a Meta Business account with WhatsApp Business API access, which requires business verification. WhatsApp charges per conversation, with pricing varying by country and conversation type (user-initiated vs. business-initiated). Template messages for business-initiated conversations may have different rates than responses within the 24-hour customer service window. Check Meta's current pricing for your specific region and use case.Can I send messages to anyone with the WhatsApp n8n integration?
No, WhatsApp has strict policies to prevent spam. For business-initiated conversations (where you message the customer first), you must use pre-approved message templates, and the recipient must have opted in to receive messages from your business. For customer-initiated conversations, once a customer messages you, you have a 24-hour window to respond freely without templates. After that window closes, you'll need templates again. The n8n integration respects these policies—the Send template action is specifically designed for compliant business-initiated outreach.How long does it take to set up the WhatsApp n8n integration?
The technical setup in n8n takes about 5-10 minutes once your Meta Business App is ready. However, the Meta Business verification and WhatsApp Business API setup can take anywhere from a few hours to several days, depending on your business documentation and Meta's review queue. Plan for the full process to take 1-5 business days for new businesses. If you already have a verified Meta Business account with WhatsApp API access, connecting to n8n is nearly instant—just complete the OAuth flow and you're ready to automate.


