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

getAllowedReactions

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

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

Отвечает, какие реакции можно поставить: в конкретном чате или вообще аккаунту. Пригодится, чтобы показать в своём интерфейсе только рабочие реакции для sendReaction.
Запрос POST /waInstance{idInstance}/getAllowedReactions/{apiTokenInstance}
Тело JSON
Каналы Telegram, WhatsApp. MAX и почта — 501

Параметры

Параметр Тип Обязательный Описание
chatId string нет чат — адрес из уведомления или истории. Без него — все реакции, доступные аккаунту

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

Реакции, разрешённые в группе Telegram:

curl

curl -X POST "$GRATIO_URL/waInstance$GRATIO_ID/getAllowedReactions/$GRATIO_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"chatId": "-1001234567890"}'

Python

import os
import requests

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

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

$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:

{"chatId": "-1001234567890", "reactions": ["👍", "❤", "🔥", "🙏", "👎"]}

Поля ответа

Поле Тип Описание
chatId string чат из запроса; пусто, если chatId не передан
reactions array эмодзи, которые можно поставить. Пустой массив — реакции в чате выключены

Ещё примеры

Все реакции аккаунта

Без chatId:

curl -X POST "$GRATIO_URL/waInstance$GRATIO_ID/getAllowedReactions/$GRATIO_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{}'

WhatsApp

WhatsApp принимает любую эмодзи, а в ответе — быстрые реакции, которые приложение показывает первыми:

curl -X POST "$GRATIO_URL/waInstance$GRATIO_ID/getAllowedReactions/$GRATIO_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"chatId": "79991234567@c.us"}'

Ответ 200 OK:

{"chatId": "79991234567@c.us", "reactions": ["👍", "❤️", "😂", "😮", "😢", "🙏"]}

Ошибки

Код code Когда Что делать
400 not_authorized канал не на связи проверить getStateInstance
400 validation адрес чата не этого канала исправить chatId
400 код площадки чат не найден или закрыт см. message
501 not_supported канал MAX или почта —

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

  • Telegram. В личном чате и без chatId — все реакции аккаунта; премиальные — только с Telegram Premium. В группе и канале — те, что разрешены в чате: все, выбранные или ни одной.
  • WhatsApp. Всегда одни и те же шесть быстрых реакций; поставить можно любую эмодзи.
  • MAX и почта — 501 not_supported.

Что дальше

  • sendReaction — поставить реакцию.
  • Реакция — как приходят реакции собеседника.

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

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