Getting Started with WAMANAGER API
The WAMANAGER allows you to send WhatsApp messages to your customers globally. This guide will help you set up authentication, verify your business credentials, and send your first message.
Base URL
All requests to the API should be made to the following base URL:
Getting Your Access Token
Before sending any WhatsApp message, make sure your business account has valid credentials configured in your WAMANAGER Panel. These credentials are required to authenticate requests and ensure message delivery.
- Log in to your WAMANAGER Panel.
- Navigate to
Business Settings → External API Token. - Click on Generate Token to create a new access token.
- Copy and securely store your token — it will be used in your API requests.
Required Business Credentials
Make sure the following business details are correctly configured in your panel before using the API:
| Field | Description |
|---|---|
| phone_number_id | Your WhatsApp Business phone number ID (required for all message sends). |
| app_id | Meta application ID linked to your WhatsApp Business Account. |
| waba_id | WhatsApp Business Account ID (WABA ID) associated with your business. |
| verify_token | Used for verifying webhook URLs when setting up message webhooks. |
| access_token | Permanent access token used for all API requests to Meta’s endpoints. |
| external_api_token | Generated via your WAMANAGER Panel — required to authenticate all Business Messaging API requests. |
⚠️ Important: Make sure phone_number_id and access_token are valid and not empty. Incorrect or missing credentials will result in message delivery failures.
ℹ️ Note: There is an option in the Vendor Panel (Profile Settings) to control whether you want to sync chats or not. You can enable or disable chat synchronization from connected channels into your conversation based on your preferences.
Supported Message Types
The Business Messaging API supports various message types to help you communicate effectively with your audience:
| Type | Description |
|---|---|
| Text Message | Send plain text messages with optional link previews. |
| Media Message | Send images, videos, audio, or documents. |
| Sticker Message | Send brand stickers or fun visuals. |
| Location Message | Share store or meeting locations. |
| Contact Message | Send customer or business contact details (vCards). |
| Template Message | Send approved templates through Meta. |
Example Request
Below is an example of sending a text message using the API.
curl -X POST '<BASE_URL>/api/whatsapp/text' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-d '{
"to": "+16505551234",
"body": "Hello, this is a test message from WAMANAGER!",
"preview_url": true
}'to field) is registered under your Meta WhatsApp Business Account. Messages sent to numbers that are not registered or not opted in will not be delivered.