Back to Help Center
💬
WhatsApp 10 min read

WhatsApp Business API Setup

Step-by-step guide to connecting your WhatsApp Business number to ViViDlyPro via Meta's official API.

Setting Up WhatsApp Integration

ViViDlyPro connects to WhatsApp through Meta's official WhatsApp Cloud API. This is different from the regular WhatsApp or WhatsApp Business app — it's a business-grade API that allows software to send and receive messages programmatically.

Prerequisites

Before starting, you need:

  • A Meta (Facebook) Business account — create one free at business.facebook.com
  • A phone number dedicated to WhatsApp Business (cannot be the same number you use on the regular WhatsApp app)
  • A verified Facebook Page linked to your business

Step 1 — Create a Meta App

  1. Go to developers.facebook.com and log in with your Meta account.
  2. Click My Apps → Create App.
  3. Select Business as the app type.
  4. Fill in your app name and linked business account, then click Create App.

Step 2 — Add WhatsApp to Your App

  1. In your Meta App dashboard, click Add a Product.
  2. Find WhatsApp and click Set Up.
  3. Follow the prompts to add your business phone number.
  4. You'll receive a verification code via SMS or call on that number.

Step 3 — Get Your API Credentials

From your Meta App's WhatsApp section, copy:

  • Phone Number ID
  • WhatsApp Business Account (WABA) ID
  • Permanent System User Access Token (create this in Meta Business Settings → Users → System Users)

Step 4 — Enter Credentials in ViViDlyPro

  1. In your ViViDlyPro portal, go to Settings → Channels → WhatsApp.
  2. Enter your Phone Number ID, WABA ID, and Access Token.
  3. Click Verify & Connect.

Step 5 — Configure the Webhook

The portal will show you a Webhook URL and Verify Token. Go back to your Meta App:

  1. In WhatsApp → Configuration, click Edit.
  2. Paste the Webhook URL and Verify Token.
  3. Select messages as the subscription field.
  4. Click Verify and Save.

Step 6 — Send a Test Message

Send a WhatsApp message to your connected number from any phone. The bot should reply within seconds.

Troubleshooting

  • "Invalid Phone Number ID" — Double-check you copied the Phone Number ID, not the WABA ID.
  • "Webhook verification failed" — Ensure the Verify Token matches exactly (case-sensitive).
  • No reply — Check that "messages" is checked in webhook subscriptions.