Управление участниками

Управление участниками

banChatMember

Заблокировать участника. Требует право block_users.

POST ?method=banChatMember
{ "chat_id": 123, "user_id": 42, "reason": "спам" }

Ответ: { "ok": true, "result": true }

Ошибки:

unbanChatMember

POST ?method=unbanChatMember
{ "chat_id": 123, "user_id": 42 }

Ответ: { "ok": true, "result": true }

kickChatMember

Удалить участника без блокировки. Требует право remove_users.

POST ?method=kickChatMember
{ "chat_id": 123, "user_id": 42 }

Ответ: { "ok": true, "result": true }

promoteChatMember

Назначить администратором. Требует право add_admins.

POST ?method=promoteChatMember
{
  "chat_id": 123,
  "user_id": 42,
  "permissions": {
    "delete_messages": true,
    "remove_users": true,
    "block_users": true,
    "pin_messages": true,
    "invite_users": true,
    "change_info": false,
    "add_admins": false,
    "post_messages": false,
    "edit_messages": false
  },
  "custom_title": "Модератор"
}

Ответ: { "ok": true, "result": true }

Ошибки:

demoteChatMember

Забрать права администратора. Требует право add_admins.

POST ?method=demoteChatMember
{ "chat_id": 123, "user_id": 42 }

Ответ: { "ok": true, "result": true }

setChatAdministratorCustomTitle

Сменить звание без изменения прав.

POST ?method=setChatAdministratorCustomTitle
{ "chat_id": 123, "user_id": 42, "custom_title": "Основатель" }

Ответ: { "ok": true, "result": true }

getChatAdministrators

GET ?method=getChatAdministrators&chat_id=123

Ответ:

{
  "ok": true,
  "result": [
    {
      "user_id": 5,
      "name": "Иван",
      "login": "ivan",
      "role": "owner",
      "custom_title": null,
      "permissions": { "delete_messages": true, ... }
    }
  ]
}

getChatMember

GET ?method=getChatMember&chat_id=123&user_id=42

Ответ:

{
  "ok": true,
  "result": {
    "user_id": 42,
    "name": "Пётр",
    "login": "petr",
    "role": "member"
  }
}

Ошибки:

getChatMemberCount

GET ?method=getChatMemberCount&chat_id=123

Ответ: { "ok": true, "result": 42 }