Этот метод позволяет редактировать ранее отправленные текстовые сообщения без отправки нового сообщения в чат. Он полезен, когда нужно исправить ошибку, обновить цену, статус заказа, ссылку или другую информацию в уже отправленном сообщении. Для редактирования используется ID сообщения, полученный при отправке через API или при получении сообщений. Метод работает только для мессенджеров, которые поддерживают редактирование сообщений на стороне канала.
Поддерживаемые мессенджеры
Метод API редактирования сообщений доступен для следующих мессенджеров: Telegram Personal, Telegram Bot, MAX Personal, MAX Bot.
Пример запроса:
GET https://wamm.chat/api2/msg_edit/{token}/{msg_id}?text={text}Параметры запроса
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| token | string | Да | API-токен, полученный в настройках |
| msg_id | integer | Да | ID сообщения, которое необходимо отредактировать |
| text | string | Да | Новый текст сообщения в кодировке UTF-8, закодированный функцией urlencode. Для переноса текста на новую строку используйте в тексте %0A.Параметр можно передавать в GET или POST. Максимальная длина: 4500 символов для Telegram Personal, Telegram Bot и MAX Bot; 4000 символов для MAX Personal. |
Ответ при успехе
{"err":0,"result":"success"}Возможные ошибки
| Код ошибки | Описание |
|---|---|
| token fail | Ошибка в токене |
| acc not authorized | Канал не авторизован или не готов к работе |
| Channel type is not support this method | Канал не поддерживает редактирование сообщений |
| msg_id fail | Не указан или некорректно указан ID сообщения |
| text fail | Пустой текст сообщения |
| text fail, more 4500 | Текст слишком большой, превышает 4500 символов |
| text fail, more 4000 | Текст слишком большой для MAX Personal, превышает 4000 символов |
| mgi_id fail, not found | Сообщение не найдено в текущем канале |
| fail editing | Мессенджер не подтвердил редактирование сообщения |
Примеры использования
curl -G "https://wamm.chat/api2/msg_edit/YOUR_TOKEN/1234567/" \
--data-urlencode "text=Обновленное сообщение"