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

getMessage

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

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

Отдаёт одно сообщение по idMessage. Нужен, когда у вас есть только id: например, stanzaId из цитаты или реакции, а текста исходного сообщения нет.
Запрос POST /waInstance{idInstance}/getMessage/{apiTokenInstance}
Тело JSON
Каналы MAX, Telegram, WhatsApp, почта

Параметры

Параметр Тип Обязательный Описание
chatId string да чат, в котором сообщение, — id в этом канале, см. Идентификаторы чатов и сообщений
idMessage string да id сообщения: MAX — число строкой, Telegram — номер сообщения в чате, WhatsApp — 3EB0…, письмо — 20 знаков

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

Сообщение Марии, на которое пришла реакция:

curl

curl -X POST "$GRATIO_URL/waInstance$GRATIO_ID/getMessage/$GRATIO_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"chatId": "8695836", "idMessage": "117428955282341903"}'

Python

import os
import requests

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

url = f"{BASE}/getMessage/{TOKEN}"
payload = {"chatId": "8695836", "idMessage": "117428955282341903"}
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}/getMessage/${GRATIO_TOKEN}`;
const payload = { chatId: "8695836", idMessage: "117428955282341903" };
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 . '/getMessage/' . getenv('GRATIO_TOKEN');
$payload = ['chatId' => '8695836', 'idMessage' => '117428955282341903'];

$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 — один элемент журнала:

{
  "type": "incoming",
  "idMessage": "117428955282341903",
  "timestamp": 1791823658,
  "chatId": "8695836",
  "chatType": "user",
  "senderId": "8695836",
  "senderName": "Мария",
  "senderContactName": "",
  "isForwarded": false,
  "forwardingScore": 0,
  "typeMessage": "textMessage",
  "textMessage": "Здравствуйте! Есть места на субботу?"
}

Все поля — в статье Элемент журнала.

Откуда берётся сообщение

  1. Gratio спрашивает площадку — так приходят актуальный текст и файлы.
  2. Площадка сообщение не отдала — Gratio берёт его из своего журнала.
  3. Нет ни там, ни там — 400 not_found.

Статус своего сообщения (statusMessage), sendByApi, isDeleted и isEdited берутся из журнала Gratio, если сообщение через него проходило.

Ошибки

Код code Когда Что делать
400 validation нет chatId или idMessage; id не этого канала (в MAX — не число) исправить запрос
400 not_found сообщения нет ни у площадки, ни в журнале Gratio проверить chatId: сообщение ищется только в этом чате
400 not_authorized канал не на связи проверить getStateInstance

Общие правила — в статье Ответы и ошибки.

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

  • WhatsApp — сообщения с момента привязки номера к Gratio.
  • Почта — письмо по его id из уведомления или истории. Письмо со всеми заголовками и вложениями — getEmail.

Что дальше

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

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