Различия
Здесь показаны различия между двумя версиями данной страницы.
Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия | ||
abills:docs:manual:sender:telegram [2017/08/10 22:14] 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); |
---- | ---- | ||
Строка 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]]. | |
Пример использования: | Пример использования: |