Новый чат

Создаёт беседу или канал. Владелец токена становится владельцем чата, и роль эта в дальнейшем не передаётся.

Мульти-гость, как и в интерфейсе, создавать чаты не может: метод отвечает ему 403.

Для создания личной переписки 1 на 1 с пользователем пользуйтесь методом POSTНовое сообщение. Чтобы обсудить конкретное сообщение, чат заводить не нужно — под ним заводят тред методом POSTНовый тред. Разговору на одну тему постоянное место тоже не нужно: для него есть метод POSTНовый самостоятельный тред.

Участников можно передать сразу: member_ids добавляет поимённо, group_tag_ids приводит всех, кто состоит в теге, и дальше поддерживает состав сам. Идентификаторы, которых в пространстве нет, а также приостановленные и удалённые сотрудники запрос не останавливают: чат создаётся с остальными участниками, а такие идентификаторы приходят в meta.not_found_member_ids. Несуществующие теги пропускаются молча. С ботами строже: если настройка бота «Кто может добавлять бота в чаты» не разрешает вам его добавить, чат не создаётся, а метод отвечает 403 с кодом bot_add_denied и идентификаторами таких ботов в value. Бот с настройкой «Ограничить одним чатом», который уже состоит в другой беседе или канале, тоже останавливает запрос, если он есть в member_ids или создаёт чат сам: чат не создаётся, а метод отвечает 409 с кодом single_chat_bot_occupied и идентификаторами таких ботов в value.

Аватар чату ставят после создания методом PUTЗагрузка аватара чата.