Messages

You can use the WhatsApp Business API to send text messages, media/documents, and message templates to your customers. You should use the /messages endpoint to send those.

This page provides an overview of how messages work on the WhatsApp Business API.

Using the API

Currently, we support sending two types of messages:

User-Initiated Messages

You can send customer care responses to user-initiated messages. You may respond to user messages with any type of message within 24 hours of message receipt. This 24-hour period is known as the response window:

There are no charges for these messages.

Business-Initiated Messages

At any time, you can send business-initiated messages to customers who have opted-in. Throughout the documentation, these messages are also called notifications, message templates, or templated messages.

When sending business-initiated messages, you are required to use a pre-approved message template, which can be text-based, media-based, or interactive. Your template must fall under one of the following categories:


When sending notifications, you pay per delivered message. Messages are priced based on how many notifications businesses send within each market. Pay progressively lower prices as message volume increases.

For more information, see Sending Message Templates.

Message Types

You can send the following message types using the API:

Example

When a message is successfully sent in a request, the customer receives a message such as this:

Received Messages

This image displays messages of the following types, from top to bottom:

  1. Text message
  2. Text message with a URL
  3. Message template
  4. Media message