Connecting WhatsApp to maaiiconnect

Connect your WhatsApp Business API to your maaiiconnect service. Your visitors and customers' messages on your WhatsApp account become omnichannel enquiries in your maaiiconnect service, which any of your staff can attend as one-on-one conversations.


What is WhatsApp Business?

Learn more about WhatsApp Business and the WhatsApp Business API.

Here is a simple flow to setup maaiiconnect and your WhatsApp Business API account.

WhatsApp and maaiiconnect Integration with WABA Provider Flow


Refer to the following step by step configuration.

Step 1 - Choose your WhatsApp Business API Provider

You can find the WhatsApp Business API Provider in Facebook Official Partner Directory

For M800 & maaiiconnect, we have partnered with the following WhatsApp Providers:


Step 2 - Prepare and apply for the Business API

Before you apply for the Business API, you need to provide the following information:




WhatsApp Number

  • Prepare a clean phone number that has never registered to any WhatsApp services (or please delete any other WhatsApp services for this number before registration)

  • This number is non-transferable - it cannot be used on WhatsApp apps (Both WhatsApp for Personal APP and WhatsApp for Business APP) again after being approved for Business API.

We highly suggest you to use maaiiconnect Local Number as your WABA API account. So you can also handle enquiries from direct dialling the number inside maaiiconnect.

Business Display Name

  • Display Name would undergo verification by Facebook.
  • You must choose a display name that is unique to your business. This can not be changed after it is registered.
    To read full guidelines on display name, click here.

A Verified Facebook Business Manager ID



If you want to use an existing number that has Whatsapp Account, we recommend you to use a new number or a number from M800/maaiiconnect:

  • You will be required to delete the WhatsApp account with this number during the final setup stage.
  • To delete the account, follow these steps. (*You will lose your old chat history.)


Step 3: List your WhatsApp Business API details

maaiiconnect follow standard APIs provided by Facebook. Therefore, as long as your supplier, you choose to use, allowing maaiiconnect directly connecting to Facebook instead of connecting to the supplier for integration.

To integrate maaiiconnect to your WhatsApp Business API Account, the following information is needed from your WhatsApp Business API Supplier:




Supplier Name

Mandatory. This is for maaiiconnect to compliant with Terms and Conditions of Facebook

The Name of your supplier

WhatsApp Number

Mandatory. This is the number you subscribed WhatsApp Business API


Endpoints Url

Mandatory. This is the WhatsApp Server your supplier provide

"https://whatsapp-xxx.supplier.domain" or "".
Domain name is preferred for higher security protection.

User Name

Mandatory. The user name of above Endpoints


User Password

Mandatory. The password of above User Name



Optional. Used by supplier.


After you completed the set up in Clare.AI, they will provide you with the information needed via email.

After you completed the set up in Sanuker, you can access their Dashboard and view your registered WhatsApp Business API's details.

After you completed the set up in EMMA, they will provide you with the information needed via email.


Submit these details to your maaiiconnect Account Manager to use for integrating your WhatsApp Account with your maaiiconnect service.


Setting Up WhatsApp Channel in maaiiconnect

To create a new WhatsApp channel:

  • From the navigation menu, go to Channels > Omnichannels.
    On the Omnichannels interface, click on the Create Channel button on the top-right corner.

Create a new WhatsApp channel

  • Click on the WhatsApp icon.



  • Choose for the WhatsApp Business API account as a source you want to link to your WhatsApp Channel.
  • Click on the Select button.

Select WhatsApp Source



If you do not have yet the WhatsApp Business API as a source on your maaiiconnect service, please contact your Account Manager or our Sales Team at [email protected] to assist in setting up for you the connection of your WhatsApp Business API Account in your maaiiconnect service.

Refer to Step 3: List your WhatsApp Business API details for the details to provide to the maaiiconnect Team.

Contact Sales Team to set up the WhatsApp Business API


After selecting a WhatsApp Business API source, this will launch the Create New Channel wizard with the following workflow:

Basic Information

The Basic Information section contains the following details:

Channel Name

  • Add a name for your WhatsApp channel. The channel name can be up to 40 characters.
  • Click on the Save button.

Channel Name




Routing Settings

Routing rules help businesses with multiple customer service teams or groups distribute incoming customer enquiries to their preferred destinations.

Routing rules may be any of the following:

