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

В статье описано как настроить оповещения через Telegram.

{toc}

h2. Настройка

h3. Создайте своего бота в Telegram.
Для этого добавьте себе бота [@BotFather|https://t.me/botfather], с его помощью создать нового бота, следуя инструкциям.
{note}Username обязательно должен заканчиваться на *bot* или *Bot*. Например: BestProviderBot{note}
@BotFather выдаст Token для вашего нового бота - его необходимо записать.
Подробнее: https://core.telegram.org/bots#creating-a-new-bot

!CreateTelegramBot1.gif|border=1,width=400!

h3. Настройте его в биллинге
В биллинге: "Настройки" -> "Настройки (в файле)" -> "Настройки демона отправки сообщений"
Заполните поля:
* "Бот Telegram" - включите опцию
* "Токен бота Telegram" - введите токен своего бота, полученный при создании;
* "Прокси для Telegram" - укажите прокси, если api.telegram.org не доступен с сервера биллинга;
{info}Прокси укажите в формате - (http|https)://user:pass@host:port

{code}chroot /app/asr_billing service msgd restart{code}

h3. Убедитесь что настройки применились
Посмотрите в лог */app/asr_billing/var/log/msgd.log*, найдите там подобные строки:
{code}msg_lib - INFO - Telegram params: token=952445308:XXXXXXXXXXX_VFpNO5fACP7Buo4CrPFM, proxy=https://user:secret@176.114.8.62:45785
msg_lib - INFO - Telegram Polling Started{code}

h3. Настройте шаблоны сообщений
В биллинге зайдите в настройки шаблонов: ["*Настройки*" -> "*Шаблоны сообщений*"|Система отправки сообщений (sms,email и тд). Шаблоны сообщений]
В нужных шаблонах измените способ отправки на "Telegram" или добавьте для мессенджера новые шаблоны

h2. Оповестите абонентов

h3. Дайте абонентам ссылку на бота или просто его название
Сообщите абонентам как найти бота: ссылку можно отправить через SMS или оповестить их создав новость на локальном сайте.

h3. Абонент добавляет бота в свой Telegram

Абоненты должны добавить бота в своем аккаунте мессенджера:
* При первом запуске бот будет требовать логин (подойдет любой, от ЛК или IPTV) или номер телефона.
* После ввода бот узнает абонента и создаст ему новый [реквизит|CarbonBilling:Реквизиты] "Telegram ID", в котором будет сохранён ID контакта в Telegram.
{note}Нельзя изменять этот реквизит или его название вручную!{note}

h2. Работа с ботом

Для начала работы с ботом, введите команду */start*, бот предложит ввести номер договора.

!telegram_new_start.png|border=0,width=350!

Если ввести его неправильно, бот предложит ввести номер договора повторно

!telegram_new_error_contract.png|border=0,width=350!

Когда Вы введёте правильный номер договора, бот напишет приветствие и меню.
{info}В любой момент можно снова получить меню, набрав команду */help*{info}

!telegram_new_contract.png|border=0,width=350!

Используя команды бота, Вы можете получить информацию о:

* Рекомендуемом платеже для оплаты чтобы проработать это месяц и следующий.
{info}Если рекомендуемый платёж равен "0", вероятно на балансе достаточно средств или нет услуг с абонентской платой.{info}
!telegram_new_info_pay_sum.png|border=0,width=350!
* Текущем тарифе, бот сообщит его наименование и стоимость услуг абонентской платы (только по тарифу, без стоимости доп. услуг)
!telegram_new_info_tarif.png|border=0,width=350!
* Дополнительных услугах, если они есть
!telegram_new_info_services.png|border=0,width=350!
* Текущем балансе

Прокси укажите в формате - (http|https)://user:pass@host:port
Например: https://user:secret@176.114.8.62:45785