Перейти к содержимому

editMessage

Обновлено 17 октября 2026

Содержание
  1. Параметры
  2. Пример запроса
  3. Пример ответа
  4. Ошибки
  5. Особенности каналов
  6. Что дальше

Меняет текст своего отправленного сообщения. Собеседник увидит исправленный текст с пометкой «изменено». Gratio обновляет текст и в журнале: getChatHistory и getMessage вернут новый.
Запрос POST /waInstance{idInstance}/editMessage/{apiTokenInstance}
Тело JSON
Каналы MAX, Telegram, WhatsApp. Почта — 501

Параметры

Параметр Тип Обязательный Описание
chatId string да чат сообщения — адрес из уведомления или истории. Поиска по номеру здесь нет
idMessage string да своё сообщение — idMessage из ответа на отправку
message string да новый текст

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

Исправить время в подтверждении записи, MAX:

curl

curl -X POST "$GRATIO_URL/waInstance$GRATIO_ID/editMessage/$GRATIO_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "chatId": "8695836",
    "idMessage": "117428956522361912",
    "message": "Записали вас на субботу, 12:00."
  }'

Python

import os
import requests

BASE = f"{os.environ['GRATIO_URL']}/waInstance{os.environ['GRATIO_ID']}"
TOKEN = os.environ["GRATIO_TOKEN"]

url = f"{BASE}/editMessage/{TOKEN}"
payload = {
    "chatId": "8695836",
    "idMessage": "117428956522361912",
    "message": "Записали вас на субботу, 12:00.",
}
response = requests.post(url, json=payload, timeout=60)
print(response.status_code, response.json())

Node.js

const { GRATIO_URL, GRATIO_ID, GRATIO_TOKEN } = process.env;
const base = `${GRATIO_URL}/waInstance${GRATIO_ID}`;

const url = `${base}/editMessage/${GRATIO_TOKEN}`;
const payload = {
  chatId: "8695836",
  idMessage: "117428956522361912",
  message: "Записали вас на субботу, 12:00.",
};
const response = await fetch(url, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify(payload),
});
console.log(response.status, await response.json());

PHP

<?php
$base = getenv('GRATIO_URL') . '/waInstance' . getenv('GRATIO_ID');
$url = $base . '/editMessage/' . getenv('GRATIO_TOKEN');
$payload = [
    'chatId' => '8695836',
    'idMessage' => '117428956522361912',
    'message' => 'Записали вас на субботу, 12:00.',
];

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode($payload, JSON_UNESCAPED_UNICODE),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 60,
]);
$response = json_decode(curl_exec($ch), true);
echo curl_getinfo($ch, CURLINFO_HTTP_CODE), PHP_EOL;
print_r($response);

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

Ответ 200 OK:

{"idMessage": "117428956522361912"}

idMessage не меняется: правка не создаёт нового сообщения.

Ошибки

Код code Когда Что делать
400 validation нет chatId, idMessage или message; адрес чата или id не этого канала исправить запрос
400 not_authorized канал не на связи проверить getStateInstance
400 not_found сообщения нет в этом чате проверить chatId и idMessage
400 not_own WhatsApp: сообщение не ваше править можно только свои
400 edit_window WhatsApp: прошло больше 15 минут отправить исправление новым сообщением
400 edit_expired Telegram: срок правки истёк отправить исправление новым сообщением
400 not_modified Telegram: текст не изменился —
400 код площадки площадка отказала в правке см. message
402 payment_required канал на паузе за неоплату продлить канал в кабинете
501 not_supported канал почты отправленное письмо не изменить

Особенности каналов

Канал Что можно править
MAX свои сообщения
Telegram свои сообщения, пока Telegram разрешает правку
WhatsApp свои сообщения, в течение 15 минут после отправки; сообщения, которые канал видел с момента привязки
Почта ничего: 501

Что дальше

  • deleteMessage — удалить сообщение.
  • Правка — как приходят правки собеседника.
  • getCapabilities — поле edit показывает, умеет ли канал правку.

Была ли статья полезна?

Похожие статьи