Setup Guide

Set up WhatsApp Business API

In this guide you'll learn step by step how to connect the WhatsApp Business Cloud API with BitPalm.

01

Create Meta Business Account

If you don't have one yet, create a Meta Business Account and a Facebook Developer Account.

The Developer Account must be linked to your Business Account.

02

New App in Developer Portal

Go to developers.facebook.com/apps and click on "Create App".

  • Select the type "Business"
  • Choose a name (e.g. "MyCompany WhatsApp Bot")
  • Select your Business Account
03

Add WhatsApp Product

In your new app, click "Add Products" in the dashboard and select "WhatsApp".

Follow the setup wizard to activate the WhatsApp Business API.

04

Find Phone Number ID

Under WhatsApp > API Setup you'll find a test phone number. The Phone Number ID is displayed directly below it.

Phone Number ID: 1234567890123456

Copy this ID – you'll need it later in the BitPalm Dashboard.

05

Generate Permanent Access Token

The temporary token on the API setup page expires after 24h. For a permanent token:

  1. Go to Business Settings > System Users
  2. Create a new System User with Adminrole
  3. Click on "Generate New Token"
  4. Select your app and enable the permissions: whatsapp_business_messaging & whatsapp_business_management
Access Token: EAABsbCS1iHgBO0vZBZC...
06

Choose Verify Token

The Verify Token is any string you define yourself. It's used to verify the webhook.

Verify Token: my-secret-token-2024

Choose a secure, random string. It must be identical in the Meta Portal and the BitPalm Dashboard.

07

Configure Webhook URL

Go to WhatsApp > Configuration > Webhook and enter the following URL:

Callback URL: https://agents.bitpalm.ae/api/channels/whatsapp/webhook

Enter the same value as your Verify Token from step 6.

08

Subscribe to Webhook Fields

After webhook verification, you need to subscribe to the relevant fields. Click "Webhook fields" and enable: "Manage":

messages

This allows BitPalm to receive incoming WhatsApp messages from your customers.

09

Enter in Dashboard & Test

Open your BitPalm Dashboard, navigate to Channels > WhatsApp and enter:

  • Phone Number ID from step 4
  • Access Token from step 5
  • Verify Token from step 6

Click "Save" and send a test message to your WhatsApp number. Your agent's response should appear within a few seconds.