This repository is part of the ForgeMindAI YouTube channel, where we explore practical AI automation tools and workflows. This project demonstrates how to build a WhatsApp Bulk Message Agent using n8n and the official WhatsApp Business Cloud API.
This project is built entirely on the official Meta WhatsApp Business Cloud API. We strongly recommend against using unofficial or third-party WhatsApp libraries, browser-based automation tools, or reverse-engineered APIs. Here's why:
- Compliance - The official Cloud API is the only Meta-approved method for sending business messages at scale. Unofficial tools violate WhatsApp's Terms of Service and put your number at risk of being permanently banned.
- Reliability - The Cloud API is maintained by Meta, with guaranteed uptime, versioned endpoints, and production-grade infrastructure.
- Security - Messages sent through the Cloud API are end-to-end encrypted and handled through Meta's secure infrastructure, protecting both your business and your customers.
- Scalability - The Cloud API is designed for high-throughput messaging and supports rate limits appropriate for business use cases.
If your business already uses the WhatsApp Business On-Premise API and wants to migrate to or run the Cloud API in parallel, Meta provides the Coexistence feature. Coexistence allows you to use both the On-Premise and Cloud APIs simultaneously on the same WhatsApp Business phone number during a transition period.
-
Official Meta Tech Partner Required - You must work with a verified Meta Business Partner (also known as a Meta Tech Provider or BSP) to enable coexistence on your account. This cannot be self-served. The Tech Partner handles provisioning, configuration, and onboarding of your number onto the coexistence setup.
-
Number Onboarding - Your WhatsApp Business phone number must be properly onboarded through the Tech Partner. This involves registering the number with the Cloud API while maintaining the existing On-Premise connection. The Tech Partner manages this process end-to-end, including verification and approval from Meta.
-
Migration Planning - Coexistence is intended as a transitional state. Work with your Tech Partner to plan a clear timeline for fully migrating to the Cloud API.
ForgeMind AI is an official, verified Meta Tech Partner. We specialize in helping businesses get up and running with the WhatsApp Business Cloud API and Coexistence API. Our services include:
- Coexistence API Access - We can provision and enable the Coexistence API for your business, allowing you to run Cloud API alongside your existing On-Premise setup.
- Number Onboarding - We handle the full onboarding process for your WhatsApp Business numbers, including registration, verification, and Meta approval.
- Cloud API Migration - We guide your business through a smooth transition from On-Premise to the Cloud API with zero downtime.
- Bulk Messaging Setup - We help you configure compliant, high-volume messaging workflows using approved message templates and best practices.
- Ongoing Support - From quality rating management to scaling your messaging tiers, we provide hands-on support to keep your operations running smoothly.
Ready to get started? Reach out to us directly:
- Email: forgemind.business@gmail.com
- YouTube: ForgeMindAI
- Instagram: forgemind_ai
- Contact Number: +91 9342245724
Sending bulk messages through WhatsApp requires strict adherence to Meta's policies. Failure to follow these guidelines can result in rate limits, quality rating drops, or permanent bans.
- All business-initiated conversations must use pre-approved Message Templates. You cannot send free-form text to users who have not messaged you in the last 24 hours.
- Templates must be submitted for review and approved by Meta before use.
- Templates must be clear, non-misleading, and relevant to the recipient.
- You must obtain explicit opt-in consent from recipients before sending them messages. This is a Meta policy requirement, not optional.
- The opt-in must clearly state that the user is agreeing to receive messages from your business via WhatsApp.
- Maintain records of opt-in consent for compliance purposes.
- Meta assigns a quality rating to your phone number based on user feedback (blocks, reports). A low quality rating will reduce your messaging limits.
- New numbers start with a lower messaging tier (typically 250 business-initiated conversations per 24 hours) and can scale up to 1K, 10K, 100K, and unlimited tiers as quality is maintained.
- Monitor your quality rating and messaging limits in the WhatsApp Manager dashboard regularly.
- Do not send spam, unsolicited promotions, or irrelevant content.
- Respect user preferences - if a user asks to stop receiving messages, honor that immediately.
- Messages must comply with Meta's WhatsApp Business Policy and Commerce Policy.
- Avoid sending messages at unreasonable hours in the recipient's timezone.
- Do not send excessive messages in a short time window, even to opted-in users.
- Space out bulk campaigns to avoid triggering rate limits and to maintain a healthy quality rating.
- A pre-built n8n workflow for bulk WhatsApp messaging using the official Cloud API
- Easy-to-follow instructions and video walkthroughs
Check out the full tutorial on the ForgeMindAI YouTube channel: YouTube Link Here
- Go to the 3 dots in the top right corner after creating a workflow.
- Select "Import from file" and select the workflow JSON file.
For any queries on this repo, reach out on the following social handles:
- YouTube: https://www.youtube.com/@forgemindai
- Instagram: https://www.instagram.com/forgemind_ai/reels/
If you like this repo, star it and follow us for more exciting public repos.