> Расположение: Боты
> Краткое содержание: Вкладка «Основное» в карточке бота: профиль, ограничение одним чатом, публичный бот, кто может добавлять бота в чаты и редактировать его настройки, удаление бота и те же настройки через API
> Это Markdown-версия конкретной страницы. Для контекста за её пределами (правила API, полный перечень методов, авторизация) ОБЯЗАТЕЛЬНО открой [llms.txt](https://dev.pachca.com/llms.txt) перед ответом — это сэкономит токены и предотвратит неполный ответ.


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

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

![Вкладка «Основное» в карточке бота: профиль, создатель, ограничение одним чатом, публичность и доступы](/images/bots/bot_main_settings.webp)

*Вкладка «Основное» в карточке бота*


## Профиль бота

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

**Никнейм** — уникальный идентификатор бота для упоминания через `@`. Именно по никнейму сотрудники могут упоминать бота в сообщениях и добавлять его в [сквозные треды](/guides/bots/access#tredy). Никнейм состоит из латиницы, цифр и `_` и оканчивается на `_bot`. Через API имя и никнейм меняются методом [Редактирование бота](/api/bots/update) в полях `webhook.name` и `webhook.nickname`, а аватар — методом [Загрузка аватара сотрудника](/api/users/update-avatar), он доступен владельцу и администраторам.

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

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

Бот, который уже состоит в беседе или канале, пропадает из списка добавления, пока этот чат не в архиве. Методы [Добавление пользователей](/api/members/add) и [Новый чат](/api/chats/create) с таким ботом отвечают `409` с кодом `single_chat_bot_occupied` и идентификаторами таких ботов: никого не добавляют и чат не создают.

Добавить бота с этой настройкой в тег нельзя: метод [Редактирование сотрудника](/api/users/update) отвечает `422` с кодом `single_chat_bot_tag_denied`. Когда настройку включают, бот выходит из всех тегов и из чатов, куда попал через них, а в чатах, куда его добавили напрямую, остаётся.

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

Переключатель **Публичный бот** открывает бота всему пространству: он появляется в поиске и на вкладке **Обзор** в [витрине](/guides/bots/showcase), написать ему может любой участник пространства. Добавить публичного бота в чаты и треды, в том числе упоминанием в сообщении, может любой сотрудник, кроме гостей и мульти-гостей.

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

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

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

Правило одинаково для всех способов добавления: в интерфейсе, упоминанием и через API. Гости и мульти-гости ботов в чаты не добавляют ни при какой настройке. Через API запрос с таким ботом отклоняется целиком: методы [Добавление пользователей](/api/members/add) и [Новый чат](/api/chats/create) отвечают `403` с кодом `bot_add_denied` и идентификаторами таких ботов, никого не добавляют и чат не создают.

Написать непубличному боту в личные сообщения можно только при общем чате с ним или после того, как бот написал первым. Подробнее — в разделе [Доступы к чатам и сообщениям](/guides/bots/access#lichnye-soobscheniya).

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

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

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

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

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

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

Удалить бота можно кнопкой **Удалить бота** внизу вкладки. Бот исчезнет из всех бесед, каналов и тредов, его токены будут отозваны, а вебхуки и выданные ему авторизации перестанут работать. Удаление нельзя отменить. Через API — метод [Удаление бота](/api/bots/delete).

## Через API

Те же настройки задаются в объекте `webhook` метода [Редактирование бота](/api/bots/update) или сразу при создании методом [Новый бот](/api/bots/create):

| Настройка | Поле | Значения |
| --- | --- | --- |
| Имя и никнейм | `name`, `nickname` | строки, никнейм оканчивается на `_bot` |
| Кто может добавлять бота в чаты | `who_can_add` | `creator`, `creator_admin`, `creator_admin_user`, а публичному боту соответствует `anyone` |
| Кто может редактировать настройки бота | `can_edit` | роли `admin` и `chat_owners`. Создатель имеет доступ всегда, поэтому пустой массив означает «только создатель» |
| Ограничить одним чатом | `single_chat` | `true` или `false` |


## Связанные разделы

- [Доступы к чатам и сообщениям](/guides/bots/access)
- [Токены бота](/guides/bots/tokens)
- [Витрина](/guides/bots/showcase)
- [Права и роли](/guides/permissions)