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

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

В этой статье описано как подключить и настроить в BILLmanager уведомления клиентов через Telegram-бота.

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

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

1. Перейдите по ссылке https://t.me/BotFather или найдите в поиске Telegram — @BotFather.
   
2. Запустите бота при помощи команды /start.
3. Создайте своего бота командой /newbot. Придумайте название для бота и его пользователя.
   
4. Сохраните имя бота и token из последнего сообщения.

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

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

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

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

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

   Примеры

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

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

4. Включите опцию Активировать после создания.
5. Введите Имя бота в Telegram.
6. Укажите Токен, который вы сохранили при создании бота.
7. Введите в поле Ссылка для Webhook адрес вида {BILLmanagerURL}/mancgi/telegram_webhook для получения подтверждений от Telegram. Telegram будет посылать на этот адрес вебхуки о том, что клиент и бот связаны. Вы можете оставить поле пустым. В этом случае будет использоваться адрес сервера с BILLmanager.
8. Выберите Разметку сообщений от Telegram-бота:
   • HTML;
   • Markdown;
   • MarkdownV2.

9. Нажмите Завершить.
   

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

Настройте шаблоны сообщений для уведомлений через 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 связывает бота и пользователя, и клиент может получать все нужные уведомления в мессенджере.