| Оглавление |
|---|
Подключение API
Для соединения с API используется модуль AnyEvent (это позволяет создавать одно подключение для передачи нескольких сообщений) Поэтому, нужно установить модуль AnyEvent.
Разработчикам
Схема работы Telegram бота
Доступные методы
Консольный интерфейс
new - создания нового объекта Telegram.
Пример использования:
| Блок кода | ||
|---|---|---|
| ||
my $Telegram = Abills::Sender::Telegram->new(\%conf); |
send_message - отправка сообщения абоненту по его chat_id из Instagram
Параметры:
| AID или UID | Chat_id абонента |
|---|---|
| MESSAGE | Текст сообщения |
| SUBJECT | Заголовок сообщения |
| PARSE_MODE | Тип оформления сообщения. Может быть либо MARKDOWN, либо HTML |
Пример использования:
| Блок кода | ||
|---|---|---|
| ||
my $message_sent = $Telegram->send_message({ UID => $user_chatid,
MESSAGE => $message,
PARSE_MODE => 'HTML'}); |
Возвращает:
| Блок кода | ||
|---|---|---|
| ||
1 - при удачном отправлении
0 - в случае ошибки |
Telegram Bot
Бот Telegram позволяет проводить массовые рассылки и сократить время на поддержку абонентов. На данном этапе, используется один бот для администраторов и клиентов (для каждого создаётся свой уникальный чат).
Возможности
Рассылка для подписанных клиентов
Возможность вести переписку из Helpdesk в чате Telegram (одновременно по всем заявкам)
Возможность просматривать информацию и управлять некоторыми функциями непосредственно из Telegram.
Для правильной работы, нужно использовать новую модель контактов ($conf{CONTACTS_NEW} = 1).
Клиенты могут подписаться через кнопку на первой странице кабинета.
Администраторы - в любом меню Профиль (как в основном меню так и в секции меню справа).
Кнопка формирует ссылку с секретом, который передастся приложением Telegram.
Создание бота
Эту операцию нужно делать с устройства где установлен Telegram.
1) Заходим https://telegram.me/botfather . Если есть аккаунт нажимаем кнопку “Send message”. Если нету, то регистрируемся в Telegram-е, затем снова заходим и нажимаем “Send message”. Или можно сразу зайти в Telegram, в поиске вбить Botfather и перейти к диалогу с ним.
2) На главном экране бота нажимаем “Start”.
3) Покажется список возможных команд для обращения к BotFather. Нам нужно ввести команду
/newbot.
4) BotFather спросит имя нашего бота. Это имя будет отображаться в деталях контакта. Вводим имя бота, например, Testbot.
5) Следующий шаг нас спрашивают Имя пользователя бота. Это параметр будет использоваться для запросов к боту. От 5 до 32 символов, регистро-чувствительная латиница, цифры и нижние подчеркивания. Имя пользователя бота должно заканчиваться на bot. Вводим наше имя пользователя, например TestAbills_bot.
6) Мы зарегистрировали нашего бота. Мы получили линк на нешего бота https://telegram.me/TestAbills_bot, а так же очень важный параметр - токен.