В статье описано как настроить оповещения через 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
Например: https://user:secret@176.114.8.62:45785
Поддерживаются только HTTP/HTTPS прокси!{info}
* "URL Telegram Bot API Server" - адрес [локального|https://core.telegram.org/bots/api#using-a-local-bot-api-server] сервера Telegram Bot API, указывается вместе с протоколом, например {{https://telegram.isp.ru/bot}}
{info}Локальный сервер может потребоваться, если Вам недостаточно возможностей публичного сервера или если Вы хотите перехватывать запросы от биллинга к боту.
Код локального сервера и инструкция по установке доступны на [github|https://github.com/tdlib/telegram-bot-api]
Если локальный сервер не требуется, оставьте поле пустым.
{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. Настройте шаблоны сообщений
В биллинге зайдите в настройки шаблонов: ["*Настройки*" -> "*Шаблоны сообщений*"|Система отправки сообщений (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!
* Текущем балансе
!telegram_new_info_balance.png|border=0,width=350!
{info}Проверьте корректность настроек отправки уведомлений через "Telegram" обратившись к документации http://docs.carbonsoft.ru/x/oQFICQ
Обратите внимание на пункт "Прокси для Telegram" - укажите прокси, если api.telegram.org не доступен с сервера биллинга;
Прокси укажите в формате - (http|https)://user:pass@host:port
Например: https://user:secret@176.114.8.62:45785
Поддерживаются только HTTP/HTTPS прокси!
{info}
h3. Как узнать имя бота с помощью токена.
Узнать имя бота можно с помощью ссылки:
{code}https://api.telegram.org/bot(токен)/getMe{code}
Вместо скобок нужно указать токен своего бота.
Далее всю строку скопировать в адресную строку браузера.
Название бота будет указано в поле "username".
{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
Например: https://user:secret@176.114.8.62:45785
Поддерживаются только HTTP/HTTPS прокси!{info}
* "URL Telegram Bot API Server" - адрес [локального|https://core.telegram.org/bots/api#using-a-local-bot-api-server] сервера Telegram Bot API, указывается вместе с протоколом, например {{https://telegram.isp.ru/bot}}
{info}Локальный сервер может потребоваться, если Вам недостаточно возможностей публичного сервера или если Вы хотите перехватывать запросы от биллинга к боту.
Код локального сервера и инструкция по установке доступны на [github|https://github.com/tdlib/telegram-bot-api]
Если локальный сервер не требуется, оставьте поле пустым.
{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. Настройте шаблоны сообщений
В биллинге зайдите в настройки шаблонов: ["*Настройки*" -> "*Шаблоны сообщений*"|Система отправки сообщений (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!
* Текущем балансе
!telegram_new_info_balance.png|border=0,width=350!
{info}Проверьте корректность настроек отправки уведомлений через "Telegram" обратившись к документации http://docs.carbonsoft.ru/x/oQFICQ
Обратите внимание на пункт "Прокси для Telegram" - укажите прокси, если api.telegram.org не доступен с сервера биллинга;
Прокси укажите в формате - (http|https)://user:pass@host:port
Например: https://user:secret@176.114.8.62:45785
Поддерживаются только HTTP/HTTPS прокси!
{info}
h3. Как узнать имя бота с помощью токена.
Узнать имя бота можно с помощью ссылки:
{code}https://api.telegram.org/bot(токен)/getMe{code}
Вместо скобок нужно указать токен своего бота.
Далее всю строку скопировать в адресную строку браузера.
Название бота будет указано в поле "username".