Search Results

Sending messages Updated: Nov 4, 2025 This document describes how to use the API to send messages to WhatsApp users. Message types You can use the API to send the following types of messages. Address messages allow you to easily request a delivery addres...

Audio messages Updated: Feb 17, 2026 On March 17th, 2026, voice messages will start receiving a “played” status webhook the first time a WhatsApp user plays a voice message shared by the business. You can use Cloud API to send voice messages and basic audio me...

Contacts messages Updated: Nov 3, 2025 Contacts messages allow you to send rich contact information directly to WhatsApp users, such as names, phone numbers, physical addresses, and email addresses. When a WhatsApp user taps the message's profile arrow, it dis...

Document messages Updated: Nov 3, 2025 Document messages are messages that display a document icon, linked to a document, that a WhatsApp user can tap to download. Request parameters Placeholder Description Example Value <ACCESS_TOKEN> String Required. Syst...

Image messages Updated: Nov 3, 2025 Image messages are messages that display a single image and an optional caption. Request parameters Placeholder Description Example Value <ACCESS_TOKEN> String Required. System token or business token. EAAAN6tcBzAUBOZC82C...

Interactive Call-to-Action URL Button Messages Updated: Nov 3, 2025 WhatsApp users may be hesitant to tap raw URLs containing lengthy or obscure strings in text messages. In these situations, you may wish to send an interactive call-to-action (CTA) URL button ...

Interactive list messages Updated: Nov 3, 2025 Interactive list messages allow you to present WhatsApp users with a list of options to choose from (options are defined as rows in the request payload): When a user taps the button in the message, it displays a m...

Interactive media carousel messages Updated: Dec 22, 2025 Interactive media carousel messages display a set of horizontally scrollable media cards. Each card can display an image or video header, body text, and either quick-reply buttons or a URL button. For ...

Location messages Updated: Nov 3, 2025 Location messages allow you to send a location's latitude and longitude coordinates to a WhatsApp user. Request parameters Placeholder Description Example Value <ACCESS_TOKEN> String Required. System token or business ...

Location request messages Updated: Nov 3, 2025 Location request messages display body text and a send location button. When a WhatsApp user taps the button, a location sharing screen appears which the user can then use to share their location. Once the user sh...

Reaction messages Updated: Nov 3, 2025 Reaction messages are emoji-reactions that you can apply to a previous WhatsApp user message that you have received. Limitations When sending a reaction message, only a sent message webhook ( status set to sent) will be ...

Template MessagesUpdated: Nov 4, 2025Template messages are used to send templates to WhatsApp users. Templates can cover customer care messages, appointment reminders, payment and shipping updates, and much more.Templates are reusable and can be sent to WhatsA...

Text messages Updated: Nov 3, 2025 Text messages are messages containing only a text body and an optional link preview. Link preview You can have the WhatsApp client attempt to render a preview of the first URL in the body text string, if it contains one....

Video Messages Updated: Nov 3, 2025 Video messages display a thumbnail preview of a video image with an optional caption. When the WhatsApp user taps the preview, it loads the video and displays it to the user. Supported Video Formats Only H.264 video cod...

Mark messages as read Updated: Nov 3, 2025 When you get a messages webhook indicating an incoming message, you can use the message.id value to mark the message as read. It's good practice to mark an incoming messages as read within 30 days of receipt. Marking...

Contextual replies Updated: Oct 21, 2025 Contextual replies are a special way of responding to a WhatsApp user message. Sending a message as a contextual reply makes it clearer to the user which message you are replying to by quoting the previous message in a...

Address Messages Updated: Nov 7, 2025 This feature is only available for businesses based in India and their India customers. Address messages give your users a simpler way to share the shipping address with the business on WhatsApp. Address messages are int...