База знань GetMyBot

Проєкти й канали

Як створити проєкт, підключити бота й перевірити його стан. Кілька каналів, зміна токена, пауза та відновлення після заморозки.

На цій сторінці

Проєкт об’єднує налаштування, реакції та дані одного вашого бота чи сервісу. Канал зв’язує його з місцем спілкування: Telegram-ботом, чатом на сайті або іншим месенджером. Наприклад, школа може мати один проєкт із двома каналами – Telegram і сайтом.

Створіть проєкт у розділі Проєкти, а потім додайте до нього канал. Для Telegram потрібен токен від @BotFather, ключ керування ботом. Між проєктами можна перемикатися вгорі кабінету.

Бот не обмежений Telegram: до нього можна підключити WhatsApp і VK та використовувати ті самі реакції в усіх месенджерах. Огляд – у статті Канали, інструкція з підключення – у статті WhatsApp.

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

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

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

Кілька ботів

Один акаунт може вести кілька проєктів і ботів одночасно. Їхня кількість обмежена тарифом, параметром «максимум ботів». Перемикайтеся між проєктами вгорі кабінету або на сторінці Проєкти. Розділи «Реакції», «Чати» та «Статистика» показують дані вибраного проєкту.

Як бот отримує повідомлення

Після підключення GetMyBot автоматично приймає події Telegram: повідомлення, натискання кнопок, вступи до чату й платежі. Окремо налаштовувати приймання не потрібно, достатньо дійсного токена. Залежно від налаштувань сервера Telegram надсилає події на адресу платформи (вебхук) або платформа регулярно запитує їх у Telegram (long polling).

Увімкнення та вимкнення

У кожного бота є стан увімкнений / вимкнений. Перемикач знаходиться в картці Стан бота в Налаштуваннях. Вимкнений бот не реагує на повідомлення. Зміна застосовується одразу, без повторного підключення.

Стан проєкту й доступність каналу

У списку Проєкти стан проєкту показано окремо: Активний, На паузі або Заморожений. Це не перевірка доставки Telegram. Поряд із кожним каналом є власна позначка: Онлайн, Немає сигналу, Налаштований, Вимкнений або Проєкт неактивний. Тому активний проєкт із вебчатом, але без Telegram не має виглядати зупиненим.

Якщо в активного проєкту рівно один увімкнений Telegram-канал, Онлайн означає, що процес, який обслуговує бота, нещодавно надіслав відмітку. Якщо свіжої відмітки немає, показано Немає сигналу. За кількох увімкнених Telegram-каналів показано Налаштований: спільну відмітку проєкту неможливо надійно віднести до одного з них. Для увімкнених каналів інших платформ Налаштований означає підключення, а не гарантію доставки кожного повідомлення.

Платформу обслуговує не один процес, а кілька рівноправних. Кожен із них раз на 30 секунд позначається для ботів, яких обслуговує. Відмітка вважається свіжою протягом півтори хвилини, щоб один пропуск не спричиняв миготіння статусу.

Що це означає на практиці:

  • Позначка може з’явитися із затримкою. Після підключення або перезапуску платформи Онлайн може з’явитися не відразу, а протягом зазначеного часу.
  • Якщо Немає сигналу тримається понад кілька хвилин для увімкненого Telegram-каналу, перевірте токен і картку Bot health в Налаштуваннях. Проєкт залишається активним, доки ви не поставите його на паузу або платформа не заморозить його через тариф.
  • Відмітка спільна для процесів і не залежить від того, який сервер відповів на ваш запит. За кількох Telegram-каналів вона не доводить доступності кожного окремо.

Що відбувається, коли бот офлайн

Раз на хвилину платформа перевіряє відмітки про роботу. Якщо увімкнений бот не має жодної свіжої відмітки, відкривається інцидент: платформа один раз визначає причину й далі сама намагається відновити роботу.

У картці Bot health в Налаштуваннях відображається одна з чотирьох причин:

  • Вебхук: Telegram не доставляє події на адресу платформи, тому вона реєструє вебхук знову.
  • Токен відкликано: getMe відповідає 401. Автоматичний перезапуск тут не допоможе: створіть новий токен в @BotFather і вставте його через Змінити токен.
  • Немає сервера, що обслуговує бота: ніхто не обробляє події, і платформа перезапускає бота.
  • Причину не встановлено: Telegram не відповів на перевірку.

