Настройки бота

Эти настройки находятся на вкладке Основное в карточке бота. Они решают, как бот выглядит, кому он доступен и кто может его менять.

Профиль бота

Бот, как и любой участник пространства, имеет свой профиль. В нём отображаются имя, аватар, никнейм, статус и список общих чатов с ботом. Изменить имя, аватар и никнейм можно кнопкой Редактировать в шапке вкладки. Там же указан создатель бота.

Никнейм — уникальный идентификатор бота для упоминания через @. Именно по никнейму сотрудники могут упоминать бота в сообщениях и добавлять его в сквозные треды. Никнейм состоит из латиницы, цифр и _ и оканчивается на _bot. Через API имя и никнейм меняются методом PUTРедактирование бота в полях webhook.name и webhook.nickname, а аватар — методом PUTЗагрузка аватара сотрудника, он доступен владельцу и администраторам.

Ограничить одним чатом

Если включить эту настройку, бота можно будет добавить только в одну беседу или канал — и в интерфейсе, и через API. Личные чаты и треды под ограничение не попадают. Подходит простым интеграциям вроде уведомлений: в одном чате собираются все получатели, а уведомления обсуждают в тредах.

Бот, который уже состоит в беседе или канале, пропадает из списка добавления, пока этот чат не в архиве. Методы POSTДобавление пользователей и POSTНовый чат с таким ботом отвечают 409 с кодом single_chat_bot_occupied и идентификаторами таких ботов: никого не добавляют и чат не создают.

Добавить бота с этой настройкой в тег нельзя: метод PUTРедактирование сотрудника отвечает 422 с кодом single_chat_bot_tag_denied. Когда настройку включают, бот выходит из всех тегов и из чатов, куда попал через них, а в чатах, куда его добавили напрямую, остаётся.

Кто может добавлять бота в чаты

Переключатель Публичный бот открывает бота всему пространству: он появляется в поиске и на вкладке Обзор в витрине, написать ему может любой участник пространства. Добавить публичного бота в чаты и треды, в том числе упоминанием в сообщении, может любой сотрудник, кроме гостей и мульти-гостей.

Непубличного бота добавляют в каналы и беседы только те, кого выбрали в списке Кто может добавлять бота в чаты:

• Создатель — только создатель бота, так у нового бота по умолчанию
• Создатель и Администраторы — создатель, владелец и администраторы пространства
• Все участники (кроме гостей) — любой сотрудник пространства

Пока бот публичный, списка нет: вместо него написано, что публичного бота добавляет любой сотрудник, кроме гостей. Если выключить Публичный бот, список появится, и в нём будет выбрано Создатель и Администраторы.

Правило одинаково для всех способов добавления: в интерфейсе, упоминанием и через API. Гости и мульти-гости ботов в чаты не добавляют ни при какой настройке. Через API запрос с таким ботом отклоняется целиком: методы POSTДобавление пользователей и POSTНовый чат отвечают 403 с кодом bot_add_denied и идентификаторами таких ботов, никого не добавляют и чат не создают.

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

Кто может редактировать настройки бота

Кому открыта карточка бота и кто видит его на вкладке Управление:

• Создатель — отключить нельзя. Если создавать интеграции разрешено только администраторам, создатель без этой роли теряет доступ к своему боту.
• Администраторы — владелец и участники пространства с ролью «Администратор»
• Руководители бесед и каналов, в которые добавлен бот — доступ по роли в чате, куда добавлен бот

У нового бота по умолчанию доступ есть только у создателя: администраторы не видят бота на вкладке Управление, пока создатель не отметит Администраторы.

Руководители чатов меняют настройки и вебхуки бота. Имя, токены, авторизация от имени сотрудника, страница в витрине и удаление бота доступны только создателю и администраторам: токен открывает работу от имени бота, поэтому администраторам доступ выдавайте там, где доверили бы им сам токен. Что из этого доступно владельцу токена, в API показывает поле permissions в объекте бота.

Удаление бота

Удалить бота можно кнопкой Удалить бота внизу вкладки. Бот исчезнет из всех бесед, каналов и тредов, его токены будут отозваны, а вебхуки и выданные ему авторизации перестанут работать. Удаление нельзя отменить. Через API — метод DELETEУдаление бота.

Через API

Те же настройки задаются в объекте webhook метода PUTРедактирование бота или сразу при создании методом POSTНовый бот: