База знаний GetMyBot

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

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

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

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

Перед изменением проверьте выбранный проект вверху кабинета. Доступ к одному проекту и ко всему кабинету настраивается отдельно. Вверху раздела также показаны состояние бота, число пользователей и расход запросов.

Основные

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

Поведение

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

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

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

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

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

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

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

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

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

Роли

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

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

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

Права

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

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

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

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

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

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

Повторное приглашение на тот же адрес заменяет прежнее: приходит новая ссылка на 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 часа. До принятия проект остаётся у вас, приглашение можно отменить. После принятия вы потеряете доступ к проекту.

Что дальше

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

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

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