Messages

Updated September 7, 2026

On this page

Sends a message into an existing conversation on behalf of an operator. The customer receives it in their channel: the on-site widget or a messenger. This lets your system message customers automatically — order statuses, reminders, your bot's replies.

POST /messages

Field	Type	Description
conversationId	string, required	Conversation ID from GET /conversations
text	string, required	Message text, up to 10,000 characters
author	string	Author name shown in history (e.g. “Orders bot”)

Request example

curl -X POST https://api.chatva.app/v1/messages \
  -H "Authorization: Bearer ch_live_9f3ka2" \
  -H "Content-Type: application/json" \
  -d '{
    "conversationId": "cv_018f3a",
    "text": "Your order 4417 is with the courier, arriving today by 18:00",
    "author": "Orders bot"
  }'

Response 201

{
  "id": "m_5601",
  "conversationId": "cv_018f3a",
  "from": "operator",
  "author": "Orders bot",
  "text": "Your order 4417 is with the courier, arriving today by 18:00",
  "createdAt": "2026-09-07T12:05:00Z"
}

Limitations

You cannot create a new conversation: the client always writes first, the API appends to existing threads.
A closed conversation stays closed when you send a message — the client sees the reply on their next visit.
Attachments are not supported yet, text only.