Настройки, команда и доступ

На этой странице

Раздел Настройки собирает всё, что относится к боту целиком: его параметры и поведение, доступ сотрудников, API-токены и шаблоны. Вверху: состояние бота, число пользователей, запросы за сегодня и остаток запросов.

Основные

Обращение: как бот обращается к пользователю.
Позиция в списке: порядок бота среди других.
Режим показа пользователей: «Показывать всех» / «Только активных» / «Только оплативших».
Язык интерфейса: Русский / English.

Поведение

Флаги работы бота:

Запрашивать согласие на обработку персональных данных.
Отправлять пользователю сообщение об ошибке.
Поддерживать HTML-сущности в сообщениях.
Объединять медиа-группы в одно сообщение.

Тестовый режим

В блоке Тестовые пользователи укажите Telegram/VK ID владельца и тестировщиков (не больше 20). Их сообщения обрабатываются обычными реакциями, но запросы не списываются: ни за запуск реакции, ни за доставку сообщений, ни за ИИ и интеграции. В журнале запросов такие строки помечены бейджем «тест», а в колонке «Списано» показана стоимость, которая была бы списана у обычного пользователя. Свой ID можно узнать, написав боту /start и открыв карточку в «Людях». Через API: PATCH /api/bots/{botID}/settings с {"test_user_ids":[123456789]}; MCP: update_bot_settings.

Доступ к проекту

Карточка «Доступ к проекту» в настройках бота открывает один бот другим людям: каждый входит под своей почтой и видит проект в своём кабинете. Чтобы дать человеку сразу все боты кабинета, включая будущие, используйте доступ к кабинету.

Карточку видят владелец бота и участники с правом «Доступ». В списке три вида строк:

Участник: аккаунт, который принял приглашение и уже работает с проектом. Бейдж рядом показывает, включена ли у него 2FA.
Приглашён: приглашение отправлено, но ещё не принято. В строке указано, до какого числа действует ссылка. Доступа такая строка не даёт.
Старая запись: строка из прежней версии экрана, где людей вписывали по имени. Доступа не даёт, её можно только удалить.

Владелец отмечен бейджем «Владелец»: у него все права, изменить или удалить его нельзя.

Роли

Роль задаёт готовый набор прав:

Администратор: все права проекта, включая управление доступом.
Менеджер: чаты, аналитика, просмотр обращений и ответы в поддержке.
Оператор: чаты, просмотр обращений и ответы в поддержке. Так можно подключить операторов Чатов, не открывая им конструктор.

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

Права

Кнопка «Права» открывает точную настройку. Вверху перечислены действующие права, ниже идут галочки по группам: Данные, Контент, Автоматизация, Поддержка, Аналитика, Интеграции, ИИ, Безопасность. Изменение сохраняется сразу, а роль после ручной правки остаётся как пометка.

Выдать или снять можно только право, которое есть у вас самого (у владельца есть все). Остальные галочки недоступны, а сервер отклонит такое изменение.
Чувствительные права: Экспорт профилей, Выручка в аналитике, Секреты интеграций и Обязательная 2FA. Если у вас их нет, диалог прямо подскажет, что выдать их нельзя.
Если право не работает без другого (например, «Редактирование профилей» без «Просмотр профилей»), под ним появится предупреждение.

Приглашение в проект

Нажмите «Пригласить», укажите почту и роль (по умолчанию «Оператор») и нажмите «Выдать доступ».
На почту уйдёт одноразовая ссылка вида /invite?token=…, она действует 72 часа. Ссылку видит только получатель письма, в интерфейсе её нет.
Человек открывает ссылку и входит под аккаунтом с этой почтой (или регистрирует его). После принятия проект сразу появляется в его списке.

Принять приглашение можно только из аккаунта с этой подтверждённой почтой:

если ссылку открыли под другим аккаунтом, страница предложит войти в нужный (кнопка «Добавить аккаунт»), а приглашение останется в силе;
если почта не подтверждена, страница предложит отправить письмо ещё раз; после подтверждения нажмите «Почта подтверждена – принять»;
использованная, истёкшая или неизвестная ссылка недействительна: попросите отправить приглашение заново.

Повторное приглашение на тот же адрес заменяет прежнее: приходит новая ссылка на 72 часа, старая перестаёт работать. Пригласить почту владельца бота нельзя, сервер ответит 409.

Изменение и отзыв

Роль меняется в выпадающем списке строки, права – в диалоге «Права». Приглашённому их можно поправить и до того, как он примет приглашение. Кнопка с корзиной отзывает доступ участника, отменяет приглашение (ссылка из письма перестаёт работать) или удаляет старую запись.

Приглашать и менять роли и права можно, только если тариф владельца бота включает роли. Иначе список остаётся виден, вместо кнопки «Пригласить» показана подсказка о тарифах, а сервер отвечает 402. Отозвать доступ можно на любом тарифе.

Доступ к кабинету

Доступ к проекту открывает один бот. Чтобы дать человеку сразу все боты кабинета, включая будущие, и права самого кабинета (оплата, создание ботов, команда), откройте Аккаунт → карточка «Доступ к кабинету».

