Skip to main content

WhatsApp Cloud Integration

Introduction

WhatsApp Cloud API helps businesses onboard and build their first official WhatsApp messaging experience. Different from the WhatsApp business app on smartphone, WOZTELL has integrated with WhatsApp Cloud API and allows our users to create chatbot through our platform. Registering as a business will unlock features such as:

  • Business Information: People can now easily identify your business by its category or industry and find out more information (i.e., hours of operation, website, address, description).
  • Send and Receive: Enable two-way high value conversations with customers.
  • Message Templates: Create message formats that are needed for sending notifications to users.

Conversations

With the WhatsApp Cloud API, the usage and charges are measured based on the concept of Conversations.

A conversation is measured in fixed 24-hour sessions, it starts when the first business message in a conversation is delivered, either initiated by the business or in reply to a user message.

The businesses will be charged per 24-hour conversation. Within a 24 hour conversation session, businesses and users can exchange any number of free form messages or template messages under the same category without additional charges, given that the messages being sent do not initial a new conversation of another category.


Conversation Categories

CategoryTypeDescription
UtilityBusiness-initiatedFacilitate a specific, agreed-upon request or transaction or update to a customer about an ongoing transaction, including post-purchase notifications and recurring billing statements
AuthenticationBusiness-initiatedEnable businesses to authenticate users with one-time passcodes, potentially at multiple steps in the login process (e.g. account verification, account recovery, integrity challenges)
MarketingBusiness-initiatedInclude promotions or offers, informational updates, or invitations for customers to respond / take action. Any conversation that does not qualify as utility or authentication is a marketing conversation.
ServiceUser-initiatedMessages sent by the business in response to the customers' enquiries.

Pricing

Starting from 01/06/2023, the conversation charges will vary based on the template category. When a template is delivered, it opens a new chargeable conversation under that category, unless the template is delivered during an open conversation of the same category. Multiple templates of the same category within an open conversation will not result in additional charges.

Service conversations will still only be initiated when no other conversation window is open and a business responds with a free form message within the 24-hour customer service window.

Example

Scenario 1: Sending a marketing template inside a marketing conversation.
Chargeable Conversation: One marketing conversation.


Scenario 2: Sending a free form message inside a service conversation.
Chargeable Conversation: One service conversation.


However, if a template of a different category is sent within an open conversation, a separate chargeable conversation will be opened.

If a business replies with a template message in an open service conversation, this will also create a separate conversation based on the template category.

Example

Scenario 1: Sending a marketing template inside an utility conversation.
Chargeable Conversation: One utility conversation and one marketing conversation.


Scenario 2: Sending a authentication template inside a service conversation.
Chargeable Conversation: One service conversation and one authentication conversation.

The only exception is the Free Entry Point conversations, which allow businesses to send multiple templates of different categories within free window and no new conversation will be opened.

The rates for business-initiated and user-initiated conversations vary by country or region. For the detailed rates, please refer to the rate cards.


Free Entry Point

A Free Entry Point conversation is initiated when:

  • A customer using a device running Android or iOS messages the business via a Click to WhatsApp Ad or Facebook Page Call-to-Action button; and
  • The business respond within 24 hours

If you do not respond within 24 hours, a free entry point conversation is not opened and you must use a template to message the customer.

The free entry point conversation is opened as soon as your message is delivered and lasts 72 hours. When a free entry point conversation is opened, it automatically closes all other open conversations between you and the customer, and no new conversations will be opened until the free entry point conversation expires.

Once the free entry point conversation is opened, you can send any type of message to the customer without incurring additional charges. However, you can only send free-form messages if there is an open customer service window between you and the customer.

Example Scenario

If the customer messages you via a Click to WhatsApp Ad at 10am and you respond via a template message at 10pm the same day:

  • The free-entry point conversation starts at 10pm and lasts 72 hours.
  • You can send template messages at no charge in those 72 hours.
  • You can send free-form messages until 10am the next day, at which point the customer service window closes, as it is independent of the free entry point conversation (if the customer messages you again, however, it opens another 24 hour customer service window in which you can send free form messages).
Reminder

Although the business will be not charged for the free entry point conversation, but the business still needs to pay for the ad itself.


Free Tier

Changes to Free Tier Conversations: Effective June 1, 2023 This will not apply to businesses managed by Business Solution Providers, or businesses that did not rely on the services of a Meta partner to integrate the On-Premises API, until June 1, 2023. For all other accounts, this takes effect on April 1, 2023.

Each WhatsApp Business Account (WABA) can receive free tier conversations of 1000 user-initiated conversations each month, which is independent of the number of phone numbers attached to the WABA. The business-initiated conversation is not covered by the free tier. The free tier will be refreshed monthly based on the timezone associated with the WABA.

Reminder

This will not apply to businesses managed by Business Solution Providers, or businesses that did not rely on the services of a Meta partner to integrate the On-Premises API, until June 1, 2023.

For all other accounts, this takes effect on April 1, 2023.


Message Template

Message Templates are message formats for common reusable messages a business may want to send. Businesses must use Message Templates for sending notifications to customers. This allows a business to send just the template identifier along with the appropriate parameters instead of the full message content. Message templates will be submitted for review before being able to be sent, in order to ensure they do not violate the WhatsApp policies.

For message template, please refer to here for details.


Official Business Account

There are two types of WhatsApp Business Accounts:

NameDescription
Official Business AccountWhatsApp has verified that an authentic brand owns this account. An Official Business Account has a green checkmark badge in its profile and next to the header in the chat thread. The name of the business is visible even if the user hasn't added the business to their address book. Very few businesses will be an Official Business Account. Being verified on Facebook or Instagram will not help your business be an Official Business Account.
Business AccountAny account that is using the WhatsApp Business API is by default a Business Account.
Official Business Account with green tick
Official Business Account with green tick

If the WhatsApp Account is an Official Business Account, the Verified Name will be visible in the chat list, chat screens, chat groups, and contacts view instead of the phone number. There will be a

green checkmark
beside the displayed name in the contacts view.

To apply for an Official Business Account, WhatsApp requires businesses to complete Business Verification and enable Two-step Verification during WhatsApp Account Registration.

Business Verification

Facebook Business Manager Settings
Facebook Business Manager Settings

You will have to complete verification for your Facebook Business Manager, please refer to the steps given here. Once your business is verified, you will be able to see your business verification status as "verified".

Verified Facebook Business
Verified Facebook Business

Two-step Verification

You will also need to set up a code for two-step verification. You can create your two-step verification PIN right before the deployment of your WABA number.

Rate Limit

Messaging Limit

Messaging limits determine how many unique users your business can send messages to on a daily basis.

  • Tier 1: Allows your business to send messages to 1K unique customers in a rolling 24-hour period
  • Tier 2: Allows your business to send messages to 10K unique customers in a rolling 24-hour period
  • Tier 3: Allows your business to send messages to 100K unique customers in a rolling 24-hour period
  • Tier 4:Allows your business to send messages to unlimited unique customers in a rolling 24-hour period.

For details, please click here.

Throughput

The Cloud API supports up to 80 messages per second (mps) by default and up to 1,000 mps by request. Throughput is inclusive of inbound and outbound messages and all message types.

Reminder

If you would like to request for higher throughput limit for your phone number, please submit your request to support@woztell.com