WhatsApp Integration with x-bees

WhatsApp Integration with x-bees

Scroll Export Button

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.

integrations-whatsapp.jpg

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.

Non-verified WhatsApp Business Manager connection 

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.

  1. When you open the link, scroll down to the section and click Login with Facebook button:

upload-logo-and-company-description.jpg
  1. Click Continue on the next screen:

connect-your-account-to-link-mobility-get-started.png
  1. On the next screen, you need to create or select your WhatsApp Business account and click Next: 

create-or-select-whatsapp-business-account.png

 

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

link-mobility-business-information.png

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

image (23).png

 

  1. Enter the verification code which you receive to your phone number, click Next: 

verify-your-phone-number-enter-code.png
  1. 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:

x-bees Whatsapp-Meta verify (1).jpg

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

  1. Verify your company under Facebook Business Manager, go to the Settings tab and click Start verification:

settings-business-verification.jpg
  1. Fill out details of the organization: 

add-organization-details.png

Important: Please make sure to provide the same organization name and address that stands in the documentation you will upload.

  1. 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

verification-add-supporting-documents.png

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.

  1. In the next step we recommend selecting email as a contact method:

verification-select-contact-method.png
  1. Follow the procedure for email address verification, entering the confirmation code sent to your email

  2. 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:

  1. Back up your chat history

  2. 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

WhatsApp x-bees-Send a message.jpg
  • Enter the recipient's phone number or select a contact with mobile, choose Service and click Next

WhatsApp x-bees-Enter a number.jpg
  • 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

WhatsApp x-bees-Templates.png
  • Once the message is sent, the conversation remains on hold until a customer replies to the initial message

WhatsApp x-bees-Sent message.png
  • Once a recipient replies, you can continue your interaction

WhatsApp x-bees-Reply.png

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):

whatsapp-incoming-message.png

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:

whatsapp-conversation-after-24-hours-read-only.png
  • 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:

whatsapp-receiving-different-types-of-messages-from-whatsapp.jpg
  • 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:

whatsapp-call-group-members.jpeg
  • Under the Service assignment section, assign the conversation to yourself, assign it to a specific agent by clicking Change, or leave it unassigned

whatsapp-conversation-assign-to-agent.png
  • 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:

  1. Go to WMS → Dialplan → Dialplan rules → Choose classound → Click Edit

  2. Click Add number and enter the CLASSOUND DID used for WhatsApp calls

  3. 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 application

  4. Click Save

whatsapp-incoming-call-dialplan.png

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: 

whatsapp-integration-add-contact-to-phonebook.png
  • When added, the conversation name changes to the name of the user:

whatsapp-integration-contact-added-to-phonebook.jpg

Statistics

There are two options for checking usage statistics:

  1. 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

  2. Messages statistic board in SFPC → WMP. To check WhatsApp message usage, proceed with the steps below:

WhatsApp messages statistics.jpg
    • Under Message Type filter, select WhatsApp_out/ WhatsApp_in and check the number of sent messages, specify Year/ Month filter if needed

WhatsApp messages statistic.jpg