RASL | Messages

The Messages API supports text, media, template, and interactive messages, along with message history retrieval and detailed tracking.

24-Hour Customer Service Window (Meta Policy)

WhatsApp applies a 24-hour customer service window rule:

The window starts (or refreshes) whenever a user sends a message to your business.

During this 24-hour window, you may send free-form text and media messages.

After the window expires, free-form messages will not be delivered.

To communicate outside the 24-hour window, you must use approved template messages.

Required Scope: messages:send

The following endpoints are available for sending messages:

POST /messages/text
Send plain text messages within the 24-hour customer service window.

POST /messages/media
Send media messages including images, videos, documents, and audio files.

POST /messages/template
Send pre-approved WhatsApp template messages at any time.

POST /messages/interactive
Send interactive messages such as quick reply buttons or structured lists.

Required Scope: messages:read

GET /messages
Retrieve message history with filtering, sorting, and search capabilities.

GET /messages/{id}
Retrieve detailed information about a specific message.

All sending endpoints automatically create a contact if the provided phone number does not already exist in your tenant.

This ensures seamless messaging without requiring manual contact creation.

Text and template messages support dynamic merge fields.

Example: Hello @{contact_first_name}

Merge fields are automatically replaced with contact data at send time.

All sending endpoints return a structured response with message status and metadata.

Rate limits may apply per tenant.

Provider-level limits (Meta/WhatsApp) may also apply independently.