Налаштування телеграм бота

Робота з Telegram-ботом в Afina

Інтеграція Telegram Bot — центральний хаб месенджингу в Afina. Це те місце, де кожне сповіщення, команда та віддалений сигнал знаходить свій дім. Користувач отримує зручний досвід: налаштувати бота через BotFather, прописати API-токен в Afina та запускати скрипти, які шлють повідомлення, реагують на події й оновлюють операторів у реальному часі. Крім того, інтеграція відповідає за надійне керування токенами ботів, списками чатів, тегами отримувачів, типами сповіщень і даними месенджингу, прив'язаними до кожного скрипта.

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

Переваги особистого Telegram-бота

• Через змінну __telegram__api__ доступний широкий набір типів повідомлень під будь-яке бізнес-завдання.
• Користувачі налаштовують, які чати отримують які повідомлення, через правильне розмічування отримувачів тегами.
• Сценарії автоматизації без зусиль звертаються до чату через API-токен бота.
• Інтеграція підтримує як одиничні сповіщення, так і повноцінні діалогові потоки в будь-який момент.
• Будь-який користувач отримує зручний досвід побудови автоматизації навколо Telegram з унікальною конфігурацією бота.

Після збереження бота нова інтеграція стає в загальний список розділу «Налаштування». З цього моменту її можна пов'язувати з повідомленнями у скриптах, редагувати правила сповіщень, прив'язувати бота до пайплайна, позначати старих отримувачів на чищення, чіпляти потрібний токен до робочого процесу та відправляти інтеграцію в задачі автоматизації. Таким чином, кожен щойно зібраний бот одразу готовий до роботи.

Створення бота через BotFather

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

Крім того, команда /newbot усередині BotFather дає безперервний доступ до реєстрації бота. Користувач обирає ім'я та унікальний username і надсилає обидва значення в BotFather. Решту платформа бере на себе.

Більше того, потік створення бота підтримує пов'язану видачу токена. Тож користувач може підтягнути API-токен прямо з чату з BotFather, щойно реєстрація завершилася. Після завершення реєстрації новий ключ осідає в чаті й одразу готовий до запуску, налаштування та використання у скриптах.

Прокидаємо токен в Afina

Під різні бізнес-завдання доступні різні сценарії підключення. Користувач може прокидати токени по одному або ротувати цілу пачку ботів при змінах у каталозі. Для звичайного чищення достатньо відмітити рядки у списку змінних чекбоксами. Сама опція ротації знаходиться у списку глобальних змінних у верхній частині розділу «Налаштування».

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

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

Зберігання API-токена

Кожен Telegram-бот в Afina здатен нести великий набір даних по ключах. Ці дані — саме те, до чого звертаються скрипти й задачі автоматизації під час роботи. Наприклад, API-токени ботів, ідентифікатори чатів, теги отримувачів, варіанти сповіщень, резервні отримувачі та будь-які інші параметри, які в кожного бота свої.

Найцінніше в цій функціональності — повторне використання. Один ключ можна застосовувати скрізь і отримувати однаково стабільні результати. Кожен скрипт підставляє свій ключ, коли виклик доходить до кроку месенджингу. Замість клонування ключа під кожен скрипт користувач просто грамотно готує змінну. Таким чином, автоматизація стає гнучкішою.

Крім того, Afina пропонує два формати зберігання ключів: стандартний та зашифрований. Зашифровані ключі призначені для чутливої інформації, яку не варто тримати у відкритому вигляді. Наприклад, API-токени, OAuth-секрети, recovery-коди та будь-які інші конфіденційні значення, які користувач хоче захистити.

Обидва формати ключів дотримуються шаблону іменування __telegram__api__ і потрапляють у скрипти через конструкцію глобальних змінних. Функція ідеально підходить для прив'язки сотні скриптів до одного й того самого бота за один захід. Цим можливості не обмежуються. Користувачі можуть прив'язувати змінну до планових вікон ротації або зберігати знімок перед серйозними змінами.