Skip to main content

Meta WhatsApp Business Setup

Connect WhatsApp Business using the Meta (Facebook) Cloud API.

Prerequisites​

Before you start, you'll need:

  • Facebook Business account
  • Meta Developer account
  • WhatsApp Business phone number (not used on WhatsApp before)
  • Business verification (for higher messaging limits)

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 Settings → Channels → WhatsApp
  2. Click Connect WhatsApp → Meta Cloud API
  3. Enter your credentials:
    • Access Token
    • Phone Number ID
    • WhatsApp Business Account ID
  4. Click Connect
  5. Send a test message to verify

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​