Docs/WhatsApp Cloud API

Official Meta WhatsApp API & Anti-Ban Guide

Connect your business phone number to Meta's Official Cloud API v21.0. Learn how to generate permanent tokens, configure webhooks, maintain a Green Quality Rating, and send campaigns without risk of number bans.

Zero Risk of Bans With Official Meta Cloud API

Unlike unofficial tools (such as Baileys, Puppeteer, or QR scan web-wrappers) that WhatsApp actively detects and blocks, Vridhi AI uses 100% Official Meta Graph API v21.0. Meta never bans phone numbers for connecting via their official developer APIs.

1. What You Need Before You Start

To connect your WhatsApp number to Vridhi AI, you need access to the Meta Developer Portal and your Meta Business Manager. You will need 3 key values:

Phone Number IDNumeric ID identifying your WhatsApp phone number.
WABA IDWhatsApp Business Account ID that owns the number.
Permanent TokenSystem User Access Token that never expires after 24 hours.

2. Step-by-Step Connection Instructions

1Create a Meta App

  1. Go to developers.facebook.com and log in.
  2. Click My Apps > Create App.
  3. Select Other > Business as your app type and click Next.
  4. Enter an App Name (e.g. "My Company WhatsApp") and select your Meta Business Account.

2Add WhatsApp Product & Copy IDs

  1. In your app dashboard sidebar, find WhatsApp and click Set Up.
  2. Go to WhatsApp > API Setup.
  3. Here you will see your Phone Number ID and WhatsApp Business Account ID.
  4. Copy both IDs and paste them into Vridhi AI at Settings > WhatsApp.

3Generate a Permanent Access Token (Crucial)

Never Use the Temporary 24-Hour Token

The access token shown on the "API Setup" page is only valid for 24 hours. If you paste that, your campaigns will stop working tomorrow! Always create a System User Token as follows:

  1. Open Meta Business Settings > System Users .
  2. Click Add to create a new System User (Name: "Vridhi Integration", Role: Admin).
  3. Click Add Assets, select your WhatsApp App, and give it Full Control.
  4. Click Generate New Token.
  5. Select your app, set token expiration to Never, and check these 2 permissions:
    • whatsapp_business_messaging
    • whatsapp_business_management
  6. Click Generate Token, copy the string (starts with EAA...) and paste it into Vridhi's Permanent Access Token field.

4Configure Webhooks (For Inbound Customer Replies)

  1. In Meta App Dashboard, go to WhatsApp > Configuration.
  2. Under Webhook, click Edit.
  3. Paste the Callback URL shown on your Vridhi WhatsApp Settings page (e.g. https://tryvridhi.com/api/whatsapp/webhook).
  4. Paste the Custom Verify Token you created in Vridhi.
  5. Click Verify and Save.
  6. Under Webhook fields, click Manage and click Subscribe for messages.

3. The 4 Commandments to Never Get Blocked

1. Template-First Outbound

When messaging a new lead who hasn't texted you, always use a Meta-Approved Message Template. Never blast unapproved promotional messages.

2. 24-Hour Service Window

Once a lead replies, you unlock 24 hours of free-form conversation. You can send dynamic text, images, and AI responses without template constraints.

3. Opt-Out (STOP Rule)

Always include a brief opt-out note: "Reply STOP to unsubscribe". When contacts opt out peacefully, they don't click WhatsApp's "Report / Spam" button.

4. Phone Warming

For brand new numbers, start by sending 50-100 messages/day in week 1. Once your quality rating stays GREEN, scale to 500-1,000/day.

4. Daily Limits & Official Pricing (India)

CategoryDaily LimitCost (India INR)Description
Service (Inbound)UnlimitedFirst 1,000 FREE/moCustomer support replies & AI chat
Utility / Transactional1,000 - 100,000+~₹0.11 - ₹0.15Order confirmations, reminders, invoices
Marketing (Outbound)1,000 - 100,000+~₹0.85 - ₹0.88Cold lead campaigns, promotional offers
← Back to Documentation HubOpen WhatsApp Settings