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>"
          ]
        }
      ]
    }
  },
  "cta": {
    "body": "<string>",
    "buttonText": "<string>",
    "url": "<string>",
    "image": {
      "url": "<string>"
    }
  },
  "unified": {
    "text": "<string>",
    "footer": "<string>",
    "media": {
      "url": "<string>"
    },
    "buttons": [
      {
        "type": "url",
        "text": "<string>",
        "url": "<string>",
        "quickReplyId": "<string>"
      }
    ]
  }
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "role": "<string>",
  "type": "<string>",
  "status": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "replyTo": "<string>",
  "text": "<string>",
  "image": "<string>",
  "cta": "<string>",
  "listSelection": "<string>",
  "template": "<string>",
  "unified": "<string>",
  "quickReply": "<string>"
}
Send a message to an existing conversation on behalf of your agent.

​
Message Types

You can send two main types of messages:
  • Unified messages — Sent rich text messages with images, videos, audio, documents, buttons, and more
  • Template messages — Pre-approved messages that can initiate or re-engage conversations
You can additionally send cta and text speicic messages, though these are deprecated and will be removed in the future. We will be adding support for other specific message types, such as contacts, location and call requests in the future.
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, template, or CTA URL messages.

​
type
enum<string>
required

The type of message to send: 'text', 'template', 'cta', or 'unified'.

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

Response

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