M
MANZA Docs
← WhatsApp HubOpen Dashboard
Official WhatsApp Cloud API• Updated September 2026

Complete Meta Cloud API Setup Manual

This manual guides you through connecting your WhatsApp Business account directly to MANZA using Meta’s official Cloud API console. Follow these 6 steps to unlock live two-way customer messaging, bulk broadcast scheduling, and real-time CRM synchronization.

In this comprehensive guide:
  1. Step 1: Creating a Meta App (App Details & Use Cases)
  2. Step 2: Registering a Phone Number & Adding Payment Methods
  3. Step 3: Finding Phone Number ID & WABA ID
  4. Step 4: Generating Non-Expiring System User Admin Tokens
  5. Step 5: Webhook Configuration & Subscribing to Messages
  6. Step 6: Avoiding Number Conflicts with Other BSPs
1

Creating a Meta App (App Details & Use Cases)

Log in to the Meta for Developers Portal with your Facebook account.

  1. Click the green "Create App" button in the top-right corner.
  2. When asked what you want your app to do, select "Other" → "Business" (or select the direct use case: "Connect with customers through WhatsApp").
  3. Assign your verified Meta Business Portfolio (Business Account).
  4. Provide an app display name (e.g., MyCompany WhatsApp Engine) and click "Create app".
2

Registering a Phone Number & Adding Payment Methods

In your Meta App Dashboard sidebar, navigate to Use cases > Customize (or WhatsApp > API Setup):

Part A: Add Payment Method for Meta Broadcasts

Scroll down to "Step 6: Set up a payment method" and click "Add payment method". Meta provides 1,000 free service conversations per month, but marketing broadcasts and utility HSM templates require a valid credit card on file in Meta Business Suite.

Part B: Add & Verify Your Dedicated Business Phone Number

  1. Scroll to "Step 5: Add a phone number" and click "Add phone number".
  2. Enter your official Business Display Name (must match your brand or legal business entity).
  3. Select your Business Category and Timezone.
  4. Enter your phone number and complete 6-digit SMS or Voice OTP verification.
⚠️ Critical Mobile WhatsApp Requirement:

A phone number registered on the Cloud API cannot be actively linked to WhatsApp or WhatsApp Business on a mobile phone. If you are migrating an existing number from your phone, you must first open WhatsApp on your phone, go to Settings > Account > Delete Account, and then proceed with registration.

3

Finding Phone Number ID & WABA ID

Stay on the API Setup screen. Under "Step 1: Select phone numbers":

  • In the "From" dropdown, pick your newly registered business phone number (do not select the test dummy number).
  • Copy the numeric Phone number ID (e.g. 109283746192834).
  • Directly below it, copy the numeric WhatsApp Business account ID (WABA ID).
4

Generating Non-Expiring System User Admin Tokens

Temporary tokens on the API Setup page expire in 24 hours. To ensure uninterrupted production delivery for live chat and scheduled broadcasts, generate a permanent System User token:

  1. Open Meta Business Settings > Users > System Users.
  2. Click "Add". Create a System User named MANZA Cloud API with System User Role set to Admin.
  3. Click "Assign Assets":
    • Under Apps: Select your WhatsApp App → toggle Full Control (Manage App).
    • Under WhatsApp Accounts: Select your WABA account → toggle Full Control (Manage WhatsApp Business Account).
    • Click Save Changes.
  4. Click "Generate New Token", select your App, and set Token Expiration: Never.
  5. Check these two required permission scopes:
    ✔ whatsapp_business_messaging
    ✔ whatsapp_business_management
  6. Copy the token string and paste it into MANZA as the System User Permanent Access Token.
5

Webhook Configuration & Subscribing to Messages

To receive inbound replies and delivery ticks (Sent, Delivered, Read) in real time:

  1. In Meta Developer Console, navigate to WhatsApp > Configuration.
  2. In the Webhook card, click "Edit":
    Callback URL: https://app.manza.in/api/webhooks/whatsapp
    Verify token: manza_meta_verify_2026
  3. Click "Verify and save". Meta will perform a live verification handshake.
  4. Under Webhook fields, click "Manage" and click "Subscribe" next to the messages field.
6

Avoiding Number Conflicts with Other BSPs

Single Cloud API Destination Rule

Meta enforces that an official WhatsApp phone number can only have one active webhook destination registered at any time.

If your number is actively linked to another Business Solution Provider (such as Wati, AiSensy, or Interakt), updating the webhook to MANZA will immediately redirect all customer chats and webhooks to your MANZA Live Chat inbox.

Tip: If testing MANZA for the first time while keeping your existing provider live, use a dedicated secondary SIM or temporary virtual business number.

Ready to test your connection?

Head to the WhatsApp Marketing Hub in your dashboard and send a live test message.

Open WhatsApp Hub →