larakit/lk-telegrambot

[Larakit] telegrambot отправка уведомлений

Серверная часть бота

1. Отправьте сообщение @BotFather: "/newbot"
2. Вас попросят ввести имя будущего бота, оно должно заканчиваться на слово bot. Причем вы можете указывать его имя как "NickNameBot", так и "nickname_bot"
3. Если имя бота не занято, то получите сообщение с поздравлением о создании бота и в нем же будет токен вашего нового бота
4. Отправьте сообщение @BotFather: "/setinline"
5. Сейчас создайте домен для бота, как это требует TelegramAPI и выложите файл webhook.phpв корень этого домена. Не забудьте использовать протокол https.
6. Проверьте доступность бота, пройдя по урл например, https://bot.site.ru/webhook.php Вы будете должны увидеть "OK"
7. Исправьте константы настроек webhook.php, расположенные в начале файла

//hook-урл вашего бота
define('TELEGRAM_BOT_SERVER_URL', 'https://bot.site.ru/webhook.php');
//токен бота
define('TELEGRAM_BOT_SERVER_TOKEN', '221242699:AA******************');
//получатели через запятую, которым будет отправлена информация о добавлении в группу
define('TELEGRAM_BOT_SERVER_RECIPIENTS', '');
//включение режима отладки, когда все сообщения боту пишутся в лог
define('TELEGRAM_BOT_SERVER_DEBUG', true);

1. Зарегистрируем вебхук, для этого перейдем в консоли в директорию где лежит файл "webhook.php" и выполним:

$ php webhook.php

После этого в TelegramAPI будет зарегистрирован адрес, записанный TELEGRAM_BOT_SERVER_URL и все уведомления будут присылаться именно туда 9. Добавьте бота в группу телеграм, в которую хотите присылать уведомления 10. Посмотрите файл 'https://bot.site.ru/data.txt', там вы обнаружите сообщение, отправленное боту. В нем вы увидите свое имя и идентификатор. Впишите его в получатели, _(*1)

define('TELEGRAM_BOT_SERVER_RECIPIENTS', '123456789');

И теперь каждый раз, добавляя своего бота в новую группу только вы будете видеть сообщение в личку что бот был добавлен в такую то группу и пример кода для отправки сообщений ботом в эту группу, _(*2)

Каналы

Варианта уведомлений два: 1) если у вас уведомлений будет немного, то можно создать в телеграме всего одну группу и сыпать туда уведомлений с хэш-тегами 2) если уведомлений много, то лучше развести по каналам, чтобы показывать их только участнкиам группы, _(*3)

Пример, есть следующие типы уведомлений - ошибки (их должны видеть только программисты) - уведомления (программисты и менеджер проекта) - бронирование боулинга (Курган/Москва) - бронирование праздников (Курган/Москва) - бронирование билета в кино (Курган/Москва), _(*4)

Мы может создать группы как по типу боулинг/кино/праздник, а можем и сделать единую группу в телеграме для города Москва/Курган., _(*5)

Настройки модуля

В файле .env сделайте следующий настройки:, _(*6)

#для отправки ошибок
telegram.error=-XXXXXXXXXXXXXXXXXX
#для отправки уведомлений
telegram.notify=-XXXXXXXXXXXXXXXXXX
#по вкусу можете добавить еще каналов
telegram.bowling=-XXXXXXXXXXXXXXXXXX
telegram.holiday=-XXXXXXXXXXXXXXXXXX
telegram.cinema=-XXXXXXXXXXXXXXXXXX
telegram.moscow=-XXXXXXXXXXXXXXXXXX
telegram.kurgan=-XXXXXXXXXXXXXXXXXX

Отправка уведомлений

\Larakit\TelegramBot::add('Заказ боулинга в Кургане'); \Larakit\TelegramBot::send('bowling');, _(*7)

Далее система будет искать в .env запись "telegram.bowling", если найдет - отправит туда. Если не найдет будет искать общий канал "telegram", если найдет отправит туда. Если не найдет, то никому ничего не отправит., _(*8)

Отправка уведомлений в несколько каналов

\Larakit\TelegramBot::add('Заказ боулинга в Кургане'); \Larakit\TelegramBot::send(['bowling', 'kurgan', 'notify']);, _(*9)