Перезапуск виконує те саме, що кнопка Синхронізувати: перевіряє токен через getMe і знову реєструє вебхук. Повторні спроби відбуваються зі збільшенням пауз. Кожна потрапляє до журналу перезапусків інциденту: час, результат і текст помилки, якщо спроба не вдалася. Там також видно час наступної спроби.

Коли бот мовчить довше за поріг із картки Bot health (типово 5 хвилин), власник отримує сповіщення «Бот офлайн» через дзвіночок і поштою. Чати зі списку отримувачів сповіщень отримують повідомлення від самого бота. На інцидент надходить лише одне таке сповіщення. Коли відмітки повертаються, надходить «Бот знову онлайн» із тривалістю перерви. Історія інцидентів із тривалістю та причиною зберігається в тій самій картці.

Заморозка через тариф

Окрім станів «увімкнений / вимкнений», бот може бути замороженим. Його заморожує платформа, а не користувач, коли поточний тариф більше не покриває кількість підключених ботів. Причин рівно дві:

  • Перевищено ліміт ботів: ви перейшли на тариф, що дозволяє менше ботів, ніж зараз підключено.
  • Підписку не продовжено: оплачений тариф закінчився й діє ліміт безкоштовного тарифу.

Заморожений бот не отримує повідомлень: приймання подій для нього вимикається, а не лише змінюється позначка. Дані, реакції та підписники повністю зберігаються, тому заморозку можна скасувати.

Як розморозити. Оплатіть тариф, який покриває потрібну кількість ботів. У момент активації оплаченого тарифу боти відновлюються автоматично, починаючи з найстаріших, доки не вичерпається ліміт нового тарифу. Вибрати, який бот повернеться першим, не можна. Якщо потрібні не найстаріші, спершу видаліть зайві підключення, а потім оплатіть тариф.

Окремо може бути заморожено весь акаунт. Тоді одночасно призупинено всіх ботів і розсилки, а в кабінеті з’являється банер «Акаунт заморожено». Таку заморозку може зняти лише підтримка. Докладніше – у статті Платежі та баланс.

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

Кнопка Синхронізувати в Налаштуваннях оновлює ім’я бота з Telegram, наприклад після перейменування в @BotFather. Аватар бота завантажується автоматично.

Зміна токена

Якщо ви перевипустили токен у @BotFather (Bot Settings → Revoke / New token), оновіть його в Налаштування → Канали → Telegram 🔑. Новий токен має належати тому самому боту (збігатися за внутрішнім ID Telegram) — так зберігаються всі реакції, підписники та дані. Якщо канал Telegram не відображається, виберіть «Змінити токен» у тому самому вікні.

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

Налаштування → Змінити власника надсилає запрошення передати проєкт іншому акаунту GetMyBot за email-адресою. Запрошення діє 72 години. Поки отримувач його не прийняв, проєкт залишається у вас і передачу можна скасувати. Після прийняття власник зміниться, і ви втратите доступ до проєкту. Використовуйте цю функцію, коли передаєте проєкт клієнту або колезі.

Шаблони ботів

Шаблон зберігає налаштування бота й усі його реакції як знімок, який можна застосувати до іншого бота:

  • Створити шаблон у Налаштуваннях зберігає поточного бота як шаблон із назвою.
  • Застосувати шаблон замінює налаштування вибраного бота налаштуваннями з шаблону, а реакції з шаблону додає до наявних.

Так зручно повторювати типове налаштування в кількох проєктах.

Установлення готового рішення з каталогу

Для готових рішень із каталогу є майстер установлення. Укажіть параметри, перевірте сумісність і потрібні підключення, а потім перегляньте перелік ресурсів, які буде створено. Після встановлення виконайте решту кроків і перевірте сценарій на тестовому зверненні.

Цей майстер відрізняється від застосування знімка бота з попереднього розділу. Перевірка перед установленням показує відсутні параметри або можливості. Позначка про виконання кроку не підтверджує роботу зовнішнього сервісу.

Показники готового рішення

Виберіть період, за який хочете оцінити роботу встановленого рішення. Для порівняння виберіть доступний режим і перевірте розмір вибірки та результати діагностики. Брак даних і відсутність порівняння – це не результат, що дорівнює нулю.

Що далі