WhatsApp V4

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.

post/v4/whatsapp/messages

Request

  • Base URL: https://developer.meetergo.com (the document declares no server; this is the origin it was published from)
  • URL: https://developer.meetergo.com/v4/whatsapp/messages
  • Auth: one of:
    • API key in header x-meetergo-api-user-id
    • HTTP bearer
    • HTTP bearer

Request body

tostring required

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.

type'text' | 'template' | 'media' required

Which kind of message to send.

contactNamestring

Contact name to set when a new conversation is created for this number.

textstring

Message body. Required when type is text.

Example request

{
  "to": "+491234567890",
  "text": "Hi! Your order has shipped.",
  "template": {
    "name": "appointment_reminder",
    "language": "en_US",
    "params": [
      "John",
      "Tuesday at 10:00"
    ],
    "buttonUrlParams": {
      "0": "cancel/abc123"
    }
  },
  "media": {
    "url": "https://files.example.com/invoice.pdf",
    "mimeType": "application/pdf",
    "filename": "invoice.pdf"
  }
}

Response

Message accepted by WhatsApp.

idstring required

meetergo message id.

conversationIdstring required

Conversation this message belongs to.

waMessageIdstring required

WhatsApp's own message id (wamid).

direction'inbound' | 'outbound' required
typestring required

Message kind (text, image, document, template, ...).

status'pending' | 'sent' | 'delivered' | 'read' | 'failed' required

Delivery status. Inbound messages are always delivered.

textstring

Text body, or the caption for a media message.

mediaUrlstring

URL of the attached media, if any.

mediaMimeTypestring

MIME type of the attached media.

mediaFilenamestring

Filename of the attached document.

templateNamestring

Template name, for template messages.

errorMessagestring

Failure reason from WhatsApp, set when status is failed.

createdAtstring date-time required

When the message was created (ISO 8601).

Changes

No recorded changes to this operation across all 1 revision of this API.