Alternative routing rule
Alternative routing distributes incoming enquiries based on the order of Destinations. Using this rule, you can have up to five Destinations per Channe. The order they are listed from top to bottom indicates their routing priority and succession (i.e., if a preceding Destination is unavailable or has timed out).

Percentage routing rule
Add two or more Destinations to your channel to use the percentage rule. This rule distributes incoming enquiries at a percentage value. It helps your customer service provide support according to your support teams or hours of operation.

Time routing
Add two or more Destinations to your channel to use the rime-based rule. This rule distributes incoming enquiries using time allocation. It helps your customer service provide customer support 24/7 effectively or according to your operating hours.

Routing Rules Types

To manage the routing rule:

  • On the Routing rules dropdown box, select the Routing appropriate to your customer service. It will then display the Destination as required to add.


A channel with multiple destinations routes customer enquiries to the succeeding destinations on the list if the first one is unavailable or has timed out.


Minimise missed enquiries by adding multiple destinations in a channel.

Adding a Destination
To add a destination:

  • Click on the (+) button located on the right side of the Add Destination field. A pop-up window will display a list of created destinations to choose from.
  • Search or scroll up/down the destination list, select a destination, then click on the Add button.

Add a Destination

Removing a Destination
To remove an added Destination

  • Click on the trash icon beside it. A pop-up window will appear to confirm the removal.
  • Click on the Remove button.

Sample time routing settings

  • Back on the Routing Setting section, click on the Save button. A pop-up message will appear, asking you to confirm the action.
  • Click on the Confirm button.

Sample percentage routing settings

To rearrange the order of the Destinations:

  • Click on the dots on the left side of a Destination, then drag and drop it up or down to your preferred order.
  • Click on the Save button. A pop-up message will appear, asking you to confirm the action.
  • Click on the Confirm button.

Sample alternative routing settings


Sticky Routing

Sticky Routing is a relationship established between a visitor and a specific staff agent. The open enquiry from the same visitor directly routes to the same staff agent.

Enabling Sticky Routing

  • To enable the Sticky Routing function, click on the grey (disabled) toggle button to switch it on.

Disabling Sticky Routing

  • To disable the Sticky Routing function, click on the green (enabled) toggle button to switch it off.

Sticky Routing


Messages Settings

Display Name Format
You may include a display name on your messages whenever your Staff members send them on behalf of your WhatsApp Business API. Choose from the following options:

  • No Title
  • Staff First Name
  • Staff Default Display Name

Display Name Format


Welcome Message
Greet your visitors when they send you their very first message.

  • maaiiconnect provides a default welcome message; you can change it according to your preference.

Welcome Message


Away Message
When a visitor's enquiry is missed, send an auto-reply message that their enquiry will be attended to shortly.

  • maaiiconnect provides a default away message; you can change it according to your preference.

Away Message


Created channels listed on the Omnichannel page.

Omnichannel Main Page


Managing WhatsApp channels in maaiiconnect

To edit, suspend, or delete your WhatsApp channels in maaiiconnect, refer to the Managing Omnichannels section of this Guide.


Serving Chat Enquiries

Refer to Serving Chat Enquiries for more information to serve an enquiry via the WhatsApp channel.


Known Limitations

:white-check-mark: You can only connect WhatsApp Business API to maaiiconnect. You cannot connect to other WhatsApp accounts.

:white-check-mark: A WhatsApp Business API account can only connect to one maaiiconnect service.

:white-check-mark: Supported Text, Media Content-Types and Size Limit

  • You can only send up to 3,900 characters per message.

  • You cannot recall messages from WhatsApp/Omnichannel enquiries.

  • DOC, XLS, PPT, and PDF and should not exceed 100 MB for a file

  • PNG and JPG and should not exceed 5 MB for an image

  • AAC, MP4, AMR and MPEG and should not exceed 16 MB for audio

  • MP4 and 3GPP and should not exceed 16 MB for a video

  • WhatsApp Business API have a 48-hour window period when you can send messages and respond to enquiries. The following message appears when the window period has lapsed: Sorry, your message can no longer send; the 48-hour message window has lapsed. Close this enquiry, or wait until the visitor sends a message again.


Help and Support

Send a test message to your WhatsApp Business API account and check if your maaiiconnect service receives it as a new enquiry.

If your maaiiconnect service is still not receiving any messages, contact our maaiiconnect Support Team at [email protected].

Updated 14 days ago

Connecting WhatsApp to maaiiconnect

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.