Search Results

Sending messagesUpdated: Nov 4, 2025This document describes how to use the API to send messages to WhatsApp users.Message typesYou can use the API to send the following types of messages.Address messages allow you to easily request a delivery address from What...

Audio messagesUpdated: Feb 17, 2026On 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 messa...

Contacts messagesUpdated: Nov 3, 2025Contacts 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 displa...

Document messagesUpdated: Nov 3, 2025Document messages are messages that display a document icon, linked to a document, that a WhatsApp user can tap to download.Request syntaxUse the POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages endpoint to send a documen...

Image messagesUpdated: Nov 3, 2025Image messages are messages that display a single image and an optional caption.Request syntaxUse the POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages endpoint to send an image message to a WhatsApp user.curl 'https://graph....

Interactive Call-to-Action URL Button MessagesUpdated: Nov 3, 2025WhatsApp 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 me...

Interactive list messagesUpdated: Nov 3, 2025Interactive 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 moda...

Interactive media carousel messagesUpdated: Dec 22, 2025Interactive 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 exam...

Interactive reply buttons messagesUpdated: Nov 3, 2025Interactive reply buttons messages allow you to send up to three predefined replies for users to choose from.Users can respond to a message by selecting one of the predefined buttons, which triggers a messa...

Location messagesUpdated: Nov 3, 2025Location messages allow you to send a location’s latitude and longitude coordinates to a WhatsApp user.Request syntaxUse the POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages endpoint to send a location message to a WhatsA...

Location request messagesUpdated: Nov 3, 2025Location 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 shar...

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

Sticker messagesUpdated: Nov 3, 2025Sticker messages display animated or static sticker images in a WhatsApp message.Request syntaxUse the POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages endpoint to send a sticker message to a WhatsApp user.curl 'https://gr...

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 messagesUpdated: Nov 3, 2025Text messages are messages containing only a text body and an optional link preview.Request syntaxUse the POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages endpoint to send a text message to a WhatsApp user.curl 'https://graph...

Video MessagesUpdated: Nov 3, 2025Video 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.Sending Video MessagesUse the POST /<WHATSAPP_BUSINE...

Mark messages as readUpdated: Nov 3, 2025When 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 a m...

Contextual repliesUpdated: Oct 21, 2025Contextual 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 co...