... В статье описано как настроить оповещения через Telegram.
h2. Настройка
h3. Создайте своего бота в Telegram.
Для этого добавьте себе бота @BotFather, с его помощью создать нового бота, следуя инструкциям.
{note}Имя обязательно должно заканчиваться на *bot* или *Bot*.{note}
@BotFather выдаст Token для вашего нового бота - его необходимо записать.
Подробнее: https://core.telegram.org/bots#creating-a-new-bot
h3. Настройте его в биллинге
В биллинге: "Настройки" -> "Настройки (в файле)" -> "Настройки демона отправки сообщений"
Заполните поля:
* "Бот Telegram" - включите опцию
* "Токен бота Telegram" - введите токен своего бота, полученный при создании;
* "Прокси для Telegram" - укажите прокси, если api.telegram.org не доступен с сервера биллинга;
{info}Прокси укажите в формате - (http|https)://user:pass@host:port
Например: https://user:secret@176.114.8.62:45785
Поддерживаются только HTTP/HTTPS прокси!{info}
h3. Перезапустите сервис отправки сообщений
{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. Настройте шаблоны сообщений
В биллинге зайдите в настройки шаблонов: ["*Настройки*" -> "*Шаблоны сообщений*"|CarbonBilling:Система отправки сообщений (sms,email). Шаблоны сообщений]
|
... Сообщите абонентам как найти бота: ссылку можно отправить через 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!
* Текущем балансе
!telegram_new_info_balance.png|border=0,width=350!
|
