Настройка телеграм бота

Работа с 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__ и попадают в скрипты через конструкцию глобальных переменных. Функция отлично подходит для подвязки сотни скриптов к одному и тому же боту за один заход. Этим возможности не ограничиваются. Пользователи могут привязывать переменную к плановым окнам ротации или сохранять снапшот перед серьёзными изменениями.