Сообщения

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

Методы

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

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

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

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

recipient (объект)

attachment (объект)

template (объект)

keyboard (объект)

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 минут после доставки. Узнайте в нашей инструкции больше о том, как работает редактирование сообщений.

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 сообщение будет отображаться с отметкой, что удалено.

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

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 удалено.

Выгрузить сообщения

Метод создает задачу на выгрузку сообщений за указанный период.

Перед отправкой запроса подпишитесь на вебхук messages_dump.status_update, чтобы получить выгрузку, когда она будет готова.

Параметры запроса

Пример запроса:

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

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

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

Результат: Создана задача. Когда выгрузка будет готова, в вебхуке messages_dump.status_update придет ссылка на CSV-файл с сообщениями. 

Проверить статус выгрузки сообщений

Path-параметр

export_id — идентификатор задачи. Приходит в ответе на запрос POST /v2/messages/messages_dump 

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

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

Результат: Получен статус задачи в поле status. Возможные значения:

• pending — в очереди,
• processing — в работе,
• done — выгрузка готова,
• webhook_failed — выгрузка готова, но не удалось отправить: получаем в ответ ошибку.

Если статус done или webhook_failed, то в ответе также придет ссылка на выгрузку в поле url.

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