Роли:

Администратор: все права.
Менеджер: чаты, реакции, аналитика, профили, события, сегменты, контент и кампании (просмотр и редактирование), просмотр обращений и ответы в поддержке.
Оператор: чаты, просмотр профилей, просмотр обращений и ответы в поддержке.
Финансы: только просмотр баланса и платежей, без прав на боты.

Владелец кабинета указан отдельно: его нельзя изменить или удалить. Набор прав роли можно поправить кнопкой «Права», роль тогда остаётся как пометка. Права кабинета:

Просмотр баланса и платежей (billing.read);
Оплата и пополнение (billing.write);
Управление командой кабинета (team.manage);
Создание ботов (bots.create);
Удаление ботов (bots.delete);
Безопасность (security.manage);
Журнал аудита (audit.read).

Кроме них, в диалоге «Права» задаются права на боты: они действуют во всех ботах кабинета.

Выдавать доступ может владелец или участник с правом «Управление командой кабинета»; выдать право, которого нет у него самого, нельзя. Функция доступна на тарифе с ролями, иначе сервер отвечает 402.

Приглашение

Доступ выдаётся по почте: нажмите «Пригласить», укажите адрес и роль. На почту придёт одноразовая ссылка, она действует 72 часа. Принять приглашение можно только из аккаунта с этой подтверждённой почтой:

если ссылку открыли под другим аккаунтом, страница предложит войти в нужный, а приглашение останется в силе;
если почта не подтверждена, сначала подтвердите её по письму;
использованная, истёкшая или неизвестная ссылка недействительна: попросите отправить приглашение заново.

Управление доступом к кабинету работает только из веб-сессии: по API-токену и через MCP эти операции недоступны. Как права кабинета действуют для API-токенов: см. Кабинет токена.

API-токены

Блок «API-токены» создаёт ключи для доступа к боту по REST API. Токен показывается один раз при создании: скопируйте его сразу; далее видна только маска. Подробнее: REST API и токены.

Шаблоны

Шаблон хранит настройки бота и все его реакции в виде снимка, который можно переиспользовать:

Создать шаблон: сохраняет текущего бота (его настройки и реакции) как именованный шаблон.
Применить шаблон: переносит шаблон на другого бота: настройки заменяются значениями из шаблона, а реакции добавляются к уже существующим (не затирают их).

Удобно для тиражирования типового бота на нескольких проектах. См. также Проекты и каналы.

Обслуживание бота

Синхронизировать: обновить название бота из Telegram (getMe), затем перечитать бота и, если его текущее состояние active, заново зарегистрировать Telegram webhook. Это штатный способ восстановить приём обновлений, когда бот показан офлайн: повторный вызов безопасен. Остальные настройки, статус и порядок бота при этом не меняются. При исходном отсутствии включённого Telegram-канала проверка заканчивается до getMe. Если после обновления названия бот перечитывается в состоянии paused или frozen, приём обновлений для него не запускается. Если канал отключили или бот активировали конкурентно после getMe, название уже может быть сохранено перед ответом об ошибке. Если Telegram не принял новый webhook, подтверждённое название сохраняется, неуспешный кандидат отбрасывается, а существующий runtime и его heartbeat продолжают работать.
Сменить токен: обновить токен после перевыпуска в @BotFather.

Здоровье бота

Карточка «Здоровье бота» показывает наблюдаемое состояние: онлайн бот или нет, текущий инцидент с причиной, счётчиком автоперезапусков, временем следующей попытки и последней ошибкой, журнал перезапусков этого инцидента и список прошлых инцидентов с длительностью, причиной и теми же данными о перезапусках, если они у инцидента были. Выключенный бот показан именно выключенным, а не офлайн: история инцидентов при этом остаётся на месте. Подробнее о том, как открывается и закрывается инцидент: на странице Проекты и каналы.

Там же настраиваются уведомления:

Уведомлять владельца бота, когда бот офлайн: уведомление получает владелец бота (в колокольчик и на почту), а сообщение от бота уходит в те же чаты, что и уведомление об исчерпании кошелька.
Порог, минут без отметки о жизни: целое число 1–1440, по умолчанию 5. Пустое, дробное и выходящее за границы значение не сохраняется и не подгоняется молча: форма покажет ошибку.

Менять эти два параметра может владелец бота или сотрудник с правом «Реакции»; остальные видят состояние, но не редактируют настройки.

Сменить владельца: передать бота другому аккаунту (необратимо).

Что дальше

REST API и токены: программный доступ.
Проекты и каналы: токен, передача, шаблоны.
Чаты и операторы: роль «Оператор» в работе.
Двухфакторная аутентификация: подключение, коды восстановления и доверенные устройства.

Настройки поддержки и безопасности

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

Только владелец бота может включить обязательную 2FA для участников. Перед включением проверьте число затронутых участников и путь подключения 2FA. Роли управляют доступом к настройкам бота, данным поддержки, аналитике и политике безопасности, но ни поддержка, ни пользователь с ролью не могут увидеть секрет аутентификатора, коды восстановления или токен доверенного устройства другого аккаунта.