В статье описано как настроить оповещения через 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). Шаблоны сообщений]
В нужных шаблонах измените способ отправки на "Telegram" или добавьте для мессенджера новые шаболоны
h2. Работа с абонентам
h3. Дайте абонентам ссылку на бота или просто его название
Сообщите абонентам как найти бота: ссылку можно отправить через SMS или оповестить их создав новость на локальном сайте.
h3. Абонент добавляет бота в свой Telegram
Абоненты должны добавить бота в своем аккаунте мессенджера:
* При первом запуске бот будет требовать логин (подойдет любой, от ЛК или IPTV) или номер телефона.
* После ввода бот узнает абонента и создаст ему новый [реквизит|CarbonBilling:Реквизиты] "Telegram ID", в котором будет сохранён ID контакта в Telegram.
{note}Нельзя изменять этот реквизит или его название вручную!{note}
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). Шаблоны сообщений]
В нужных шаблонах измените способ отправки на "Telegram" или добавьте для мессенджера новые шаболоны
h2. Работа с абонентам
h3. Дайте абонентам ссылку на бота или просто его название
Сообщите абонентам как найти бота: ссылку можно отправить через SMS или оповестить их создав новость на локальном сайте.
h3. Абонент добавляет бота в свой Telegram
Абоненты должны добавить бота в своем аккаунте мессенджера:
* При первом запуске бот будет требовать логин (подойдет любой, от ЛК или IPTV) или номер телефона.
* После ввода бот узнает абонента и создаст ему новый [реквизит|CarbonBilling:Реквизиты] "Telegram ID", в котором будет сохранён ID контакта в Telegram.
{note}Нельзя изменять этот реквизит или его название вручную!{note}