v1

latestOpenAPI 3.0.22026-08-045831103.6 KB

Messages

Send text message

Send a text message via WhatsApp Official. Reuses the existing message sending flow — validates channel account, contact, and messaging window, then dispatches to the WhatsApp provider. Returns immediately with QUEUED status.

post/v2/messages/text

Headers

api-tokenstring required

API Token

Request body

channel_account_idstring uuid required

UUID of the WhatsApp Official channel account

contact_idstring uuid required

UUID of the contact to send the message to

messagestring required

Text content of the message

chat_idstring uuid

Optional UUID of an existing chat. If not provided, the system will find or create a chat automatically.

Example request

{
  "channel_account_id": "550e8400-e29b-41d4-a716-446655440001",
  "contact_id": "550e8400-e29b-41d4-a716-446655440002",
  "message": "Hello, how can I help you?",
  "chat_id": "550e8400-e29b-41d4-a716-446655440003"
}

Response

Message queued for sending

statusinteger

Example response

{
  "status": 200,
  "data": {
    "success": true,
    "message_id": "550e8400-e29b-41d4-a716-446655440099",
    "chat_id": "550e8400-e29b-41d4-a716-446655440003",
    "status": "QUEUED"
  }
}