Skip to main content
POST
/
api
/
v1
/
conversations
/
{id}
/
messages
cURL
curl --request POST \
  --url https://backend.wassist.app/api/v1/conversations/{id}/messages/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "type": "text",
  "text": {
    "body": "<string>"
  },
  "template": {
    "name": "<string>",
    "variables": {
      "body": [
        "<string>"
      ],
      "header": "<string>",
      "buttons": [
        "<string>"
      ],
      "cards": [
        {
          "body": [
            "<string>"
          ],
          "header": "<string>",
          "buttons": [
            "<string>"
          ]
        }
      ]
    }
  }
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "role": "<string>",
  "type": "<string>",
  "status": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "text": "<string>",
  "image": "<string>",
  "ctaButton": "<string>",
  "listSelection": "<string>",
  "template": "<string>"
}
Send a message to an existing conversation on behalf of your agent.

​
Message Types

You can send two types of messages:
  • Regular messages — Free-form text responses to active conversations
  • Template messages — Pre-approved messages that can initiate or re-engage conversations
Check conversation status first! You can only send regular (non-template) messages to active conversations. Use the Get Conversation endpoint to verify the conversation is active before sending.
Billing: Template messages are billed by Meta according to their pricing tiers. Regular messages within the 24-hour customer service window are free.

Authorizations

​
X-API-Key
string
header
required

API key authentication. Pass your API key in the X-API-Key header.

Path Parameters

​
id
string
required

Body

application/json

Unified input for sending text or template messages.

​
type
enum<string>
required

The type of message to send. 'text' for text messages, 'template' for template messages.

  • text - text
  • template - template
Available options:
text,
template
​
text
object
​
template
object

Response

201 - application/json
​
id
string<uuid>
required
​
role
string
required
​
type
string
required
​
status
string | null
required
​
createdAt
string<date-time>
required
​
text
string
required
​
image
string
required
​
ctaButton
string
required
​
listSelection
string
required
​
template
string
required