Skip to main content
Every message you send through the API uses the message format: a type and a content. This page shows, for WhatsApp, what each type looks like for your contact and the exact message object to send, with POST /conversations or POST /conversations/{id}/messages.
Except templates, these messages are only delivered within the 24-hour window opened by the contact’s last message.

Text

A text of up to 4,096 characters. When the text contains a URL starting with http:// or https://, WhatsApp shows a preview of the first one, or a clickable link when no preview is available. To send the link without its preview, set preview_url to false.
A text message on WhatsApp

Reply buttons

Up to three buttons the contact taps to answer. Each button has an id (up to 256 characters, returned to you when the contact taps it) and a title (up to 20 characters).
A message with reply buttons
When the contact taps a button, their choice comes back as a message, received by the agent and by your message.received webhook.
The contact's choice
"type": "quick_reply" is an alias of button: same action, same limits, shown on WhatsApp as reply buttons.

List

A menu of options grouped in sections. The contact taps the button to open the list, then picks one option.
A list message
Tapping the button opens the options:
The options of a list
The chosen option comes back as a message, received by the agent and by your message.received webhook, as for reply buttons.
The contact's selection
One button that opens a URL: a payment page, a tracking page, a form.

Media

Images, videos, documents and voice or audio files, from a public URL Shortext downloads.
The caption (up to 1,024 characters) is shown under images, videos and documents; audio messages have none. WhatsApp applies its own limits on the size and the formats of media files. A sticker is a WebP image of 512 x 512 pixels, 100 KB at most (500 KB animated), sent without caption:

Location

A position on a map. With a name and an address, WhatsApp shows them with the position.

Contact card

A contact card the customer can save, with 1 to 5 numbers.
Fields and rendering on the other channels: Message format.

Template

The only message you can send outside the 24-hour window: an approved model, with its header, its variables and its buttons. Give the value of its dynamic buttons in content.buttons ({ "0": "A-1042" }) and, for an authentication template, the code in content.code. See Send a WhatsApp template.

WhatsApp Flow

Opens a WhatsApp Flow you built in Meta Business Manager: a multi-screen form (booking, sign-up, survey) inside WhatsApp.

Payment request

Asks the contact to pay an amount. You give the amount; Shortext creates the payment link and sends a message with a Pay button leading to its secure payment page.
The button reads “Pay ”. Without a header, Shortext adds an image header with the order reference. Do not send display_text or url: Shortext builds the button.
callback_url is deprecated and will be removed: it no longer receives a signed notification. To be told when the contact pays, subscribe a webhook endpoint to payment.succeeded.
Several cards the contact swipes, each with an image or a video, a text and a link button. content.action is passed to WhatsApp as is: use the action object of Meta’s interactive carousel message.
Each card needs a header of type image or video and a body text of up to 160 characters.