Различия

Здесь показаны различия между двумя версиями данной страницы.

Ссылка на это сравнение

Предыдущая версия справа и слева Предыдущая версия
Следующая версия
Предыдущая версия
abills:docs:manual:sender:telegram [2017/08/09 17:18]
anton [Запуск и привязка бота к биллингу]
abills:docs:manual:sender:telegram [2017/12/13 12:42]
snuryus
Строка 7: Строка 7:
 На данном этапе, используется один бот для администраторов и клиентов (для каждого создаётся свой уникальный чат). На данном этапе, используется один бот для администраторов и клиентов (для каждого создаётся свой уникальный чат).
  
-Для правильной работы,​ нужно использовать новую модель контактов (''​$conf{CONTACTS_NEW} = 1''​).\\+Возможности 
 +  * Рассылка для подписаных клиентов 
 +  * Возможность вести переписку из Helpdesk в чате Telegram (одновременно по всем заявкам) 
 +  * [[abills:​docs:​manual:​user_portal:​telegram_bot:​ru|Возможность просматривать информацию и управлять некоторыми функциями непосредственно из Telegram]]. 
 + 
 +Для правильной работы, ​[[abills:​docs:​manual:​misc_soft#​konvertacija_kontaktov_polzovatelja_v_format_novyx_kontaktov|нужно использовать новую модель контактов]] (''​$conf{CONTACTS_NEW} = 1''​).\\
  
 Клиенты могут подписаться через кнопку на первой странице кабинета.\\ Клиенты могут подписаться через кнопку на первой странице кабинета.\\
Строка 17: Строка 22:
 Кнопка формирует ссылку с секретом,​ который передастся приложением Telegram.\\ Кнопка формирует ссылку с секретом,​ который передастся приложением Telegram.\\
  
-В планах расширить возможности бота для запроса базовой информации с билинга (баланс,​ сума и дата следующего платежа и т.д). 
  
 ==== Создание бота ==== ==== Создание бота ====
Строка 39: Строка 43:
 7) Бот создан! 7) Бот создан!
  
 +==== Локализация интерфейса ==== 
 +По умолчанию,​ бот общается с пользователями на языке ''​$conf{default_language}''​. Есть возможность отправлять каждому пользователю сообщения на своём языке. Для этого добавьте информационное поле ''​_language''​ (обратите внимание на дополнительное ''​_''​). После этого, пользователь сможет менять язык через команду ''/​language''​.
 ==== Запуск и привязка бота к биллингу ==== ==== Запуск и привязка бота к биллингу ====
 +Установить perl модули
 +  * AnyEvent
 +  * AnyEvent::​HTTP
 +  * Net::SSLeay
 +  ​
 В файл настроек **config.pl** прописать следующие параметры:​ В файл настроек **config.pl** прописать следующие параметры:​
 ^$conf{TELEGRAM_TOKEN} = '​267953392:​AAHVUmXdEOTzLbdzSuV23QuEBTmDMjzg-io';​ | Токен, который получили при создании бота | ^$conf{TELEGRAM_TOKEN} = '​267953392:​AAHVUmXdEOTzLbdzSuV23QuEBTmDMjzg-io';​ | Токен, который получили при создании бота |
Строка 57: Строка 67:
 **Файл логирования Телеграма находится в ''/​usr/​abills/​var/​log/​telegram.log''​** **Файл логирования Телеграма находится в ''/​usr/​abills/​var/​log/​telegram.log''​**
 ==== Разработчикам ==== ==== Разработчикам ====
 +
 +==== Схема работы Telegram бота ====
 +[[abills:​docs:​manual:​sender:​telegram:​bot|Схема работы бота Telegram]]
 +
 +
 ===Доступные методы=== ===Доступные методы===
 +
 +=== Консольный интерфейс ==
 +[[abills:​docs:​manual:​sender:​cli|Консольный интерфейс к Sender]]
 +
 **new** - создания нового обьекта Telegram. **new** - создания нового обьекта Telegram.
  
 Пример использования:​ Пример использования:​
  
-  my $Telegram = Abills::​Sender::​Telegram->​new( ​token => $instagram_token ​);+  my $Telegram = Abills::​Sender::​Telegram->​new(\%conf);
  
 ---- ----
Строка 71: Строка 90:
 ^ AID или UID | chat_id абонента | ^ AID или UID | chat_id абонента |
 ^ MESSAGE ​    | текст сообщения | ^ MESSAGE ​    | текст сообщения |
-PARS_MODE ​  | тип оформления сообщения. Может быть либо [[https://​core.telegram.org/​bots/​api#​html-style|markdown]], либо [[https://​core.telegram.org/​bots/​api#​html-style|html]]. |+SUBJECT ​    | заголовок сообщения | 
 +^ PARSE_MODE ​  | тип оформления сообщения. Может быть либо [[https://​core.telegram.org/​bots/​api#​html-style|MARKDOWN]], либо [[https://​core.telegram.org/​bots/​api#​html-style|HTML]]. |
  
 Пример использования:​ Пример использования:​
  
-  my $answer ​= $Telegram->​send_message({ UID        => $user_chatid, ​+  my $message_sent ​= $Telegram->​send_message({ UID        => $user_chatid, ​
                                          ​MESSAGE ​   => $message, ​                                          ​MESSAGE ​   => $message, ​
                                          ​PARSE_MODE => '​HTML'​});​                                          ​PARSE_MODE => '​HTML'​});​