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

sendReaction

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

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

Ставит реакцию-эмодзи на сообщение — своё или собеседника. Пустая строка снимает свою реакцию. Тот же метод доступен под именем setReaction.
Запрос POST /waInstance{idInstance}/sendReaction/{apiTokenInstance}
Тело JSON
Каналы MAX, Telegram, WhatsApp. Почта — 501

Параметры

Параметр Тип Обязательный Описание
chatId string да чат сообщения — адрес из уведомления или истории. Поиска по номеру здесь нет
idMessage string да сообщение. Можно передать и как messageId
reaction string нет эмодзи: "👍". Пустая строка или без поля — снять свою реакцию

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

Поставить 👍 на сообщение Марии в MAX:

curl

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

Python

import os
import requests

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

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

$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": "117428955282341903"}

idMessage — сообщение, на которое поставлена реакция.

Ещё примеры

Снять реакцию

Пустая строка убирает реакцию, которую ставил канал:

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

Ошибки

Код code Когда Что делать
400 validation нет chatId или idMessage; адрес чата или id не этого канала исправить запрос
400 not_authorized канал не на связи проверить getStateInstance
400 not_found сообщения нет в этом чате проверить chatId и idMessage
400 reaction_invalid Telegram: такой реакции нет или она запрещена в чате взять реакцию из getAllowedReactions
400 код площадки площадка отказала см. message
402 payment_required канал на паузе за неоплату продлить канал в кабинете
501 not_supported канал почты —

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

  • Telegram. Ставятся только реакции, разрешённые в чате; премиальные — только у аккаунта с Telegram Premium. Список — getAllowedReactions.
  • WhatsApp. Подходит любая эмодзи. Реагировать можно на сообщения, которые канал видел с момента привязки.
  • Почта — 501 not_supported: реакций у писем нет.

Что дальше

  • getAllowedReactions — какие реакции можно поставить в чате.
  • Реакция — как приходят реакции собеседника.
  • readChat — отметить сообщения прочитанными.

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

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