Различия

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

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

Предыдущая версия справа и слева Предыдущая версия
Следующая версия
Предыдущая версия
Последняя версия Следующая версия справа и слева
abills:docs:manual:sender:telegram [2017/08/10 22:14]
anton [Разработчикам]
abills:docs:manual:sender:telegram [2017/11/21 10:30]
anton
Строка 7: Строка 7:
 На данном этапе, используется один бот для администраторов и клиентов (для каждого создаётся свой уникальный чат). На данном этапе, используется один бот для администраторов и клиентов (для каждого создаётся свой уникальный чат).
  
-Для правильной работы,​ нужно использовать новую модель контактов (''​$conf{CONTACTS_NEW} = 1''​).\\+Возможности 
 +  * Рассылка для подписаных клиентов 
 +  * Возможность вести переписку из Helpdesk в чате Telegram (одновременно по всем заявкам) 
 +  * [[abills:​docs:​manual:​sender:​telegram::​telegram_ui|Возможность просматривать информацию и управлять некоторыми функциями непосредственно из 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);
  
 ---- ----
Строка 72: Строка 91:
 ^ MESSAGE ​    | текст сообщения | ^ MESSAGE ​    | текст сообщения |
 ^ SUBJECT ​    | заголовок сообщения | ^ SUBJECT ​    | заголовок сообщения |
-^ PARSE_MODE ​  | тип оформления сообщения. Может быть либо [[https://​core.telegram.org/​bots/​api#​html-style|MARKDOWN]],​ либо [[https://​core.telegram.org/​bots/​api#​html-style|HTMLl]]. |+^ PARSE_MODE ​  | тип оформления сообщения. Может быть либо [[https://​core.telegram.org/​bots/​api#​html-style|MARKDOWN]],​ либо [[https://​core.telegram.org/​bots/​api#​html-style|HTML]]. |
  
 Пример использования:​ Пример использования:​