This article covers sending messages, tracking status updates, and editing or deleting messages.

List of Methods

• POST /v2/messages — Send a message.
• PATCH /v2/messages/{message_id} — Edit a message.
• DELETE /v2/messages/{message_id} — Delete a message (supported transports only).
• POST /v2/messages/messages_dump — Create a job to download messages for a period.
• GET /v2/messages/messages_dump/{export_id} — Find out the status of the message download.

Sending a Message

Message sending is asynchronous. Upon successful submission, you receive a request_id. The presence of a request_id does not guarantee delivery — it simply indicates that Wazzup has accepted your message for processing. The final outcome and the actual message_id will be delivered via a webhook that updates the message status.

You cannot include both text (text parameter) and an attachment (attachment) in a single send request. Doing so will return the error: "Cannot provide more than one of text, attachment or template". Use separate requests to send text and a file.

recipient (object)

attachment (object)

template (object)

keyboard (object)

curl -L 'https://tech.wazzup24.com/v2/messages' \
-H 'Authorization: Bearer <client_access_token>' \
-H 'Content-Type: application/json' \
-d '{
"channel_id": "020e3f61-e5df-447f-8ef9-ce8258e92c7a",
"recipient": {
"chat_type": "whatsapp",
"chat_id": "79999999999"
},
"text": "Hello World"
}'

curl -L 'https://tech.wazzup24.com/v2/messages' \
-H 'Authorization: Bearer <client_access_token>' \
-H 'Content-Type: application/json' \
-d '{
"channel_id": "020e3f61-e5df-447f-8ef9-ce8258e92c7a",
"recipient": {
"chat_type": "whatsapp",
"chat_id": "37193850059"
},
"attachment": {
"url": "https://drive.google.com/uc?export=download&id=123456test",
"name": "new.pdf",
"mimetype": "application/pdf",
"size": 86176,
"sha1": "153e030466873745ce4a66da02d0610a7ee6ce4f"
},
"crm_user_id": "crm-123"
}'

curl -L 'https://tech.wazzup24.com/v2/messages' \
-H 'Authorization: Bearer <client_access_token>' \
-H 'Content-Type: application/json' \
-d '{
"channel_id": "020e3f61-e5df-447f-8ef9-ce8258e92c7a",
"recipient": {
"chat_type": "whatsapp",
"chat_id": "37193850059"
},
"template": {
"id": "385bf0c5-9f2a-4f9f-be85-9b84d797cf95",
"values": [
"https://drive.google.com/uc?export=download&id=123456test"
]
},
"buttons": [
{
"text": "Thank you!",
"type": "text",
"payload": "yes"
},
{
"text": "I need more!",
"type": "text",
"payload": "yes"
},
{
"text": "I need even more!",
"type": "text",
"payload": "yes"
}
]
}'

Response example:

{
"data": {
"request_id": "9820d14f-66ae-4170-997f-0f06c0800664",
"chat_id": 79385005913
},
"meta": {
"timestamp": 1759492896
}
}

Result: The send request has been accepted. You will receive a webhook with the delivery status.

Edit a Message

Editing is supported on the following channels:

• Whatsapp Web (text only)
• Telegram Personal
• Telegram Bot
• MAX
• MAX bot (except messages with keyboard)

Messages can be edited within 15 minutes of delivery. Learn more about how message editing works in our guide.

Path Parameters
message_id — ID of the message to be edited.

Example:

curl -L -X PATCH 'https://tech.wazzup24.com/v2/messages/8e074add-828d-4f35-afcc-99ccbfa9d0ae' \
-H 'Authorization: Bearer <client_access_token>' \
-H 'Content-Type: application/json' \
-d '{
"text": "Edited message"
}'

Response example:

{
"data": {
"message_id": "8e074add-828d-4f35-afcc-99ccbfa9d0ae",
"chat_id": "1234567890"
},
"meta": {
"timestamp": 1759397203
}
}

Result: Message message_id: 8e074add-828d-4f35-afcc-99ccbfa9d0ae has been edited.

Delete a Message

Message deletion is supported on the following channels:

• Whatsapp
• Telegram Personal
• Telegram Bot
• MAX
• MAX bot

When a message is deleted, it is removed from the messenger for both the sender and the recipient. In the Wazzup iframe, the message will still appear but will be marked as deleted.

Learn more about how message deletion works in our guide.

Path Parameters
message_id — ID of the message to be deleted.

Example:

curl -L -X DELETE 'https://tech.wazzup24.com/v2/messages/8a3f7a93-2b25-45da-8695-671bd56439e5' \
-H 'Authorization: Bearer <client_access_token>'

Response example:

{
"data": {
"message_id": "8a3f7a93-2b25-45da-8695-671bd56439e5",
"chat_id": "1234567890"
},
"meta": {
"timestamp": 1759397203
}
}

Result: Message message_id: 8a3f7a93-2b25-45da-8695-671bd56439e5 has been deleted.

Export messages

The method creates a job to export messages for the specified period.

Request parameters

Request example:

{
  "start_at": "2025-01-01T00:00:00.000Z",
  "end_at": "2025-01-31T23:59:59.999Z",
  "channel_id": "6a200e75-b1e6-4c92-950b-31801a31aa95"
}

Response example:

{
  "data": {
    "status": "pending",
    "export_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  },
  "meta": {
    "timestamp": 1777885780
  }
}

Result: A job is created. When the export is ready, a link to a CSV file with messages will be sent in the webhook.

Check message export status

Path parameter

export_id — Job ID. Returned in the response to the POST /v2/messages/messages_dump request

Response example

{
  "data": {
    "status": "pending",
    "url": null
  },
  "meta": {
    "timestamp": 1777974260
  }
}

Result: The job status is returned in the status field. Possible values:

• pending — queued,
• processing — in progress,
• done — export is ready,
• webhook_failed — export is ready but failed to send: an error is returned.

If the status is done or webhook_failed, a link to the export is also provided in the url field of the response.