WhatsApp

The WhatsApp integration connects your Shawer bot to the WhatsApp Business API. Once configured, customers can message your WhatsApp Business number and receive automated responses from your bot's knowledge base.

Prerequisites

Before you begin, you need:

1. A Meta Business account with access to the WhatsApp Business Platform
2. A WhatsApp Business phone number registered in your Meta Business dashboard
3. A System User access token with the whatsapp_business_management permission

Setup

Navigate to your bot's Integrations > WhatsApp page.

Step 1: Enter your credentials

Fill in the following fields:

• Phone Number ID — Found in your Meta Business dashboard under WhatsApp > API Setup. This is a numeric ID, not your phone number
• Business Account ID — Your WhatsApp Business Account ID from Meta
• Access Token — A permanent system user token with whatsapp_business_management permission. This token is hidden after saving (only the last 8 characters are shown)
• Webhook Verify Token — A random string you create. This must match the WHATSAPP_WEBHOOK_VERIFY_TOKEN in your environment configuration

Step 2: Save and get webhook URL

After saving your credentials, Shawer generates a Webhook URL. Copy this URL — you will need it in the next step.

Step 3: Configure the webhook in Meta

1. Go to your Meta App Settings
2. Navigate to the WhatsApp product settings
3. Under Webhooks, paste the Webhook URL from Shawer
4. Enter the same Verify Token you configured in Shawer
5. Subscribe to the messages webhook field

Step 4: Test

Send a message to your WhatsApp Business number. The bot should respond using your knowledge base and behavior rules.

Managing the integration

• Edit — Update credentials or tokens at any time. You can leave the Access Token blank when editing to keep the current token
• Delete — Remove the integration to disconnect WhatsApp

Troubleshooting