Messages

This overview outlines how messages work on WhatsApp Business accounts.

Messages and Conversations

A conversation is a 24-hour messaging thread initiated by sending messages between you and your customer, which is also the basis for WhatsApp pricing.

Businesses initiate conversations by sending free-form messages or template messages. You can refer to Pricing to understand how conversations are initiated and ended, and how they affect WhatsApp's pricing model.

Outbound Messages

Message Types

When communicating with customers via WhatsApp, you can use two types of messages:

  • Message Templates: To initiate a conversation with a customer, you need to use pre-created, pre-approved message templates. These templates can be approved by WhatsApp within an hour and support multiple message types.

  • Free-form Messages: These are custom messages that support all media types. You can use free-form messages to communicate with customers within the 24-hour service window, which include:

  • Text Messages - Plain text messages that can contain letters, numbers, and symbols.

  • Media Messages - Messages that include media files such as images, videos, audio, documents, and stickers.

  • Contact Messages - Messages that include contact information such as names and phone numbers.

  • Location Messages - Messages that include the user's geographical location.

  • Interactive Messages - Messages that allow users to interact with the content. For example, list messages display a list of items users can choose from, reply button messages allow users to respond with a set of predefined options, single and multiple product messages allow users to browse and purchase products within the messaging app.

Message Status

For each message you send, notifications about the status of that message will be sent to your webhook callback.

table image

The order of these notifications in your application may not reflect the actual timing of the message status. If necessary, check the timestamps to determine the timing.

Inbound Messages

Message Types

When using WhatsApp for two-way communication, you will receive inbound messages in real-time. These messages can take various forms, such as:

  • Text Messages

  • Location Messages

  • Media Messages, including images, audio, voice, video, and documents

  • Messages sent after clicking quick reply buttons/list buttons

Frequently Asked Questions