Skip to main content

Meta WABA Setup

Before you can send and receive WhatsApp messages through Sydx AI, you need to create a Meta App with the WhatsApp Business API enabled. This page covers the one-time Meta setup. Once done, head to the Connect Your Number guide to link your phone number.


What You'll Need

Already have a Meta App?

If you've previously created a Meta App with WhatsApp enabled, you can skip to Connect Your Number.


Step 1: Create a Meta App

  1. Go to developers.facebook.com and log in
  2. Click My Apps (top right corner) → Create App
  3. Select app type: Business
  4. Click Next
  5. Fill in:
    • App Name — Use your business or brand name (e.g., My Company CRM)
    • App Contact Email — Your business email
    • Business Portfolio — Select your existing Meta Business Account, or create a new one
  6. Click Create App

Step 2: Add WhatsApp Product

  1. On the App Dashboard, scroll to "Add products to your app"
  2. Find WhatsApp and click Set up
  3. Select your Business Portfolio if prompted, then click Continue
  4. You'll be taken to the WhatsApp API Setup page

Step 3: Note Your Key Identifiers

From the API Setup page, note down these values — you'll need them later:

ValueWhere to Find ItWhat It Is
App IDApp Settings → Basic (or top of dashboard)Unique identifier for your Meta App
App SecretApp Settings → Basic → click "Show"Used to verify webhook signatures
WABA IDWhatsApp → API Setup → WhatsApp Business Account IDYour WhatsApp Business Account identifier
Keep Your App Secret Safe

Your App Secret is a sensitive credential. Never share it publicly or commit it to source code. You'll enter it securely within Sydx AI.


Step 4: Set App to Live Mode

By default, your app is in Development mode, which limits functionality.

  1. Go to App SettingsBasic
  2. Fill in all required fields:
    • Privacy Policy URL — Link to your privacy policy page
    • Terms of Service URL (optional but recommended)
  3. Click Save Changes
  4. At the top of the page, toggle App Mode from Development to Live
Development Mode Limitations

In Development mode, webhooks only work for registered test users. Switch to Live mode to receive messages from all users.


Step 5: Generate a Permanent Access Token

The temporary token from the API Setup page expires in 24 hours. For production use, create a permanent token:

  1. Go to Meta Business Settings
  2. Navigate to UsersSystem Users
  3. Click Add to create a new System User:
    • Name: e.g., Sydx AI Bot
    • Role: Admin
  4. Click Create System User

Assign Assets to System User

  1. Click on the System User you just created
  2. Click Add Assets
  3. Under Apps, select your Meta App → Enable Full Control
  4. Under WhatsApp Accounts, select your WABA → Enable Full Control
  5. Click Save Changes

Generate the Token

  1. Click Generate New Token
  2. Select your Meta App
  3. Select these permissions:
    • whatsapp_business_messaging
    • whatsapp_business_management
    • business_management
  4. Click Generate Token
  5. Copy the token immediately — it will not be shown again
This Token Never Expires

Unlike the temporary token, this System User token is permanent. Store it safely and use it for your Sydx AI workspace configuration.


Next Steps

Your Meta App is ready! Now proceed to connect your phone number:

👉 Connect Your WhatsApp Number →