Інтеграція з Telegram

Отримуйте повідомлення в Telegram, коли відгуки потребують уваги. Voxtrics пише в Telegram зі сповіщення — правила, яке стежить за новими відповідями, наприклад «щонайменше 3 оцінки 2 і нижче за годину». Повідомлення надсилає ваш власний бот Telegram у вибраний вами чат: групу, канал або ваш особистий чат із ботом. Voxtrics потрібна одна адреса, у якій є і те, і те: токен бота та ID чату.

Для сповіщень потрібен платний тариф (від Growth). Див. Тариф Free і платні тарифи.

Створіть бота

У Telegram відкрийте @BotFather і надішліть /newbot.
Дайте боту ім'я, наприклад Voxtrics alerts, і юзернейм, що закінчується на bot.
BotFather надішле токен бота — він виглядає так: 123456789:AAHf0x.... Скопіюйте його.

Будь-хто, у кого є токен, може керувати ботом і писати від його імені. Не публікуйте ні токен, ні адресу, яку ви зберете з нього нижче. Якщо токен витік, надішліть BotFather /revoke, отримайте новий і вставте його в правила сповіщень.

Додайте бота в чат

Група: додайте бота в учасники.
Канал: додайте бота адміністратором із правом публікувати повідомлення.
Особистий чат: відкрийте бота й натисніть Start («Запустити»). Бот не може писати тому, хто його не запустив.

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

Дізнайтеся ID чату

Відкрийте в браузері цю адресу, замінивши YOUR_TOKEN на токен бота:
```
https://api.telegram.org/botYOUR_TOKEN/getUpdates
```
Знайдіть у відповіді "chat":{"id": і скопіюйте число після нього. ID групи чи каналу починається з мінуса, наприклад -1001234567890, — мінус потрібен.

Якщо відповідь порожня ("result":[]), надішліть у чат ще одне повідомлення й оновіть сторінку: Telegram зберігає ці дані лише 24 години.

Надсилання сповіщень у Telegram

Підставте токен і ID чату в цю адресу:

https://api.telegram.org/botYOUR_TOKEN/sendMessage?chat_id=YOUR_CHAT_ID

Відкрийте Сповіщення і натисніть Нове сповіщення або значок олівця (Редагувати) в наявного правила.
Задайте назву, область, часове вікно й умову правила — їх описано в розділі Сповіщення.
У блоці Сповіщати через виберіть Telegram і вставте адресу в поле URL вебхука Telegram.
Натисніть Створити сповіщення або Зберегти зміни для наявного правила.

Адреса пише лише в той чат, який у ній указано. Щоб ті самі сповіщення надходили й в інший чат, зберіть адресу для нього й додайте її до правила кнопкою Додати чат Telegram. Одну адресу можна використовувати в кількох правилах.

Що надходить у повідомленні

Щоразу, коли правило спрацьовує, у чат надходить коротке текстове повідомлення англійською: назва правила, домен, скільки відповідей за часове вікно відповідають умові й чому правило спрацювало. Самих відповідей у ньому немає — відкрийте спрацювання в Сповіщеннях, щоб їх побачити.

Правило спрацьовує не частіше ніж раз на 30 хвилин, а з паузою між спрацюваннями — рідше. Сповіщення одного простору надсилають у Telegram і Slack разом не більше 200 повідомлень на день. Понад це правило все одно спрацьовує і спрацювання видно в Сповіщеннях, але повідомлення не надсилається.

Якщо повідомлення не надходять

Якщо сповіщення не зберігається, перевірте, що адреса починається з https://api.telegram.org/. Voxtrics приймає лише адресу Bot API Telegram, а не посилання t.me на чат чи бота.
Перевірте, що правило ввімкнене і спрацьовувало: усі спрацювання видно в Сповіщеннях.
Якщо правило спрацювало, а в Telegram нічого не надійшло, перевірте, що бот досі в чаті (а в каналі — адміністратор), що в ID чату лишився мінус і що токен не відкликано. Коли Telegram перетворює групу на супергрупу, її ID змінюється: дізнайтеся його знову й оновіть адресу.