Send a WhatsApp message
Sends a text, template, or media message addressed by phone number. The conversation is created or reused automatically. Free-form text and media require an open 24-hour customer-service window (since the contact last messaged you); approved templates can be sent anytime. Outside the window, text/media return 403 — send a template to re-engage.
Authorizations
User ID to act on behalf of. Platform API Keys only (required with an API Key unless the endpoint states otherwise). Requests authenticated with a Personal Access Token are rejected if this header names another user.
Body
Recipient address: a phone number (E.164 preferred, e.g. "+491234567890"; "00" prefixes and separators are normalized) or a WhatsApp business-scoped user id (BSUID, e.g. "US.13491208655302741918") for contacts who have adopted a WhatsApp username.
140"+491234567890"
Which kind of message to send.
text, template, media Contact name to set when a new conversation is created for this number.
255Message body. Required when type is text.
4096"Hi! Your order has shipped."
Template payload. Required when type is template.
Media payload. Required when type is media.
Response
Message accepted by WhatsApp.
meetergo message id.
Conversation this message belongs to.
WhatsApp's own message id (wamid).
inbound, outbound Message kind (text, image, document, template, ...).
Delivery status. Inbound messages are always delivered.
pending, sent, delivered, read, failed When the message was created (ISO 8601).
Text body, or the caption for a media message.
URL of the attached media, if any.
MIME type of the attached media.
Filename of the attached document.
Template name, for template messages.
Failure reason from WhatsApp, set when status is failed.