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 '
{
  "unified": {
    "text": "<string>",
    "footer": "<string>",
    "buttons": [
      {
        "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>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.wassist.app/llms.txt

Use this file to discover all available pages before exploring further.

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
read-only
​
role
string
required
read-only
​
type
string
required
read-only
​
status
string | null
required
​
createdAt
string<date-time>
required
​
replyTo
string
required
read-only
​
text
string
required
read-only
​
image
string
required
read-only
​
cta
string
required
read-only
​
listSelection
string
required
read-only
​
template
string
required
read-only
​
unified
string
required
read-only
​
quickReply
string
required
read-only