В статье рассказываем про отправку, обновление статуса, редактирование и удаление сообщений.

Методы

• POST /v2/messages — отправить сообщение.
• PATCH /v2/messages/{message_id} — редактировать сообщение.
• DELETE /v2/messages/{message_id} — удалить сообщение (только для поддерживаемых транспортов).

Отправка сообщения

Отправка сообщений асинхронна. В случае успешной отправки, вы получаете request_id. Наличие request_id не гарантирует доставку, оно сообщает о том что Wazzup принял ваше сообщение в обработку. Итог обработки и реальный message_id вы получите с вебхуком, обновляющим статус сообщения.

В одном запросе на отправку сообщения нельзя передать одновременно текст (параметр text) и вложение (attachment). При таком запросе вернется ошибка: "Cannot provide more that one of text, attachment or template". Используйте разные запросы, чтобы отправить текст и файл.

Метод POST /v2/messages

Параметры:

Пример отправки текстового сообщения:

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": "79385005913"
},
"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": "79385005913"
},
"template": {
"id": "385bf0c5-9f2a-4f9f-be85-9b84d797cf95",
"values": [
"https://drive.google.com/uc?export=download&id=123456test"
]
},
"buttons": [
{
"text": "Спасибо!",
"type": "text",
"payload": "yes"
},
{
"text": "Мне нужно еще!",
"type": "text",
"payload": "yes"
},
{
"text": "Мне нужно еще 2!",
"type": "text",
"payload": "yes"
}
]
}'

Пример ответа:

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

Результат: Запрос на отправку принят. Вы получите вебхук со статусом доставки.

Редактировать сообщение

Каналы, на которых доступно редактирование:

• Whatsapp Web (только текст)
• Telegram Personal
• Telegram Bot
• MAX
• бот MAX (кроме сообщений с клавиатурой)

Редактировать сообщение можно в течение 15 минут после доставки. Узнайте в нашей инструкции больше о том, как работает редактирование сообщений.

Метод PATCH /v2/messages/{message_id}

Path-параметры
message_id — ID сообщения, которое нужно изменить.

Пример:

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": "Отредактированное сообщение"
}'

Пример ответа:

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

Результат: Сообщение message_id: 8e074add-828d-4f35-afcc-99ccbfa9d0ae отредактировано.

Удалить сообщение

Каналы, на которых доступно удаление сообщений:

• Whatsapp
• Telegram Personal
• Telegram Bot
• MAX
• бот MAX

Сообщение удаляется в мессенджере у отправителя и собеседника. При этом в iframe Wazzup сообщение будет отображаться с отметкой, что удалено.

Узнайте в нашей инструкции больше о том, как работает удаление сообщений.

Метод DELETE /v2/messages/{message_id}

Path-параметры
message_id — ID сообщения, которое нужно удалить.

Пример:

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

Пример ответа:

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

Результат: Сообщение message_id: 8a3f7a93-2b25-45da-8695-671bd56439e5 удалено.

*Запрещены и признаны экстремистскими на территории РФ