Настройки, команда и доступ
Как изменить поведение бота, добавить сотрудника, ограничить его права и включить тестовый режим. Доступ к проекту и всему кабинету.
На этой странице
В Настройках меняют общие правила работы бота и доступ команды. Например, можно включить тестовый режим для себя, пригласить оператора только к переписке или выдать администратору право редактировать реакции.
Перед изменением проверьте выбранный проект вверху кабинета. Доступ к одному проекту и ко всему кабинету настраивается отдельно. Вверху раздела также показаны состояние бота, число пользователей и расход запросов.
Основные
- Обращение: слово или имя, по которому участники обращаются к боту в группе, если эта настройка используется.
- Позиция в списке: порядок бота среди других.
- Режим показа пользователей: «Показывать всех» / «Только активных» / «Только оплативших».
- Язык интерфейса: Русский / 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 и заново настроить приём сообщений, если бот активен. Это обычный способ восстановить связь, когда бот показан офлайн; повторить действие безопасно. Остальные настройки, статус и порядок бота не меняются. Технические детали: сначала вызывается Telegram
getMe, затем состояние бота перечитывается; вебхук регистрируется только дляactive. Если Telegram-канал изначально выключен, проверка завершается доgetMe. При состоянияхpausedиfrozenприём сообщений не запускается. Если канал отключили или бота активировали одновременно с синхронизацией, название может сохраниться до сообщения об ошибке. Если Telegram отклонил новый вебхук, подтверждённое название сохраняется, новый приёмник отбрасывается, а уже работающий процесс бота продолжает работать и сообщать, что он на связи. - Каналы: подключить канал или обновить его учётные данные, в том числе токен Telegram после перевыпуска в @BotFather. Если карточка Telegram не отображается, нажмите «Сменить токен» в том же окне.
Пересылка сообщений пользователей
Для пересылки у проекта должен быть ровно один включённый Telegram-канал. Включите «Пересылать сообщения пользователей» и выберите чат, в котором бот может писать. При необходимости укажите числовой ID топика. Сохраните настройки внизу страницы. Сообщения приходят с данными отправителя и временем исходного сообщения.
Чтобы напомнить команде о диалоге без ответа, нажмите «Добавить напоминание» и укажите число минут от первого сообщения. Можно добавить до 20 возрастающих интервалов от 1 до 43 200 минут. Напоминания прекращаются после доставленного ответа. В группе ответить на уведомление или напоминание может администратор или создатель чата со своего аккаунта; анонимный администратор не проходит проверку. Для надёжной проверки прав бот должен быть администратором группы. В личном чате ответить может его собеседник. Для WhatsApp действует обычное 24-часовое окно ответа; после его закрытия используйте одобренный шаблон в сервисе.
Здоровье бота
Карточка «Здоровье бота» показывает, доступен ли бот сейчас. Если обнаружен сбой, здесь видны его причина, число автоматических перезапусков, время следующей попытки и последняя ошибка. Можно посмотреть историю перезапусков текущего сбоя и прошлые сбои с их длительностью и причиной. Выключенный вами бот показан как выключенный, а не как бот со сбоем; история прежних сбоев сохраняется. Подробнее: Проекты и каналы.
Там же настраиваются уведомления:
- Уведомлять владельца бота, когда бот офлайн: уведомление получает владелец бота (в колокольчик и на почту), а сообщение от бота уходит в те же чаты, что и уведомление об исчерпании кошелька.
- Порог, минут без отметки о жизни: целое число 1–1440, по умолчанию 5. Пустое, дробное и выходящее за границы значение не сохраняется и не подгоняется молча: форма покажет ошибку.
Менять эти два параметра может владелец бота или сотрудник с правом «Реакции»; остальные видят состояние, но не редактируют настройки.
- Сменить владельца: отправить приглашение новому владельцу. Оно действует 72 часа. До принятия проект остаётся у вас, приглашение можно отменить. После принятия вы потеряете доступ к проекту.
Что дальше
- REST API и токены: программный доступ.
- Проекты и каналы: токен, передача, шаблоны.
- Чаты и операторы: роль «Оператор» в работе.
- Двухфакторная аутентификация: подключение, коды восстановления и доверенные устройства.
Настройки поддержки и безопасности
В настройках поддержки задаются часовой пояс, рабочие часы по дням недели, перерывы, смены через полночь, праздники и автоответы для рабочего и нерабочего времени. Можно указать запасную группу для обращений, когда основные операторы недоступны. Перед сохранением расписания проверьте предварительный просмотр. Система назначит диалог подходящему оператору с наименьшей нагрузкой, передаст его запасной группе или оставит без назначения.
Только владелец бота может включить обязательную 2FA для участников. Перед включением проверьте число затронутых участников и путь подключения 2FA. Роли управляют доступом к настройкам бота, данным поддержки, аналитике и политике безопасности, но ни поддержка, ни пользователь с ролью не могут увидеть секрет аутентификатора, коды восстановления или токен доверенного устройства другого аккаунта.