База знаний GetMyBot

Проекты и каналы

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

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

В GetMyBot реакции и данные принадлежат проекту. К нему можно подключить Telegram-бота по токену из @BotFather, веб-чат и другие каналы. Откройте Проекты в левом меню; активный проект можно сменить переключателем вверху.

Бот больше не ограничен Telegram: к нему можно подключить каналы WhatsApp и VK и обслуживать все мессенджеры одним набором реакций. Обзор: на странице Каналы; подключение WhatsApp: на странице WhatsApp.

Подключение бота

  1. Если проекта ещё нет, откройте Проекты и нажмите Добавить проект. На его карточке нажмите Добавить канал и выберите Telegram. Для первого бота можно пройти мастер онбординга.
  2. Вставьте токен из @BotFather и нажмите Проверить. GetMyBot покажет найденный @username: так вы убедитесь, что вставили правильную строку.
  3. Нажмите Подключить. Токен шифруется при хранении, а приём обновлений запускается сразу.

После подключения Telegram появится на карточке проекта рядом с другими каналами. Карточка показывает название проекта, @username бота, число пользователей, активные реакции и запросы за сегодня. Баланс запросов смотрите в Оплате или Статистике.

Несколько ботов

Один аккаунт ведёт несколько проектов и ботов одновременно: их количество ограничено вашим тарифом (параметр «максимум ботов»). Переключайтесь между проектами сверху или на странице Проекты; разделы «Реакции», «Чаты» и «Статистика» показывают данные выбранного проекта.

Как бот получает сообщения

Платформа принимает обновления от Telegram автоматически: вебхуком или long-поллингом, в зависимости от конфигурации инстанса. Вам не нужно ничего настраивать: достаточно валидного токена. Бот обрабатывает личные сообщения, сообщения в группах и каналах, нажатия inline-кнопок, системные события (вступления/выходы), реакции на сообщения и платежи.

Включение и выключение

У каждого бота есть состояние включён / выключен (карточка «Состояние бота» в Настройках). Выключенный бот не реагирует на сообщения; изменение применяется сразу, без переподключения.

Состояние проекта и доступность канала

В списке Проекты состояние проекта показано отдельно: Активен, На паузе или Заморожен. Это не проверка доставки Telegram. Рядом с каждым каналом стоит собственная метка: В сети, Нет сигнала, Настроен, Выключен или Проект неактивен. Поэтому активный проект с веб-чатом без Telegram не должен выглядеть «остановленным».

Если у активного проекта есть ровно один включённый Telegram-канал, метка В сети означает свежую отметку обслуживающего процесса; при её отсутствии показывается Нет сигнала. При нескольких включённых Telegram-каналах отображается Настроен: общую отметку проекта нельзя надёжно приписать одному из них. У включённых каналов других платформ Настроен означает подключённый канал, а не обещание доставки каждого сообщения.

Платформа работает не одним процессом, а несколькими равноправными. Каждый из них раз в 30 секунд отмечается по боту, которого ведёт. Отметка считается свежей в пределах полутора минут: одна пропущенная отметка не должна мигать статусом.

Что из этого следует на практике:

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

Что происходит, когда бот офлайн

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

Причин четыре, и каждая видна в карточке «Здоровье бота» в настройках:

  • вебхук: Telegram не доставляет обновления на адрес платформы, и она регистрирует его заново;
  • отозван токен: getMe отвечает 401. Такой инцидент не перезапускается: токен нужно заменить в @BotFather и вставить через «Сменить токен»;
  • нет обслуживающего сервера: обновления никто не разбирает, и платформа перезапускает бота;
  • причина не определена: Telegram не ответил на проверку.

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

Когда бот молчит дольше порога из карточки «Здоровье бота» (по умолчанию 5 минут), владелец бота получает уведомление «Бот офлайн» в колокольчик и на почту, а чаты из списка получателей уведомлений получают сообщение от самого бота. Уведомление одно на инцидент; когда отметки о жизни возвращаются, приходит «Бот снова онлайн» с длительностью перерыва. Список прошлых инцидентов с длительностью и причиной остаётся в той же карточке.

Заморозка по тарифу

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

  • превышен лимит ботов: вы перешли на тариф, где ботов меньше, чем подключено сейчас;
  • подписка не продлена: платный тариф закончился, и действует бесплатный с его лимитом.

Замороженный бот не принимает сообщения: приём обновлений для него выключается, а не просто помечается флажком. Данные, реакции и подписчики сохраняются полностью: заморозка обратима.

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

Отдельно от заморозки бота существует заморозка всего аккаунта: тогда приостановлены все боты и рассылки сразу, а в кабинете висит баннер «Аккаунт заморожен». Снимается она только через поддержку. См. Платежи и баланс.

Профиль и синхронизация

Кнопка Синхронизировать в Настройках обновляет название бота из Telegram (если вы переименовали его в @BotFather). Аватар пользователя бота подтягивается автоматически.

Смена токена

Если вы перевыпустили токен в @BotFather (Bot Settings → Revoke / New token), обновите его в Настройки → Сменить токен. Новый токен должен принадлежать тому же боту (совпадать по внутреннему ID Telegram): так сохраняются все реакции, подписчики и данные.

Передача бота другому аккаунту

Настройки → Сменить владельца передаёт бота другому аккаунту GetMyBot по email. Действие необратимо: после передачи вы теряете доступ к боту. Используйте при передаче проекта клиенту или коллеге.

Шаблоны ботов

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

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

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

Что дальше