Telegram модуль: различия между версиями
Mixman (обсуждение | вклад) м (→Описание) |
|||
(не показана 1 промежуточная версия этого же участника) | |||
Строка 108: | Строка 108: | ||
==Пример использования модуля для отправки сообщений в своих скрип…== | ==Пример использования модуля для отправки сообщений в своих скрип…== | ||
{{#spoiler:show=show_message|hide=hide_message|}} | |||
include(DIR_MODULES . 'telegram/telegram.class.php'); | include(DIR_MODULES . 'telegram/telegram.class.php'); | ||
Текущая версия от 12:12, 10 февраля 2020
Автор: Eraser от Чт фев 11, 2016
Описание
Модуль для интеграции с Telegram Позволяет получать в телеграм сообщения истории, а так же различные уведомления как текстом, так и изображениями, видео и тд
Установка модуля
Установка осуществляется через Маркет дополнений в разделе Взаимодействие - Telegram bot.
На данный момент умеет
- регистрировать пользователей
- отправлять сообщения системы (определенного уровня важности)
- принимать команды
- создает в приложении Telegram клавиатуру с шаблонами команд
- прием файлов
- проигрывание голосовых сообщений
- обработчики событий
- сортировка команд
- webhook
- экспорт/импорт команд и событий
- отправка несколько фотографий (альбом)
Внимание! На территории стран, где мессенджер Telegram заблокирован, модуль работает только через зарубежный прокси-сервер или VPN.
HOWTO
- Если бот не запускается и не реагирует на /start
- Отправка изображения с камеры или график pChart
- Отправляем видео с RTSP потока в виде gif
- Формирование своей клавиатуры
- Видео по первоначальной настройке бота
- Постинг новостей из модуля RSS в канал телеграмм
- Отправка в командах сообщения только пользователю который дал команду
- Получение изображения с rtsp потока с камеры в linux
- Получение изображения с rtsp потока с камеры в Windows
- Создание меню с отображением статуса
- Eще одно довольно интересное решение интерактивной клавиатуры
- Пример использования всплывающего сообщения
- Вставка в сообщение от бота смайлов
- Скрины с онлайн трансляций youtube и других ресурсов онлайн трансляций.
- Локальный Tor-прокси для модуля
Регистрация бота
Для работы модуля необходимо зарегистрировать бота и получить его уникальный id, являющийся одновременно и токеном. Для этого в Telegram существует специальный бот — @BotFather.
Пишем ему /start и получаем список всех его команд.
Первая и главная — /newbot — отправляем ему и бот просит придумать имя нашему новому боту как оно будет отображаться, можно русские буквы, имя не уникальное. После ввода имени предложит ввести уникальный логин боту латиницей и единственное ограничение на имя — в конце оно должно оканчиваться на «bot». В случае успеха BotFather возвращает токен бота и ссылку для быстрого добавления бота в контакты, иначе придется поломать голову над именем.
Далее заходим к боту и вводим /start в ответ Вы должны увидеть что бот зарегистрирован, получается не сразу
В настройки модуля вносится токен бота вида "123456780:AAHeВ7UcDWvEovvcFaMfUrUVPupNORHWD_k"
История изменений
06.06.2016 Сортировка команд
03.03.2016 Расширенная настройка доступа к командам
01.03.2016 Локализация, помощь
24.02.2016 Отправка сообщений, изображений из пользовательских скриптов
23.02.2016 Отправка сообщений системы определенного уровня важности
16.02.2016 Сохранение файла из сообщения
15.02.2016 Шаблоны команд
13.02.2016 Обработка команд
11.02.2016 Первая альфа версия
Пример использования модуля для отправки сообщений в своих скрип…
include(DIR_MODULES . 'telegram/telegram.class.php');
$telegram_module = new telegram();
$telegram_module->sendMessageToUser(139809588 ,"test message");
$telegram_module->sendMessageToAdmin("test message to admin");
$telegram_module->sendMessageToAll("test message to all");
$telegram_module->sendImageToUser(139809588 ,'/var/www/images/trees.jpg');
$telegram_module->sendImageToAdmin('/var/www/images/htc_hero_wallpaper_01.jpg');
$telegram_module->sendImageToAll('/var/www/images/htc_hero_wallpaper_01.jpg');
$telegram_module->sendVideoToUser(139809588, '/var/www/files/file.mp4', 'Description');
$telegram_module->sendVideoToAdmin('/var/www/files/file.mp4');
$telegram_module->sendVideoToAll('/var/www/files/file.mp4');