Skip to main content

Meta WhatsApp Business Setup

Connect WhatsApp Business using the Meta (Facebook) Cloud API. This is one of the live integrations in the Integrations catalog.

Prerequisites​

Before you start, gather everything you'll need:

  • Facebook Business account
  • Meta Developer account with a Facebook app (you'll need its App ID and App Secret)
  • A WhatsApp Business Account (WABA) and its WABA ID
  • A dedicated WhatsApp Business phone number (not previously used on WhatsApp), in E.164 format (e.g. +1234567890)
  • The Phone Number ID from the WhatsApp API Setup page
  • A permanent access token (starts with EAA) generated for a System User
  • Business verification (for higher messaging limits)
Where you'll enter these

You'll paste these credentials into Fyncall on the Integrations page (Integrations → WhatsApp Business → Connect). The same screen shows you the webhook callback URL and verify token to paste back into Meta in Step 5.

Step 1: Create Meta App​

  1. Go to developers.facebook.com
  2. Click My Apps → Create App
  3. Select Business as the app type
  4. Enter your app name and email
  5. Click Create App

Step 2: Add WhatsApp Product​

  1. In your app dashboard, click Add Product
  2. Find WhatsApp and click Set Up
  3. You'll be taken to the WhatsApp getting started page

Step 3: Configure WhatsApp Business Account​

Select or Create Business Account​

  1. Click Get started under WhatsApp
  2. Select your Meta Business Account (or create one)
  3. Create a WhatsApp Business Account

Add Phone Number​

  1. Click Add phone number
  2. Enter your business phone number
  3. Verify via SMS or voice call
  4. Display name will be shown to customers
caution

The phone number cannot be registered on WhatsApp or WhatsApp Business app. You'll need a dedicated number.

Step 4: Get API Credentials​

Permanent Access Token​

  1. Go to App Settings → Basic
  2. Note your App ID and App Secret
  3. Go to WhatsApp → API Setup
  4. Create a permanent access token:
    • Go to Business Settings → System Users
    • Create a system user
    • Generate token with whatsapp_business_messaging permission

Phone Number ID​

  1. In the WhatsApp API Setup page
  2. Find your Phone Number ID (numeric ID)
  3. Note the WhatsApp Business Account ID

Step 5: Configure Webhook​

In Meta Developer Portal​

  1. Go to WhatsApp → Configuration
  2. Under Webhook, click Edit
  3. Enter your webhook URL: 
    https://api.fyncall.com/api/v1/webhooks/meta-whatsapp
  4. Enter verify token (get from Fyncall dashboard)
  5. Click Verify and Save

Subscribe to Webhook Fields​

Subscribe to these webhook events:

  • messages - Incoming messages
  • message_status - Delivery/read receipts

Step 6: Connect in Fyncall​

  1. Go to Integrations and find the WhatsApp Business card.

  2. Click Connect.

  3. Step 1 (Configure Webhook): Copy the Callback URL and Verify Token shown on screen and paste them into Meta (Step 5 above). Subscribe to the messages field.

  4. Step 2 (Enter Credentials): Fill in the form fields:

    FieldFormat / where to find it
    Phone Number IDNumeric, 10+ digits — WhatsApp → API Setup
    Permanent Access TokenStarts with EAA — System Users token
    WhatsApp Business Account ID (WABA ID)Numeric, 10+ digits — Meta Business Suite → Business Settings
    Facebook App IDNumeric, 10+ digits — App Dashboard → Settings → Basic
    App SecretApp Dashboard → Settings → Basic
    WhatsApp Phone NumberE.164 format, e.g. +1234567890

  5. Click Connect WhatsApp. Fyncall validates the credentials with Meta.

  6. Send a test message to verify two-way messaging.

Step 7: Configure Business Profile​

In Meta Business Manager:

  1. Go to WhatsApp Manager
  2. Click on your phone number
  3. Edit Business Profile:
    • Profile picture
    • About text
    • Business category
    • Website
    • Address

Messaging Limits​

Tier System​

TierLimit (24h)How to Reach
Unverified250Default
Tier 11,000Verify business
Tier 210,000Quality conversations
Tier 3100,000Sustained quality
Tier 4UnlimitedHigh volume

24-Hour Window​

  • Respond to customers within 24 hours freely
  • After 24 hours, you must use an approved template
  • Customer-initiated messages reset the window

Template Messages​

For messages outside the 24-hour window:

Create Template​

  1. Go to WhatsApp Manager → Message Templates
  2. Click Create Template
  3. Choose category:
    • Utility (transactional)
    • Marketing
    • Authentication

Template Format​

Hello {{1}},

Your order #{{2}} has been shipped!
Track it here: {{3}}

Thanks,
{{4}}

Submit for Review​

Templates must be approved by Meta (usually 24-48 hours).

Troubleshooting​

Webhook Not Receiving Messages​

  1. Verify webhook URL is correct
  2. Check verify token matches
  3. Ensure webhook is subscribed to messages
  4. Check SSL certificate is valid

Cannot Send Messages​

  1. Verify phone number is registered
  2. Check access token is valid
  3. Ensure you're within rate limits
  4. Verify 24-hour window or use template

Business Verification Pending​

  1. Complete business verification in Meta Business Manager
  2. Provide required documents
  3. Wait for Meta review (can take 2-5 days)

Next Steps​