Налаштування телеграм-бота для Afina#

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

Перш ніж почати#

Перед початком у вас має бути встановлений Telegram і доступ до вашої Afina.

Створення Telegram-бота#

1. Відкрийте Telegram.
2. У полі «Пошук» введіть @BotFather.
3. Відкрийте чат із @BotFather.
4. Натисніть Start.
5. Натисніть Create a New Bot.
6. У верхньому полі введіть назву бота.
7. У нижньому полі введіть унікальний username бота.
8. Натисніть Create Bot.

На скріншоті нижче показано відкритий чат із @BotFather, у якому доступна кнопка Create a New Bot.

Наступний скріншот показує форму New bot із полями для назви, опису та username і кнопкою Create Bot.

9. Після створення бота відкрийте його налаштування.
10. Натисніть Copy біля API-токена.

На скріншоті нижче показано сторінку створеного бота з кнопкою Copy для копіювання API-токена.

Підключення Telegram в Afina#

1. У правому верхньому куті Afina натисніть іконку налаштувань.
2. У випадаючому меню виберіть Основні налаштування Afina.
3. У вікні «Основні налаштування Afina» відкрийте вкладку API.

На скріншоті нижче показано перехід до Основні налаштування Afina, відкриту вкладку API, поле «API ключ Telegram» і перемикач «Увімкнути Telegram».

4. У полі «API ключ Telegram» вставте токен, який ви скопіювали в Telegram.
5. Лише після вставлення токена увімкніть перемикач «Увімкнути Telegram». Якщо увімкнути Telegram до додавання ключа, бот не авторизується.
6. Натисніть Зберегти зміни.

Отримання ID чату#

1. Поверніться до Telegram.
2. У полі «Пошук» знайдіть створеного бота за його username.
3. Відкрийте чат із ботом.
4. Натисніть Розпочати або надішліть команду Start. Це обов'язковий крок: без запуску бота повідомлення не надсилатимуться, а Telegram-блок у скриптах може давати помилку.

На скріншоті нижче показано чат зі створеним Telegram-ботом і кнопку Розпочати.

5. Дочекайтеся повідомлення від бота з ID чату. Копіювати ID не потрібно: після запуску бота він автоматично додається в розділ «Telegram» в Afina.

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

Налаштування чату в Afina#

1. Поверніться до Afina.
2. У лівому меню відкрийте розділ Налаштування.
3. Виберіть пункт Telegram.
4. Знайдіть підключений чат у списку. Якщо запис не з'явився, натисніть іконку Оновити сторінку.
5. Перевірте, що ID чату в Afina збігається з ID чату з повідомлення бота.
6. Натисніть іконку олівця праворуч від потрібного чату.

На скріншоті нижче показано розділ Telegram, у якому видно ID чату і іконку олівця для редагування прав доступу.

7. У вікні «Редагувати права доступу до Telegram» у полі «Тип сповіщення» виберіть потрібний варіант: «Усі» для всіх сповіщень, «Читати» для повідомлень читання, «Скрипти» для подій зі скриптів.
8. За потреби заповніть поле «Тег», щоб промаркувати чат і швидше знаходити потрібний доступ.
9. Увімкніть чекбокс «Увімкнути».
10. Натисніть Зберегти.

На скріншоті нижче показано вікно «Редагувати права доступу до Telegram» з полем «Тип сповіщення», полем «Тег» і чекбоксом «Увімкнути».

Щоб у Telegram-повідомленнях було видно, який акаунт надіслав сповіщення, відкрийте вкладку «Скрипти» в «Основних налаштуваннях Afina» і додайте змінну ${accountName} у поле «Формат заголовка Telegram».

До Telegram-бота можна додати не тільки власний Telegram, а й кілька інших чатів. Для кожного чату можна окремо налаштувати доступи, тип сповіщення, тег і чекбокс «Увімкнути».

Результат#

Після виконання цих кроків Telegram буде підключений до Afina: API ключ Telegram збережеться в налаштуваннях, потрібний ID чату автоматично з'явиться в розділі «Telegram», а всі сповіщення, які ви налаштуєте для цього чату, надходитимуть у Telegram-бот.