В статье описано как настроить оповещения через Telegram.
- Настройка
- Создайте своего бота в Telegram.
- Настройте его в биллинге
- Перезапустите сервис отправки сообщений
- Убедитесь что настройки применились
- Настройте шаблоны сообщений
- Оповестите абонентов
- Работа с ботом
- В логе зафиксирована ошибка worker - msg_lib - ERROR - Не указан ключ API для PUSH-уведомлений
Настройка
Создайте своего бота в Telegram.
Для этого добавьте себе бота @BotFather, с его помощью создать нового бота, следуя инструкциям.
Username обязательно должен заканчиваться на bot или Bot. Например: BestProviderBot |
@BotFather выдаст Token для вашего нового бота - его необходимо записать.
Подробнее: https://core.telegram.org/bots#creating-a-new-bot
Настройте его в биллинге
В биллинге: "Настройки" -> "Настройки (в файле)" -> "Настройки демона отправки сообщений"
Заполните поля:
- "Бот Telegram" - включите опцию
- "Токен бота Telegram" - введите токен своего бота, полученный при создании;
- "Прокси для Telegram" - укажите прокси, если api.telegram.org не доступен с сервера биллинга;
Прокси укажите в формате - (http|https)://user:pass@host:port
Например: https://user:secret@176.114.8.62:45785
Поддерживаются только HTTP/HTTPS прокси!
Перезапустите сервис отправки сообщений
chroot /app/asr_billing service msgd restart
Убедитесь что настройки применились
Посмотрите в лог /app/asr_billing/var/log/msgd.log, найдите там подобные строки:
msg_lib - INFO - Telegram params: token=952445308:XXXXXXXXXXX_VFpNO5fACP7Buo4CrPFM, proxy=https://user:secret@176.114.8.62:45785
msg_lib - INFO - Telegram Polling Started
Настройте шаблоны сообщений
В биллинге зайдите в настройки шаблонов: "Настройки" -> "Шаблоны сообщений"
В нужных шаблонах измените способ отправки на "Telegram" или добавьте для мессенджера новые шаблоны
Оповестите абонентов
Дайте абонентам ссылку на бота или просто его название
Сообщите абонентам как найти бота: ссылку можно отправить через SMS или оповестить их создав новость на локальном сайте.
Абонент добавляет бота в свой Telegram
Абоненты должны добавить бота в своем аккаунте мессенджера:
- При первом запуске бот будет требовать логин (подойдет любой, от ЛК или IPTV) или номер телефона.
- После ввода бот узнает абонента и создаст ему новый реквизит "Telegram ID", в котором будет сохранён ID контакта в Telegram.
Нельзя изменять этот реквизит или его название вручную!
Работа с ботом
Для начала работы с ботом, введите команду /start, бот предложит ввести номер договора.
Если ввести его неправильно, бот предложит ввести номер договора повторно
Когда Вы введёте правильный номер договора, бот напишет приветствие и меню.
В любой момент можно снова получить меню, набрав команду /help |
Используя команды бота, Вы можете получить информацию о:
- Рекомендуемом платеже для оплаты чтобы проработать это месяц и следующий.
Если рекомендуемый платёж равен "0", вероятно на балансе достаточно средств или нет услуг с абонентской платой. - Текущем тарифе, бот сообщит его наименование и стоимость услуг абонентской платы (только по тарифу, без стоимости доп. услуг)
- Дополнительных услугах, если они есть
- Текущем балансе
В логе зафиксирована ошибка worker - msg_lib - ERROR - Не указан ключ API для PUSH-уведомлений
Обратите внимание на параметр proxy в данном случае он равен None "proxy=None"
2021-09-09 15:03:48,977 - worker - msg_lib - INFO - Telegram params: token=1111111:AAAAAAAAAAAAAA, proxy=None 2021-09-09 15:03:49,512 - worker - msg_lib - INFO - Telegram Polling Started 2021-09-09 15:03:49,512 - worker - msg_lib - ERROR - Не указан ключ API для PUSH-уведомлений
Проверьте корректность настроек отправки уведомлений через "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 прокси! |