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.ai/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

Find your WABA ID (optional)

The WhatsApp Business Account ID (WABA ID) is needed if you want to sync and send message templates. If you only need basic text messaging, you can skip this step.

  1. Open Meta Business Suite → WhatsApp Accounts
  2. Select your WhatsApp Business Account from the list.
  3. The WABA ID is displayed in the URL bar and on the account overview page — it's a numeric ID.
WABA ID: 123456789012345

You can also find it in the Meta Developer Portal under your app → WhatsApp → API Setup → WhatsApp Business Account ID.

10

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
  • WABA ID (optional) from step 9

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