Skip to main content

​
Prerequisites

  • A Meta Business Manager account
  • A WhatsApp Business Account (WABA) with at least one verified phone number
  • Admin access to Meta Developers (to create a system user and generate a token)

​
Step 1 — Collect your credentials from Meta Developers

  1. Go to developers.facebook.com and open your app.
  2. In the left sidebar, click WhatsApp → API Setup.
  3. Note down the following three values — you’ll enter them in Swiftsell:
FieldWhere to find it
App IDTop of the API Setup page, or in your app’s dashboard
Phone Number IDUnder “From” in the API Setup panel
WhatsApp Business Account IDListed under your phone number

​
Step 2 — Create a System User access token

A system user token is a long-lived token that doesn’t expire when someone logs out. This is the recommended approach for production integrations.
  1. In Business Settings, go to Users → System Users.
  2. Click Add and create a user with the Admin role.
  3. Click Add Assets, select your WhatsApp app, and grant it Full Control.
  4. Click Generate New Token and select your app.
  5. Under Permissions, enable the following:
    • whatsapp_business_messaging
    • whatsapp_business_management
  6. Copy the generated token and store it securely — it won’t be shown again.
Never share your access token publicly or commit it to source control. If a token is compromised, revoke it immediately from Business Settings and generate a new one.

​
Step 3 — Add the credentials to Swiftsell

  1. In Swiftsell, go to Settings → WhatsApp.
  2. Click Connect Account and enter:
    • App ID
    • Phone Number ID
    • WhatsApp Business Account ID
    • Access Token
  3. Click Save.

​
Step 4 — Configure the webhook in Meta

Swiftsell needs to receive incoming messages via a webhook.
  1. In Meta Developers, go to WhatsApp → Configuration.
  2. Under Webhook, click Edit.
  3. Enter the Callback URL shown in Swiftsell (Settings → WhatsApp) and the Verify Token displayed there.
  4. Click Verify and Save.
  5. Under Webhook Fields, subscribe to messages.

​
Step 5 — Test the connection

Send a WhatsApp message from any personal number to your business phone number. Within a few seconds:
  • The message should appear in Live Chat in Swiftsell.
  • If you have an active bot deployed to that number, it should reply automatically.
If messages aren’t arriving, double-check that the webhook subscription to messages is active and that your access token has the whatsapp_business_messaging permission.

​
Managing multiple phone numbers

You can connect more than one WhatsApp phone number to a single Swiftsell workspace. Each number is listed separately in Settings → WhatsApp, and you can deploy different bots to different numbers via the Start Flow block in each automation. To add another number, repeat Steps 1–4 using the Phone Number ID of the additional number (the App ID and WABA ID may be the same if the numbers are under the same WABA).