Интеграция с 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: узнайте его заново и обновите адрес.