WhatsApp Integration with x-bees
This guide describes how to set up and use WhatsApp integration with x-bees.
Setup instructions: How to Configure SMS and WhatsApp Conversations in WMS (Note: The number becomes available for configuration in WMS only after the CLASSOUND team completes the WhatsApp integration)
Other x-bees documentation: x-bees documentation
Created: July 2024
Updated: October 2026
Permalink: https://wildix.atlassian.net/wiki/x/EACVJg
Introduction
Kite provides a set of features that allow users to manage all conversations in one unified inbox, including WhatsApp conversations. By setting up the x-bees integration with WhatsApp, you allow users to manage incoming and outgoing WhatsApp conversations directly from x-bees. Each user receives a package of 200 SMS per month by default, which equals 200 outgoing WhatsApp messages. After this limit is exceeded, a fee is applied to each additional SMS. You can find the fee details in the Salesforce Partner Community -> Price Book -> DID & Call Termination.
It is also possible to receive incoming WhatsApp calls. To activate this option, open a Customer Care ticket. You can use existing DIDs for voice calls or connect separate DIDs for calls only.
Notes:
The price per message is the same as for SMS and is included in the package
Agents can reply within 24 hours of receiving a message from an external user. After 24 hours, the conversation switches to read-only mode. If the external user sends another message in the same conversation, agents have another 24 hours to reply
Sending emojis from x-bees to WhatsApp is not supported
WhatsApp messages are counted as part of the 200 SMS package, together with regular SMS and MMS. Usage statistics are available in the Statistics section
If Chat agent is configured, it is automatically assigned user extension 100. Outgoing messages sent by Chat agent use the same 200 SMS package per month, with a fee applied for each additional SMS after the limit is exceeded
The following phone number limits apply:
Initial limit: When you first set up your WhatsApp Business account, you can register up to 2 phone numbers
Default limit: After the account is set up, the default limit applies: a WhatsApp Business account can register a maximum of 20 phone numbers
If you need to add more than 20 phone numbers, contact Meta support to request a limit increase.
Requirements
WhatsApp is available only on x-bees and x-hoppers systems. CLASSOUND is already included with x-bees and x-hoppers, so no separate CLASSOUND Core or CLASSOUND Pro tier is required.
Facebook Business Manager verification (see the details below)
x-bees subscriptions must include at least 1 x-bees SuperBee. The following combinations are supported, a minimum of 11 subscriptions is required in total:
10 x-bees Standard + 1 x-bees SuperBee
11 x-bees SuperBee
5 x-bees Standard + 6 x-bees SuperBee
x-hoppers subscriptions must include at least 1 x-hoppers SuperHopper + AI. The following combinations are supported, a minimum of 11 subscriptions is required in total:
10 x-hoppers HelperHopper, SalesFloorHopper, or SalesFloorHopper + AI + 1 x-hoppers SuperHopper + AI
11 x-hoppers SuperHopper + AI
5 x-hoppers HelperHopper, SalesFloorHopper, or SalesFloorHopper + AI + 6 x-hoppers SuperHopper + AI
Subscription limits apply only to new installations after October 01 2026. For previously configured integrations, there are no changes: x-bees Standard subscription or higher, or an x-hoppers HelperHopper subscription or higher, is required.
Any DID for WhatsApp (it can be Fully ported or Outbound-only DID provided to CLASSOUND Customer Care, New DID, and may be either previously or newly ordered, consult the documentation for details) configured in WMS -> PBX -> Integrations -> Cloud integrations -> Channels section (see detailed instructions in the guide How to Configure SMS and WhatsApp Conversations in WMS)
The number appears in WMS → PBX → Integrations → Cloud integrations → SMS/WhatsApp only at the final stage of the integration, after the CLASSOUND team provisions it. Until then, it is not displayed in WMS.
Templates
To send outgoing messages, you need to create predefined message templates. You can create these templates directly in your WhatsApp Manager or submit CLASSOUND Customer Care request. The following parameters are supported:
Category: Marketing
Header Type: Text or Image
Buttons: All call-to-action buttons except Complete Flow
Meta verification
To set up the integration, you must verify your Facebook and WhatsApp accounts and complete the Meta validation process.
Procedure for Partners without verified WhatsApp Business Manager connection (number not added to WhatsApp yet).
Step 1. Perform the number provisioning via the embedded link
CLASSOUND team will send you a link that you need to use to connect your account to the integrations service provider.
When you open the link, scroll down to the section and click Login with Facebook button:
Click Continue on the next screen:
On the next screen, you need to create or select your WhatsApp Business account and click Next:
Note: If you are creating a new WhatsApp Business account, a new window will open. Fill in your business information and click Next:
Business portfolio
Category
Country
Website
Time zone
4. Select Use a new or existing WhatsApp number and fill in the following information:
Phone number
WhatsApp Business display name
Choose the verification method: Text message or Phone call
Click Next
Enter the verification code which you receive to your phone number, click Next:
Click Finish to finalize the process:
Once you have informed the CLASSOUND team about the completion of the number provisioning process via the embedded link, please wait up to 2–3 business days for the integration to be completed
Step 2. Submit necessary data to CLASSOUND Customer Care
Submit the following information to CLASSOUND Customer Care:
CLASSOUND DID (landline or mobile): You can add up to 20 numbers to one account. Numbers can be fully ported, new, or used for outbound calling
Display Name: The name that will be displayed in the WhatsApp account
Company Description: A short description of your company's activities
Verified Facebook Business Manager account ID: To find the ID, go to Business info in Business Manager settings:
Important: Depending on the case, completing WhatsApp integration with x-bees can take between 5 and 20 working days.
Step 3. WhatsApp Business Manager Verification
Verify your company under Facebook Business Manager, go to the Settings tab and click Start verification:
Fill out details of the organization:
Important: Please make sure to provide the same organization name and address that stands in the documentation you will upload.
On the next window, you are prompted to upload documents that prove the organization name, address and phone number. This can be the same document if you have all the required data shown there
Note: The following documents are accepted (utility bill is the easiest for phone and address)
Certificate/ Articles of Incorporation
Business Bank Statement
Business Registration or License Document
Government Issued Business Tax Document: This could include a Tax Certificate. Self-filed tax documents are not accepted.
Utility Bill
You can find more details here.
In the next step we recommend selecting email as a contact method:
Follow the procedure for email address verification, entering the confirmation code sent to your email
To finalize the business verification request, click Done on the Information submitted screen:
Verified WhatsApp Business Manager connection
Procedure for Partners with verified WhatsApp Business Manager connection.
The End client must ensure that they use a clear number for the WhatsApp Business API. This phone number cannot be associated with any other WhatsApp applications. To create a new account on the WhatsApp Business API, it is necessary to delete or remove the phone number from the previous WhatsApp account first.
Steps:
Back up your chat history
Delete the WhatsApp account
Consult WhatsApp documentation for details.
Note: Chat history will not be transferred. The number migration process may take several days, during which the account will remain inactive.
After all actions are done, follow the procedure for the non-registered accounts.
Usage
Send outgoing messages
To send outgoing messages, you need to have predefined message templates. Check the details in WhatsApp Integration with x-bees.
Only one WhatsApp recipient can be added to an x-bees conversation. To send messages to multiple users, you can use the API endpoints below:
GET /v1/a2s/whatsapp/templates retrieves a list of approved WhatsApp templates associated with a specific DID
POST /v1/a2s/whatsapp/template sends a selected template to up to 50 recipients in a single request, automatically creating individual 1:1 chats
You can find more details in the API documentation: Classound API Reference | Wildix Developer Docs.
Limitations:
The list of Services includes only Services (Call Groups) with CLASSOUND DID for WhatsApp added in WMS
Service cannot be changed after WhatsApp conversation is created
To send a WhatsApp outgoing message:
Go to your x-bees account -> click on the + button on the top panel and select Create WhatsApp conversation
Enter the recipient's phone number or select a contact with mobile, choose Service and click Next
Select a template from the list, enter the variable values, attach custom media files (images, documents, or videos) if required, and click Create conversation
You can attach different files for each recipient, such as an invoice, contract, statement, or another customer-specific document, while Meta approves the template only once.
Notes:
This feature is available only for templates with media headers and is currently limited to individual chats. For bulk messages, the approved sample file is sent
The file type (image, document, or video header) is fixed when Meta approves the template and cannot be changed. For example, a template approved with an image header cannot be used to send a PDF
Supported formats include JPEG/PNG (up to 5 MB), PDF (up to 100 MB), and MP4/3GPP (up to 16 MB)
You can send one file per template
Once the message is sent, the conversation remains on hold until a customer replies to the initial message
Once a recipient replies, you can continue your interaction
Receive incoming messages
When there is an incoming message from an external user via WhatsApp, a separate conversation is automatically created in x-bees, with external user's phone number as a conversation title (or with the contact name if the relevant entry is found in Phonebook / CRM contacts):
Note: In case there are incoming SMS and WhatsApp messages to the same CLASSOUND DID, the messages are added to separate chats.
For more information about two-way SMS, check out the documentation How to send and receive SMS/ MMS via CLASSOUND.
Messaging
Important:
Agents can reply within 24 hours after receiving an external user's message. After 24 hours, the conversation switches to read-only mode. In case an external user writes another message to the same conversation, an agent again has 24 hours to reply:
The Call button in the conversation does not initiate an outgoing call to WhatsApp, but you can receive incoming calls, see WhatsApp Integration with x-bees for details
You can send and receive different types of messages, e.g. audio, pictures, files:
You can see a quoted message when a customer replies to a message originally sent by an agent
Note: If a customer quotes one of their own previous messages, this quote is not displayed.
Manage conversation members
All users belonging to the relevant Service (Call group) are automatically added to the conversation when an external user sends a message or replies to an outgoing one:
Under the Service assignment section, assign the conversation to yourself, assign it to a specific agent by clicking Change, or leave it unassigned
Also, you can add or delete conversation members via the Members section on the Info frame
Receive incoming calls
You can receive incoming WhatsApp calls. To enable this option, request it via Customer Care. You can use existing DIDs for voice calls or connect separate DIDs for calls only.
To receive incoming calls, it is necessary to modify the classound Dialplan in WMS:
Go to WMS → Dialplan → Dialplan rules → Choose classound → Click Edit
Click Add number and enter the CLASSOUND DID used for WhatsApp calls
Add the Dial the phone application → in the Number field, enter the extension of the user who should receive WhatsApp calls
If you need to route the incoming call to a call group, use the Call group applicationClick Save
See the demo video.
Add contact to Phonebook / CRM
If needed, you can add the external user to a Phonebook or CRM integration via the Info frame:
When added, the conversation name changes to the name of the user:
Statistics
There are two options for checking usage statistics:
CLASSOUND 2-Way Messaging Board in x-bees Analytics. The Board provides visibility into inbound and outbound messaging activity across WhatsApp. Managers and administrators can use it to track message delivery and analyze communication volumes. Check the details in CLASSOUND 2-Way Messaging Analytics
Messages statistic board in SFPC → WMP. To check WhatsApp message usage, proceed with the steps below:
Log in to Salesforce Partner Community
Click More in the top panel, then choose WMP
Go to Dashboard → CLASSOUND
Select Messages statistic
Under Message Type filter, select WhatsApp_out/ WhatsApp_in and check the number of sent messages, specify Year/ Month filter if needed