refreshReactions

Спрашивает у площадки, кто какой реакцией сейчас отмечает сообщения, и сохраняет ответ в журнал реакций канала. Нужен для сообщений, отправленных до подключения канала к Gratio, и для реакций, о которых площадка не сообщает, — например, на старые чужие сообщения в группах MAX. Таких реакций getReactions сам не видел, после загрузки их отдаёт и он.

Параметры

За период берутся сообщения чата из истории канала — те, что отдаёт getChatHistory, новые первыми. Пока история чата загружается, давних сообщений в ответе может не быть — ход загрузки показывает getSyncStatus. Дата без часового пояса — по поясу канала, как в getReactions.

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

Реакции на сообщения группы за 12 октября — до подключения канала:

curl

curl -X POST "$GRATIO_URL/v1/instances/$GRATIO_ID/refreshReactions" \
  -H "Authorization: Bearer $GRATIO_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "chatId": "-80040066617372",
    "since": "2026-10-12",
    "before": "2026-10-13"
  }'

Python

import os
import requests

BASE = f"{os.environ['GRATIO_URL']}/v1/instances/{os.environ['GRATIO_ID']}"
HEADERS = {"Authorization": f"Bearer {os.environ['GRATIO_TOKEN']}"}

url = f"{BASE}/refreshReactions"
payload = {
    "chatId": "-80040066617372",
    "since": "2026-10-12",
    "before": "2026-10-13",
}
response = requests.post(url, json=payload, headers=HEADERS, timeout=60)
print(response.status_code, response.json())

Node.js

const { GRATIO_URL, GRATIO_ID, GRATIO_TOKEN } = process.env;
const base = `${GRATIO_URL}/v1/instances/${GRATIO_ID}`;
const auth = { Authorization: `Bearer ${GRATIO_TOKEN}` };

const url = `${base}/refreshReactions`;
const payload = { chatId: "-80040066617372", since: "2026-10-12", before: "2026-10-13" };
const response = await fetch(url, {
  method: "POST",
  headers: { ...auth, "Content-Type": "application/json" },
  body: JSON.stringify(payload),
});
console.log(response.status, await response.json());

PHP

<?php
$base = getenv('GRATIO_URL') . '/v1/instances/' . getenv('GRATIO_ID');
$auth = 'Authorization: Bearer ' . getenv('GRATIO_TOKEN');
$url = $base . '/refreshReactions';
$payload = [
    'chatId' => '-80040066617372',
    'since' => '2026-10-12',
    'before' => '2026-10-13',
];

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [$auth, '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 — как у getReactions, но по элементу на каждое сообщение периода, с реакциями или без:

[
  {
    "chatId": "-80040066617372", "idMessage": "117428956522361912", "type": "outgoing", "timestamp": 1791823671,
    "senderId": "457747484", "senderName": "", "typeMessage": "textMessage",
    "textMessage": "В субботу занятие переносится на 12:00",
    "reactions": [{"sender": "1111111", "reaction": "👍"}, {"sender": "8695836", "reaction": "👍"}],
    "counts": {"👍": 2}
  },
  {
    "chatId": "-80040066617372", "idMessage": "117428955282341903", "type": "incoming", "timestamp": 1791823658,
    "senderId": "8695836", "senderName": "Мария", "typeMessage": "textMessage", "textMessage": "Спасибо!",
    "reactions": [], "counts": {}
  }
]

Поля — как в статье getReactions. Теперь и getReactions отдаёт эти реакции.

Ещё примеры

По списку сообщений

Ответ — в порядке запроса, по элементу на каждый idMessage:

curl -X POST "$GRATIO_URL/v1/instances/$GRATIO_ID/refreshReactions" \
  -H "Authorization: Bearer $GRATIO_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "chatId": "-80040066617372",
    "idMessages": [
      "117428956522361912",
      "117428955282341903"
    ]
  }'

Длинный период: загрузить и прочитать

Период длиннее count сообщений загружайте страницами. Следующая страница — тот же запрос с before, равным timestamp последнего элемента; пустой массив — сообщений за период больше нет. Страница бывает короче count: сообщения последней секунды целиком переходят на следующую.

Скрипт загружает реакции группы за первую половину октября, а потом читает их одним запросом getReactions — там остаются только сообщения с реакциями:

import os
import time
import requests

BASE = f"{os.environ['GRATIO_URL']}/v1/instances/{os.environ['GRATIO_ID']}"
HEADERS = {"Authorization": f"Bearer {os.environ['GRATIO_TOKEN']}"}
CHAT, SINCE, BEFORE = "-80040066617372", "2026-10-01", "2026-10-15"

before = BEFORE
while True:
    r = requests.post(f"{BASE}/refreshReactions", headers=HEADERS, timeout=90,
                      json={"chatId": CHAT, "since": SINCE, "before": before})
    if r.status_code == 429:                     # площадка попросила паузу
        time.sleep(int(r.headers.get("Retry-After", 60)))
        continue
    r.raise_for_status()
    page = r.json()
    if not page:                                 # период загружен
        break
    before = page[-1]["timestamp"]

r = requests.post(f"{BASE}/getReactions", headers=HEADERS, timeout=60,
                  json={"chatId": CHAT, "since": SINCE, "before": BEFORE, "count": 1000})
for m in r.json():
    print(m["timestamp"], m.get("textMessage", "")[:40], m["counts"])

Ошибки

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

Особенности

• Каждый вызов — запросы к площадке от имени номера канала, в темпе загрузки истории. На 100 сообщений уходят секунды, при многих реакциях — до полуминуты: таймаут клиента — не меньше 60 секунд. Чаты загружайте по очереди, а не параллельно: частые запросы площадка замечает.
• Загруженное ложится в журнал без уведомлений: приложение не получит старые реакции как новые. Новые реакции после загрузки приходят уведомлением Реакция, как обычно.
• Если площадка отдала всех авторов реакций, журнал приводится к её состоянию: реакция, которую уже сняли, снимается и в журнале. Если отдала не всех — журнал только дополняется.
• MAX. Все авторы реакций, до 100 на сообщение; у участника — одна реакция.
• Telegram. В личных чатах и группах, где Telegram открывает список, — все авторы, до 300 на сообщение. В каналах и больших группах Telegram отдаёт только число: авторы известны не все, журнал только дополняется. Эмодзи из наборов и платные реакции в ответ не попадают — у них нет обычного эмодзи.

Что дальше

• getReactions — реакции из журнала, без запросов к площадке.
• getChatHistory — сообщения чата и их idMessage.
• Реакция — как приходят новые реакции.