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

Ключ
Эта строка удалена.
Это слово было удалено. Это слово было добавлено.
Эта строка добавлена.

Изменения (11)

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

{toc}

h2. Настройка

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

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

h3. Настройте его в биллинге
В биллинге: "Настройки" -> "Настройки (в файле)" -> "Настройки демона отправки сообщений"
Например: 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. Перезапустите сервис отправки сообщений

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

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

h3. Дайте абонентам ссылку на бота или просто его название
* После ввода бот узнает абонента и создаст ему новый [реквизит|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".