Это старая версия документа.
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/Testkkbot, а так же очень важный параметр - токен.
Токен: 167953392:AAHVUmXdEOTzLbdzSuV23QuEBTmDMjzg-io .
7) Бот создан!
Запуск и привязка бота к биллингу
В файл настроек config.pl прописать следующие параметры:
$conf{TELEGRAM_TOKEN} = '267953392:AAHVUmXdEOTzLbdzSuV23QuEBTmDMjzg-io'; | Токен, который получили при создании бота |
---|---|
$conf{TELEGRAM_SERVER_ADDRESS} = 'https://192.168.1.41:9443/'; | Прописать полный адрес вашего сервера. (protocol:/ip:port/) |
После этого, нужно перезапустить websocket_backend.pl
. (Если еще не установлен, Установка WebSocket Backend)
Файл логирования Телеграма находится в /usr/abills/var/log/telegram.log
Разработчикам
Доступные методы
new - создания нового обьекта Telegram.
Пример использования:
my $Telegram = Abills::Sender::Telegram->new( token => $instagram_token );
send_message - отправка сообщения абоненту по его chat_id из Instagram
Параметры:
AID или UID | chat_id абонента |
---|---|
MESSAGE | текст сообщения |
PARS_MODE | тип оформления сообщения. Может быть либо markdown, либо html. |
Пример использования:
my $answer = $Telegram->send_message({ UID => $user_chatid, MESSAGE => $message, PARSE_MODE => 'markdown'});
Возвращает:
1 - при удачном отправлении 0 - в случае ошибки