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

getJoinRequests

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

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

Возвращает заявки, которые ждут решения админа. Нужно, чтобы аккаунт канала был админом группы или канала с правом приглашать. Принять или отклонить заявку — answerJoinRequest.
Запрос POST /waInstance{idInstance}/getJoinRequests/{apiTokenInstance}
Тело JSON
Каналы Telegram, MAX

Параметры

Параметр Тип Обязательный Описание
chatId string да ваша группа или канал

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

Заявки в группу «3А · Робототехника»:

curl

curl -X POST "$GRATIO_URL/waInstance$GRATIO_ID/getJoinRequests/$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}/getJoinRequests/{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}/getJoinRequests/${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 . '/getJoinRequests/' . 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",
  "requests": [
    {"chatId": "8617393401", "name": "Мария", "date": 1791823658, "about": "Мама Саши из 3А"},
    {"chatId": "8600000002", "name": "Олег", "date": 1791823702, "about": ""}
  ]
}

Поля ответа

Поле Тип Описание
chatId string группа или канал из запроса
requests[].chatId string кто просится — передайте в participantChatId метода answerJoinRequest
requests[].name string имя в мессенджере
requests[].date integer или null когда подана заявка, Unix. В MAX — null
requests[].about string текст заявки; нет — пустая строка

Ошибки

Код code Когда Что делать
400 validation нет chatId добавить поле
400 not_a_group chatId — личный чат передать группу или канал
400 admin_required аккаунт не админ или без права приглашать выдать права в приложении
400 not_found чат неизвестен аккаунту проверить chatId
400 not_authorized канал не на связи проверить getStateInstance
501 not_supported WhatsApp или почта —

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

  • Telegram. За один вызов — до 100 заявок. Новая заявка приходит и уведомлением groupEvent joinRequested — список можно не опрашивать.
  • MAX. Заявки бывают только у закрытых каналов. За один вызов — до 500 заявок. Даты и текста заявки MAX не отдаёт: date — null, about — пустая строка.

Что дальше

  • answerJoinRequest — принять или отклонить заявку.
  • groupEvent — уведомление о новой заявке.
  • createInviteLink — ссылка, по которой вступают по заявке.

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

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