# WhatsApp

WhatsApp is a cross-platform messaging and Voice over IP service owned by Facebook. As of February 2019, WhatsApp has over 1.5 billion active users in over 180 countries.

![The WhatsApp Logo](https://3688769499-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mbui1HRO4dGghy5ITOz%2F-McrqTsaj-arjzYy7CqM%2F-McrrC7TyM43wwNSvx-7%2Fimage.png?alt=media\&token=969ad169-e306-433a-a172-5aa5c0d76137)

WhatsApp does not allow companies to connect directly to their API or create business accounts on their own. To create a WhatsApp Business API account you'll need to apply through a WhatsApp Partner.

Once a WhatsApp Partner has approved and provisioned your WhatsApp Business API account with a phone number you may connect it to the IS Messenger platform and manage WhatsApp messages just like any other channel.

## WhatsApp Providers

We are integrated with the following WhatsApp Channel Providers.

|                                                                                                      Provider |  Use Case  |  Pricing Model | Billing Cycle | Min Monthly Charge | Session^ Messages Included |                              API Account Application                              |
| ------------------------------------------------------------------------------------------------------------: | :--------: | :------------: | :-----------: | :----------------: | :------------------------: | :-------------------------------------------------------------------------------: |
| [Cloud API by Meta](https://docs.is-messenger.com/ismessenger/messaging-channels/whatsapp/whatsapp-cloud-api) | Production |    Per Month   |    Monthly    |        < $1        |          Unlimited         |             [Sign Up](https://hub.360dialog.com/lp/whatsapp/xafvHfPA)             |
|         [360Dialog](https://docs.is-messenger.com/ismessenger/messaging-channels/whatsapp/360dialog-whatsapp) | Production |    Per Month   |    Monthly    |         $5         |          Unlimited         |             [Sign Up](https://hub.360dialog.com/lp/whatsapp/xafvHfPA)             |
|     [MessageBird](https://docs.is-messenger.com/ismessenger/messaging-channels/whatsapp/messagebird-whatsapp) | Production | Message Bundle |    Annually   |         $50        |          15,000\*          |               [Sign Up](https://www.messagebird.com/en/pricing/api)               |
|               [Vonage](https://docs.is-messenger.com/ismessenger/messaging-channels/whatsapp/vonage-whatsapp) | Production |  Active Users  |   Enterprise  |     Enterprise     |             N/A            | [Sign Up](https://www.vonage.com/communications-apis/messages/features/whatsapp/) |
|                       [Twilio](https://docs.is-messenger.com/ismessenger/messaging-channels/broken-reference) | Production |   Per Message  |    Monthly    |        < $1        |            None            |               [Sign Up](https://www.twilio.com/whatsapp/pricing/us)               |

^ WhatsApp API has a Session Messaging Window of 24 hrs. Companies must reply to customers within 24 hrs to send a Session Message. Otherwise, a Template Message must be used.

\*MessageBirds cheapest plan includes 15,000 Session Messages, the subscription is billed annually.

## Messaging Window

WhatsApp API has a messaging window or 24 hours which you are allowed to reply to customers with any content. After 24 hours, you will need to send a Template Message in order to send a reply to the customer.&#x20;

The 24 hours messaging window is applicable to the following providers :

* [360 Dialog](https://docs.is-messenger.com/ismessenger/messaging-channels/whatsapp/360dialog-whatsapp)
* [Twilio](https://docs.is-messenger.com/ismessenger/messaging-channels/whatsapp/twillio-whatsapp)
* [MessageBird](https://docs.is-messenger.com/ismessenger/messaging-channels/whatsapp/messagebird-whatsapp)
* [Vonage](https://docs.is-messenger.com/ismessenger/messaging-channels/whatsapp/vonage-whatsapp)
* [WhatsApp Cloud API](https://docs.is-messenger.com/ismessenger/messaging-channels/whatsapp/whatsapp-cloud-api)

Learn more on WhatsApp Message Templates&#x20;

{% content-ref url="whatsapp/whatsapp-messaging-templates" %}
[whatsapp-messaging-templates](https://docs.is-messenger.com/ismessenger/messaging-channels/whatsapp/whatsapp-messaging-templates)
{% endcontent-ref %}

## WhatsApp Interactive Message

{% hint style="warning" %}
Due to the partners' limitation, WhatsApp Interactive Message is only supported by 360dialog as of now.&#x20;
{% endhint %}

In IS Messanger, WhatsApp Interactive Message is used when sending a multiple choice question from a survey or quick replies using Dialogflow. \
\
When the question or message has fewer or equals to 3 options, WhatsApp Quick Replies will be used to display the options.

<figure><img src="https://3688769499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mbui1HRO4dGghy5ITOz%2Fuploads%2Ft5eXqddtfifgrxdrvaQf%2Fimage.png?alt=media&#x26;token=af54d9ad-344d-4152-ab51-e4903a0cca8a" alt=""><figcaption></figcaption></figure>

Otherwise, WhatsApp List Messages will be used to display the options not exceeding the maximum limit of 10.&#x20;

<figure><img src="https://3688769499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mbui1HRO4dGghy5ITOz%2Fuploads%2FsP70B73sY3m8H07KgrRM%2Fimage%20(1).png?alt=media&#x26;token=0623b8a9-139a-481b-9b25-685edd9e7766" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3688769499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mbui1HRO4dGghy5ITOz%2Fuploads%2FVaviAllaHRWx7p8RlHsZ%2Fimage%20(2).png?alt=media&#x26;token=8317409d-e35c-4836-bed9-598760ae4fc6" alt=""><figcaption></figcaption></figure>

## Frequently Asked Questions&#x20;

### How to get WhatsApp Business with multiple users?

You need to connect a WhatsApp Business API account to ISMessenger. WhatsApp Business is two products: \
📱 **WhatsApp Business App** - one device, one user \
⚙️ **WhatsApp Business API** - for companies with teams

If you want to learn about the difference between these accounts, you can check our [video](https://hi.switchy.io/1DEC).&#x20;

### How much does a WhatsApp Business API account cost?

The price you pay for WhatsApp Business API via a WhatsApp Partner has two components:

* The fee charged by WhatsApp
* The fee charged by the WhatsApp Partner

Different WhatsApp Partners have different pricing models:

* Set-up fee
* Monthly fee
* Messaging fee

### Are there any restrictions to the type of Messages that I can send to my Contacts?

WhatsApp Business API has 2 types of messages:

* **Session Messages**: Whenever a contact sends an incoming message to your number, a timer is set. You have 24 hours to send outgoing messages to that user without any restrictions.<br>
* **Template Messages**: After the 24 hours of the session message is finished, you can only send a pre-approved template by WhatsApp to encourage your contact to resume the conversation and you can keep sending session messages. Advertising, marketing, or promotional messages are not permitted as Template Messages. For a more comprehensive breakdown, please refer to their [Message Templates Guidelines](https://developers.facebook.com/docs/whatsapp/message-templates/guidelines).

### Can I use WhatsApp Groups with WhatsApp API?

Group Messages are not supported by WhatsApp Business API. Facebook has deprecated the development of this feature.

### Can I receive WhatsApp Calls with WhatsApp API?

WhatsApp calls are not supported by WhatsApp Business API.

### Are there any restrictions placed on phone number registration for WhatsApp Business API?

To register for WhatsApp Business API:

* The phone number must be able to receive voice calls or SMS
* The phone number must not have been connected to WhatsApp Business API before.

Do note that once a phone number has been registered with WhatsApp Business API, it cannot be used for WhatsApp Business App or WhatsApp personal app. A phone number can be upgraded to WhatsApp Business API but not downgraded.
