## Создание

    Как создать бота?

Вы можете создать чат-бот, только если у вас есть [верифицированный профиль](/docs/maxbusiness/connection#Верификация) организации, ИП или самозанятого

> Количество доступных для создания ботов зависит от типа профиля: для одного ИП или юрлица доступно 5 ботов, для самозанятого — 2 бота

**Чтобы создать:**

1. Перейдите на [платформу](https://business.max.ru/self) и выберите верифицированный профиль
2. В разделе **Чат-боты** → нажмите **Создать**
2. Заполните данные в [настройках бота](/docs/chatbots/bots-create#Настройки%20бота) (его карточке) и нажмите **Создать**

После успешной [модерации](/docs/chatbots/bots-create#Статусы%20модерации) бот становится доступным для ваших пользователей, а вы можете доработать его под свой сценарий
- **Через конструктор сценариев: без кода**Доработайте бота по шаблонам конструкторов — подробнее об этом [в разделе «Конструктор сценариев: без кода»](/docs/chatbots/bots-nocode) — или воспользуйтесь услугами наших [партнёров](/docs/partners-integration). Они соберут бота для проекта любой сложности и помогут подключить его к приложению
- **Через API и библиотеки**Доработайте бота самостоятельно — подробнее об этом [в разделе «Разработка сценариев: с кодом»](/docs/chatbots/bots-coding/prepare). Если планируете разработку на JavaScript или Golang, воспользуйтесь разделами [«Библиотека JavaScript»](/docs/chatbots/bots-coding/js), [«Библиотека Golang»](/docs/chatbots/bots-coding/go)

    Можно ли сделать непубличного бота?

В настоящее время пользователи могут найти любого бота в MAX по ссылке или по никнейму через поиск приложения

## Настройка и управление

    Как изменить имя, аватар, описание и другие настройки бота?

> Вы можете изменить [настройки бота](/docs/chatbots/bots-create/manage#Редактирование%20бота) только после прохождения [модерации](/docs/chatbots/bots-create#Модерация%20бота). Если вы не хотите дожидаться её окончания, [удалите бота](/docs/chatbots/bots-create/manage#Удаление%20бота) и создайте нового с теми настройками, которые вам нужны

Изменить можно все настройки, кроме никнейма:

1. Перейдите на [платформу MAX для партнёров](https://business.max.ru/self) в раздел **Чат-боты**
2. Выберите необходимого бота и нажмите **→**
3. Внесите изменения в разделе **Основная информация** и нажмите **Сохранить** — бот будет отправлен на повторную [модерацию](/docs/chatbots/bots-create/create#Статусы%20модерации)

    Есть ли ограничения для никнейма и имени бота?

Никнейм генерируется автоматически:

* Для юрлиц и ИП — по шаблону `idИНН_bot`, где ИНН — номер вашей организации или ИП
* Для самозанятых — по шаблону `se(orgid)_bot`, где `orgid` — идентификатор профиля [на платформе](https://business.max.ru/self)

Выбрать или изменить его пока нельзя. Когда такая возможность появится, обратите внимание на требования к никнейму:
- Должен начинаться с маленькой буквы, без `@`
- Должен заканчиваться на «_bot» или «bot». Если не указать, к введённому вами имени бота автоматически будет добавлено «_bot»
- Длина: 11 — 60 символов, включая «_bot» / «bot»
- Допустимые символы: латиница, цифры и `_`

    Как разрешить или запретить добавление бота в групповой чат?

1. Перейдите на [платформу MAX для партнёров](https://business.max.ru/self) в раздел **Чат-боты**
2. Выберите необходимого бота и нажмите **⋮** → **Настройки**
3. Включите или отключите возможность добавления бота в групповой чат и нажмите **Сохранить**. По умолчанию у созданного бота стоит запрет на его добавление в групповой чат

    Как управлять ботом в MAX?

После успешной [модерации](/docs/chatbots/bots-create#Модерация%20бота) у чат-бота появится токен — уникальный идентификатор бота, с помощью которого он будет взаимодействовать с [API ботов](/docs-api). Наличие токена означает, что бот зарегистрирован на платформе MAX для партнёров

Для управления ботом используйте его токен:

1. Перейдите на [платформу MAX для партнёров](https://business.max.ru/self) в раздел **Чат-боты**
2. Выберите необходимого бота и нажмите **⋮** → **Настройки**
3. Справа от поля с токеном нажмите на значок копирования

    Можно ли поменять владельца бота?

Поменять владельца или передать права на управление ботом пока нельзя

    Как создать групповой чат, добавить бота в чат и назначить бота администратором?

Чтобы добавить бота в групповой чат, сначала разрешите это в настройках бота на [платформе MAX для партнёров](https://business.max.ru/self), затем создайте чат и добавьте бота, после чего назначьте его администратором

**Разрешить добавление в групповые чаты**

По умолчанию добавление бота в групповые чаты запрещено. Чтобы это изменить:

1. Перейдите на [платформу MAX для партнёров](https://business.max.ru/self) в раздел **Чат-боты**
2. Выберите необходимого бота и нажмите **⋮** → **Настройки**
3. Перейдите в раздел **Приватность** и разрешите добавление в групповые чаты

**Создать групповой чат**

1. Откройте приложение MAX
2. Нажмите на **+** в верхнем правом углу
3. Выберите **Создать групповой чат**
4. Выберите участников из списка и нажмите **Продолжить**
5. Добавьте название и фото для чата и нажмите **Создать чат**

**Добавить бота в чат**

1. Откройте созданный групповой чат
2. Нажмите на название чата вверху экрана
3. Нажмите **Участники** → **Добавить участников**
4. Найдите бота по имени и подтвердите добавление 

**Назначить бота администратором**

1. В настройках чата откройте **Администраторы**
2. Нажмите **Добавить администратора**
3. Выберите бота и настройте права

Подробнее о добавлении бота в групповой чат — [на странице «Добавление бота в чаты и каналы»](/docs/chatbots/bots-coding/prepare#Добавление%20бота%20в%20чаты%20и%20каналы)

Для корректной работы бота в групповом чате рекомендуется выдать права `read_all_messages` и `write`

    Как удалить бота?

 После удаления ваши клиенты не смогут пользоваться ботом. Удалённого бота нельзя восстановить

Чтобы удалить бота:

1. Перейдите на [платформу MAX для партнёров](https://business.max.ru/self) в раздел **Чат-боты**
2. Выберите необходимого бота и удалите его одним из способов:
    - Либо нажмите **⋮** → **Удалить**
    - Либо нажмите **→** и в разделе **Основная информация** выберите **Удалить чат-бот**

## Токен бота

    Как посмотреть токен бота?

В целях безопасности токен бота отображается на платформе частично скрытым, но вы можете его скопировать:

1. Перейдите на [платформу MAX для партнёров](https://business.max.ru/self) в раздел **Чат-боты**
2. Выберите необходимого бота и нажмите **⋮** → **Настройки**
3. Справа от поля с токеном нажмите на значок копирования

    Как обновить токен бота?

1. Перейдите на [платформу MAX для партнёров](https://business.max.ru/self) в раздел **Чат-боты**
2. Выберите необходимого бота и нажмите **⋮** → **Настройки**
3. Справа от поля с токеном нажмите на значок обновления

## Разработка

    Как обучить AI-агента разработке бота?

Воспользуйтесь навыком [MAX Messenger Agent Skill](/docs/chatbots/bots-coding/bot-skill/) — это набор файлов с манифестом SKILL.md, который даёт AI-агенту актуальный контекст для разработки ботов и мини-приложений под мессенджер MAX

    Где я могу найти примеры кода?

Ищите примеры кода в разделах [«Библиотека Javascript»](/docs/chatbots/bots-coding/js), [«Библиотека Golang»](/docs/chatbots/bots-coding/go) или в репозитории на GitHub: [JavaScript](https://github.com/max-messenger/max-bot-api-client-ts), [Golang](https://github.com/max-messenger/max-bot-api-client-go)

    Есть ли у чат-ботов в MAX команды по умолчанию, предзаданные платформой?

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

Это можно сделать с помощью библиотек [JavaScript](/docs/chatbots/bots-coding/js) и [Golang](/docs/chatbots/bots-coding/go). Примеры использования библиотек для работы с чат-ботом читайте в [разделе «Примеры создания ботов»](/docs/chatbots/bots-coding/examples)

Вы можете добавить команды в [кнопки](/docs-api#Клавиатура%20для%20чат-бота) с типом `callback`, которые чат-бот будет присыаться сообщением

    Как узнать, получают ли пользователи уведомления от чат-бота?

Пока разработчики не могут отслеживать пользовательские настройки уведомлений в чат-боте

    Можно ли форматировать текст в сообщениях бота?

Можно. Платформа поддерживает два типа [форматирования](/docs-api#Форматирование%20текста%20в%20сообщениях) — Markdown и HTML. Чтобы выделить информацию в сообщениях бота, например, **жирным шрифтом** или _курсивом_, отправьте параметр запроса `format (enum TextFormat Nullable)` — текст будет отформатирован в соответствии с указанной разметкой

Выбрать другую тему вопроса