Изменение информации о чате

PATCH/chats/{chatId}

Позволяет редактировать информацию о чате, включая название, иконку и закреплённое сообщение.

Авторизация

access_token
apiKey optional

Токен присваивается боту при регистрации в MAX через @MasterBot. Это уникальный идентификатор, с помощью которого бот взаимодействует с MAX Bot API: токен передаётся в качестве параметра access_token в HTTP-запросе

Рекомендуем не разглашать токен посторонним, чтобы они не получили доступ к управлению ботом. Если вы опасаетесь, что идентификатор скомпрометирован, отзовите его и сгенерируйте новый через /revoke в @MasterBot. Токен также может быть отозван за нарушение Правил платформы

Параметры

chatId
integer <int64>
\-?\d+

ID чата

Тело запроса

icon
object PhotoAttachmentRequestPayload Nullable

Запрос на прикрепление изображения (все поля являются взаимоисключающими)

title
string Nullable optional

от 1 до 200 символов

pin
string Nullable optional

ID сообщения для закрепления в чате. Чтобы удалить закреплённое сообщение, используйте метод unpin

notify
boolean Nullable optional

По умолчанию: true

Если true, участники получат системное уведомление об изменении

Результат

chat_id
integer <int64>

ID чата

type
enum ChatType

Enum: "dialog" "chat"

Тип чата:

"dialog" — Диалог.
"chat" — Групповой чат.

status
enum ChatStatus

Enum: "active" "removed" "left" "closed" "suspended"

Статус чата:

"active" — Бот является активным участником чата.
"removed" — Бот был удалён из чата.
"left" — Бот покинул чат.
"closed" — Чат был закрыт.
"suspended" — Бот был остановлен пользователем. Только для диалогов.

title
string Nullable

Отображаемое название чата. Может быть null для диалогов

icon
object Image Nullable

Иконка чата

last_event_time
integer <int64>

Время последнего события в чате

participants_count
integer <int32>

Количество участников чата. Для диалогов всегда 2

owner_id
integer <int64> Nullable optional

ID владельца чата

participants
object Nullable optional

Участники чата с временем последней активности. Может быть null, если запрашивается список чатов

is_public
boolean

Доступен ли чат публично (для диалогов всегда false)

link
string Nullable optional

Ссылка на чат

description
string Nullable

Описание чата

dialog_with_user
object UserWithPhoto Nullable

Данные о пользователе в диалоге (только для чатов типа "dialog")

messages_count
integer Nullable optional

Количество сообщений в чате (доступно только для групповых чатов, недоступно для диалогов)

chat_message_id
string Nullable optional

ID сообщения, содержащего кнопку, через которую был инициирован чат

pinned_message
object Message Nullable

Закреплённое сообщение в чате (возвращается только при запросе конкретного чата)