Настройка уведомлений через Telegram

Вы можете использовать мессенджер Telegram, чтобы отправлять клиентам информацию о зачислении платежа, открытии услуги, ответе в запросе и т.д. Подробнее см. Виды уведомлений. Для отправки уведомлений платформа использует Telegram-бота.

Бот — это приложение, которое может отправлять сообщения в общий чат или лично пользователю Telegram. Платформа взаимодействует с ботами через API Telegram. Для авторизации используется уникальный токен бота. При настройке уведомлений вы сможете выбрать чаты, в которые бот будет отправлять сообщения.

Чтобы настроить отправку уведомлений в Telegram:

1. Создайте бота в Telegram.
2. Подключите бота к платформе.
3. Добавьте Telegram в качестве канала уведомлений.

Настройка на стороне Telegram

Создайте бота в Telegram. Для этого:

1. Перейдите по ссылке https://t.me/BotFather или найдите в поиске Telegram — @BotFather.
   
   
2. Запустите бота при помощи команды /start.
3. Создайте своего бота командой /newbot. 
4. Введите название бота. Например, Notify Me.
5. Введите уникальное имя пользователя для бота. Оно должно оканчиваться сочетанием bot. Например, notifyme876bot.
6. Сохраните имя бота и значение токена из ответа.

7. Чтобы бот мог отправлять сообщения в группу Telegram:

   1. Добавьте бота в группу. 
   2. Введите любую команду в чате группы. Например, /start.
8. Чтобы бот мог отправлять сообщения пользователю Telegram, пользователь должен открыть диалог с ботом и нажать Запустить.
   

   Пример создания бота

Настройка на стороне BILLmanager

Шлюз сообщений

Чтобы настроить шлюз, перейдите в Интеграция → Шлюзы сообщений → кнопка Создать:

1. Выберите Telegram.
2. Выберите Провайдера, к которому будут привязаны Telegram-уведомления.

3. Типы уведомлений — выберите типы уведомлений, которые будут отправлены через данный шлюз. Если для уведомления не настроен шлюз для отправки, оно будет отправлено через первый подходящий шлюз по способу отправки.

   Примеры

   Пример 1.
   В BILLmanager настроено два шлюза для отправки уведомлений. В настройках первого шлюза для рассылки выбраны типы "Отправка счёта" и "Сообщение от провайдера". В настройках второго шлюза в поле "Типы уведомлений" ничего не выбрано. Через второй шлюз будут проходить все типы уведомлений, кроме тех, которые указаны в настройках первого шлюза.

   Пример 2.
   В BILLmanager для отправки уведомлений настроено два шлюза с id 10 и 15. Для обоих шлюзов выбраны одинаковые типы уведомлений. Уведомления будут отправляться через шлюз с меньшим id — 10. Если сообщения по какой-то причине не были переданы через шлюз с id 10, шлюз с id 15 не отправит эти сообщения.

4. Включите опцию Активировать после создания.
5. Введите Имя бота в Telegram.
6. Укажите Токен, который вы сохранили при создании бота.
7. Укажите Telegram API URL. Оставьте поле пустым, если вы не используете сторонние прокси для Telegram.
8. Введите в поле Ссылка для Webhook адрес вида {BILLmanagerURL}/mancgi/telegram_webhook для получения подтверждений от Telegram. Telegram будет отправлять на этот адрес вебхуки о том, что клиент и бот связаны. Вы можете оставить поле пустым. В этом случае будет использоваться адрес сервера с BILLmanager.
9. Выберите Разметку сообщений от Telegram-бота:
   • HTML;
   • Markdown;
   • MarkdownV2.
10. Выберите опцию Использовать прокси, если нужно отправлять запросы через прокси-сервер. При включённой опции укажите:
    • URL прокси — адрес прокси-сервера. Например, socks5://host:1080, socks5h://host:1080, или  http://host:8080;
    • Имя пользователя — имя пользователя для авторизации на прокси-сервере;
    • Пароль — пароль для авторизации на прокси-сервере.
11. Нажмите Завершить.

Шаблоны сообщений

Настройте шаблоны сообщений для уведомлений через Telegram:

1. Перейдите в Настройки → Шаблоны сообщений → Сообщения для мессенджеров.
2. Заполните нужные вам шаблоны с использованием разметки, выбранной в настройках. По умолчанию шаблоны не заполнены. Для создания сообщений можно использовать те же переменные, что и для email-уведомлений.

<% function EscapeForMarkdown(data) { %>
    <% if (!data || data == '') { return; }%>
    <% return data.replace(/[_*[\]()~'>#+\-=|{}.!\\]/g, "\\$&") %>
<% } %>
*Платёж зачислен*
Здравствуйте, *_<%= EscapeForMarkdown(user.realname) %>_*\!
Уведомляем вас о зачислении оплаты по счёту номер *<%= payment.number %>* на сумму *<%= EscapeForMarkdown(payment.paymethodamount) %> <%= payment.currency.iso %>*\.
Текущий баланс лицевого счёта равен *<%= EscapeForMarkdown(subaccount.balance) %> <%= currency.iso %>*\.

Логирование

Лог взаимодействия биллинговой платформы с Telegram записывается в файл /usr/local/mgr5/var/gwtelegram.log.

Подключение Telegram-уведомлений со стороны клиента

Клиент может выбрать в личном кабинете один или несколько каналов уведомлений. Чтобы получать уведомления через Telegram, клиент:

1. В Личном кабинете переходит в меню Уведомления.
2. Включает нужные уведомления в столбце messenger.
3. В поле Telegram указывает свой логин из Telegram без @.
4. Нажимает Сохранить.
5. Переходит в Telegram и пишет боту. После этого BILLmanager связывает бота и пользователя, и клиент может получать все нужные уведомления в мессенджере.