Skip to main content

Админы и участники

Получение информации​

МетодОписание
getChatИнформация о чате
getChatMemberСтатус юзера в чате
getChatAdministratorsВсе админы
getChatMemberCountКоличество участников
POST /getChatMember
{
  "chat_id": -100123,
  "user_id": 99999
}

Ответ:

{
  "ok": true,
  "result": {
    "user": {"id": 99999, "first_name": "Иван"},
    "status": "administrator"
  }
}

Возможные status:

  • creator — владелец
  • administrator — админ
  • member — обычный
  • restricted — ограничен (мут)
  • left — покинул чат
  • kicked — забанен

Бан и разбан​

POST /banChatMember
{
  "chat_id": -100123,
  "user_id": 99999,
  "until_date": 1735689600
}

POST /unbanChatMember
{
  "chat_id": -100123,
  "user_id": 99999,
  "only_if_banned": true
}

until_date опциональный — Unix timestamp когда снять бан. Без него — бан навсегда (но unbanChatMember снимет).

kickChatMember — алиас для banChatMember.

Мут (restrict)​

POST /restrictChatMember
{
  "chat_id": -100123,
  "user_id": 99999,
  "permissions": {
    "can_send_messages": false,
    "can_send_media_messages": false,
    "can_send_polls": false
  },
  "until_date": 1735689600
}

can_send_messages: false = мут до until_date.

can_send_messages: true (или unrestrict) = снять мут.

Назначение админом​

POST /promoteChatMember
{
  "chat_id": -100123,
  "user_id": 99999,
  "can_delete_messages": true,
  "can_restrict_members": true,
  "can_promote_members": false,
  "can_change_info": true,
  "can_invite_users": true,
  "can_pin_messages": true
}

Все права из {can_*: false} → юзер становится обычным членом.

Кастомный титул​

POST /setChatAdministratorCustomTitle
{
  "chat_id": -100123,
  "user_id": 99999,
  "custom_title": "Главный модератор"
}

Заменяет «admin» в подписи на свой текст.