Connecting Your WhatsApp Number
Launch App

Connecting Your WhatsApp Number

This guide walks you through adding a WhatsApp Business number to your G4 Message account using the Meta Cloud API (recommended). Cloud API numbers are hosted by Meta — no phone needs to stay online and there are no bans.

Meta Cloud API — The Only Supported Method

This platform uses the official Meta Cloud API exclusively. Cloud API numbers are hosted by Meta — no phone needs to stay online and all integrations are fully compliant with Meta's WhatsApp Business Solution Terms.

Prerequisites

  • A Meta Business Portfolio (formerly Business Manager) — business.facebook.com
  • A phone number that is not already registered on WhatsApp (personal or business)
  • Access to receive an OTP on that number (SMS or call)
  • A Meta Developer App with WhatsApp product added — developers.facebook.com/apps

Step 1 — Create a WhatsApp Business Account (WABA)

  1. Go to Meta Business Settings → WhatsApp Accounts → Add
  2. Name your WABA (e.g. "My Business WhatsApp")
  3. Select your business portfolio and click Create
  4. Once created, note the WABA ID — you'll need it later

Step 2 — Add & Verify Your Phone Number

  1. Inside your WABA, go to Phone Numbers → Add phone number
  2. Choose your country code, enter the number
  3. Select Text message for OTP delivery and click Send code
  4. Enter the 6-digit OTP when received and click Verify
  5. Once verified, note the Phone Number ID shown in the phone list
OTP Not Arriving?

If OTP doesn't arrive after 3 attempts, Meta locks the number for 24 hours. Wait and retry the next day. Make sure the number is NOT already registered on WhatsApp — if it is, unregister it from the WhatsApp app first (Settings → Account → Delete my account or Settings → Account → Switch to Business Account).

Step 3 — Create a Meta Developer App

  1. Go to developers.facebook.com/apps → Create App
  2. Use case: "Connect with customers through WhatsApp"
  3. Link it to your Business Portfolio
  4. After creation, go to App Settings → Basic — copy your App ID and App Secret
  5. In the left sidebar → WhatsApp → API Setup — link your WABA here

Step 4 — Generate a Permanent Access Token

  1. In Meta Business Settings → System Users → Add
  2. Create a System User (e.g. "g4-api") with Admin role
  3. Click Add Assets → select your WABA → grant Full Control
  4. Click Generate New Token → select your App → enable permissions:
    whatsapp_business_messaging, whatsapp_business_management
  5. Set token expiry to Never and copy the token
Keep Your Token Secret

Treat the access token like a password. Never expose it in frontend code or share it publicly. Store it securely — the platform encrypts it at rest automatically.

Step 5 — Connect to G4 Message

  1. Go to Tools → WhatsApp → Setup in the dashboard
  2. Click Connect Manually (Cloud API)
  3. Enter your App ID and App Secret, then click Discover
  4. The wizard will auto-fetch your WABA and phone numbers from Meta
  5. Select the correct WABA and phone number from the dropdowns
  6. Enter your Access Token and optionally a 6-digit PIN
  7. Click Connect Account — done!

What Happens Next

Once connected, the platform will:

  • Register a webhook on Meta so incoming messages are delivered in real-time
  • Enable Templates — sync approved message templates from your WABA
  • Enable Broadcast, Inbox, Chatbots, and all other tools for this number
Still need help?

If you're stuck at any step, open a support ticket and include your WABA ID and the step where it failed.

Open Support Ticket