Overview
A WhatsApp channel lets your team communicate with customers directly via WhatsApp Business—all within the Virtual-Call UC Client. Incoming WhatsApp messages appear alongside other messaging channels in the UC Client and can be answered in real time. This article explains how to set up a WhatsApp channel on your Cloud PBX.
Requirement: Omnichannel Messaging requires the Enterprise Plan (EP) or Ultimate Plan (UP).
Prerequisites
- Meta Developer Account: A registered account on the Meta for Developers portal.
- Business Portfolio (Meta Business Suite): A Meta Business Suite account linked to a verified business.
- Phone Number: A valid phone number that is not already registered with another WhatsApp account. The number must be able to receive voice calls or SMS for verification.
-
Domain Name: Your Cloud PBX domain name must not contain underscores (
_), as this can interfere with webhook authentication. - Domain Certificate: If your PBX uses a custom domain (not the provider's default domain), a valid domain certificate must be installed.
Limitations
| Property | Details |
|---|---|
| Supported message types | Text and multimedia (images, video, documents, audio) |
| Message direction | Bidirectional—receive incoming messages and start outbound conversations via message templates |
| Maximum send rate | 80 messages per second |
| Maximum file size (multimedia) | 100 MB |
| File retention period | 72 hours |
Note: WhatsApp enforces a 24-hour customer service window. Within this period you can reply freely to incoming messages. To start a new conversation or reply after the window expires, you must use an approved WhatsApp message template.
Setup Overview
Setting up a WhatsApp channel consists of four steps:
- Create a Meta app on the Meta for Developers portal
- Obtain authentication credentials via Meta Business Suite
- Create the WhatsApp channel on the PBX
- Configure the webhook in the Meta app
Step 1: Create a Meta App
- Sign in to the Meta for Developers portal.
-
Go to My Apps and click Create App.
-
Fill in the app details:
- Enter an app description (optional).
- Under Use cases, select Other.
- Select app type Business, enter an app name, and select your Business Portfolio.
-
Click Create App.
-
In your new app, add the WhatsApp product by clicking Set up.
-
Register your business phone number under WhatsApp > API Setup. Click Add phone number and follow the verification process (SMS or phone call).
- Note the following values—you will need them later:
-
Phone Number ID: Found in the WhatsApp section of the app dashboard under API Setup.
-
App Secret: Found under App Settings > Basic.
-
Important: Do not use the temporary access token shown in the Meta for Developers portal. It expires after 24 hours and will cause the PBX to stop receiving incoming messages. Use a permanent token from Meta Business Suite instead (see Step 2).
Step 2: Obtain Credentials via Meta Business Suite
For reliable message delivery, create a system user in Meta Business Suite and generate a permanent access token.
-
Sign in to Meta Business Suite and navigate to Business Settings.
-
Navigate to Users > System Users and create a new system user with the Admin role.
-
Assign the Meta app created in Step 1 to this system user with Full Control. Click Assign Assets, select Apps, check your app, and enable Full Control.
-
Under Accounts > WhatsApp Accounts, add the system user to your WhatsApp Business account. Click Assign people and select the system user with Admin permission.
-
Generate an access token for the system user. Click Generate new token, select your app, and enable the following permissions:
whatsapp_business_messagingwhatsapp_business_management
-
Copy the generated access token—you will need it in Step 3.
-
Note your WhatsApp Business Account ID — found under Accounts > WhatsApp Accounts in Meta Business Suite.
Step 3: Create the WhatsApp Channel on the PBX
- Sign in to the Cloud PBX administration portal.
- Navigate to Messaging > Message Channel.
- Click Add and select WhatsApp.
-
Configure the Authentication tab:
- Name: A descriptive name (e.g., “WhatsApp Support” or “WhatsApp Sales”).
- Webhook URL: This URL is generated automatically. Copy it—you will need it in Step 4.
- Verify Token: Generated automatically. Copy it—you will need it in Step 4.
- Access Token: Paste the permanent access token from Step 2.
- App Secret: Paste the App Secret from Step 1.
Important: The Webhook URL and Verify Token change if you leave the page without saving. Copy both values immediately after opening the form.
- Configure the Messaging Settings tab:
-
Phone Number: Enter the WhatsApp phone number in E.164 format (e.g.,
+4917612345678). - Phone Number ID: Enter the Phone Number ID from Step 1.
-
WhatsApp Business Account ID: Enter the Account ID from Step 2.
-
Destination for incoming messages: Choose where incoming WhatsApp messages are routed:
- Extension: Messages go directly to a specific extension.
- Message Queue: Messages go to a queue where multiple agents can handle them.
-
Allowed extensions: Select which extensions are permitted to send messages through this channel.
-
Auto-close session: Enable this option and set a timeout in days to automatically close inactive sessions.
- Allow duplicate active sessions: Determines whether a new agent can create a session when an active session with the same contact already exists.
-
- Click Save.
Step 4: Configure the Webhook in the Meta App
For the PBX to receive incoming WhatsApp messages, you must set up a webhook in your Meta app:
- Sign in to the Meta for Developers portal and go to My Apps.
-
Open your app and navigate to WhatsApp > Configuration.
-
In the Webhook section:
- Paste the callback URL you copied from the PBX in Step 3.
- Paste the verify token you copied in Step 3.
- Click Verify and Save.
- In the Webhook Fields section, subscribe to the messages field.
Tip: To verify the setup, you can add a recipient number under API Setup and send a test message.
Result
After successful setup, the WhatsApp channel appears in the channel list under Messaging > Message Channel with a green status icon. The PBX automatically tracks the number of messages sent and received.
WhatsApp Message Templates
The PBX automatically synchronizes approved message templates from your WhatsApp Business account. Templates are needed to start conversations outside the 24-hour customer service window—for example, for appointment confirmations, order notifications, or promotional messages.
To view the synchronized templates, navigate to Messaging > Message Channel and click the template icon next to the WhatsApp channel. Click Refresh to manually update the template list (the system updates automatically once daily).
Note: Only templates with status Active are synchronized with the PBX. Marketing templates of type Catalog are excluded. The PBX supports up to 250 message templates per WhatsApp channel.
Important Notes
- 24-hour window: WhatsApp requires businesses to reply within 24 hours of the last customer message. After this window expires, the customer can only be contacted via an approved message template.
- Access token validity: Always use a permanent access token from a system user in Meta Business Suite. Temporary tokens from the Meta for Developers portal expire after 24 hours and will cause the PBX to stop receiving messages.
- Business verification: Meta requires your business to be verified before certain WhatsApp Business features and higher message limits become available. Complete verification in Meta Business Suite.
- MMS file size: Multimedia messages are limited to 100 MB. Files are retained for 72 hours.
- IP access for multimedia: If you have configured IP access security rules, ensure that access from Meta servers is allowed—otherwise multimedia files cannot be delivered.
Comments
0 comments
Article is closed for comments.