Бот для telegram на php. Отложенный постинг, кнопки, инлайн-запросы.

В общем-то, эта статья является дополнением этой — Пишем бота для Telegram на php, так-что если вы попали сюда впервые — советую, для начала, прочитать ее.

Здесь я отвечу читателям на ряд вопросов, которые мне были заданы тут, на блоге.(см комментарии в указанном выше посте) В общем и целом, все варианты тут будут приведены для языка php, однако ничто не мешает вам использовать их, например, на C#.

Как, используя бота, публиковать новости в свой канал

Поясню для читателя, что такое канал. Канал, это что-то вроде паблика вк, на нем нельзя общаться, но можно читать, что пишет автор этого самого канала. Как пример — Красные Котлеты — это мой личный канал, подписывайтесь, к стати. Ну, если мои взгляды (анархо-коммунист) разделяете, разумеется.

Для решения этой, с виду не такой уж простой, задачи надо добавить нашего бота в канал, как администратора. Чтобы сделать это, я, на своей текущей версии телеграма, перехожу в админку канала и добавляю туда своего бота из вышеуказанной статьи. Переходим в управление группой -> administrators

Тыкаем туда, после чего указываем ник нашего бота и добавляем.

 

Отлично!

Код

Тут, на самом деле, ничего сложно нет, однако у многих на этом этапе возникает сложность. Сейчас поясню. По идее нам надо отправлять в канал сообщения через метод $bot->sendMessage(), однако, первый аргумент этого метода требует наличия некоего ID чата. В случае с конфами, диалогами и прочей фигней эти самые ID — цифровые, как у групп в VK, а вот в случае с каналами такие ID соответствуют названию самих каналов. Поэтому, чтобы отослать в канал «Красные котлеты» сообщение «Тест», нужен такой код:

$bot->sendMessage("@burgercaputt", "Тест");

Куда прописывать? Да прямо между $bot = new \TelegramBot\Api\Client($token,null); и $bot->run(); впишите. В смысле примерно так, как на картинке.

Вроде все сделано, теперь надо заставить бота отослать сообщение в канал. Как это сделать? Да легко, переходим на страничку с вашим ботом и руками нажимаем там F5(обновить).

Ну и, собственно, вот результат работы —

Теперь ничего не стоит добавить вызов страницы бота в, например, CURL и получить отложенный постинг для канала.

Так-же был вопрос — как сделать, чтобы бот публиковал информацию в канал по команде, или публиковал в несколько каналов.

— Запросто — используйте банальные GET параметры, вот как примерно в этом наброске кода:

if($_GET["bname"] == "revcombot"){
	$bot->sendMessage("@burgercaputt", "Тест");
}
if($_GET["bname"] == "someoother"){
	$bot->sendMessage("@someoother", "Тест");
}

Теперь достаточно обратиться к файлу index.php с get параметрами вида index.php?bname=revcombot, чтобы получить результат.

Как вывести кнопки после сообщения и обработать их

Для начала о каких кнопках идет речь. Вот на картинке вы видите их:

Как вывести такие кнопки используя telegram-bot/api? Вообще, это весьма обширная тема, я чуть ли не два часа потратил на эти гребаные кнопки и попытки их осилить. Выводятся они следующим кодом:

// Кнопки у сообщений
$bot->command("ibutton", function ($message) use ($bot) {
	$keyboard = new \TelegramBot\Api\Types\Inline\InlineKeyboardMarkup(
		[
			[
				['callback_data' => 'data_test', 'text' => 'Answer'],
				['callback_data' => 'data_test2', 'text' => 'ОтветЪ']
			]
		]
	);

	$bot->sendMessage($message->getChat()->getId(), "тест", false, null,null,$keyboard);
});

То есть по команде /ibutton вылезут к нам две кнопки Answer и ОтветЪ. С выводом разобрались, теперь нам надо их обработать. Делается все так:

// Обработка кнопок у сообщений
$bot->on(function($update) use ($bot, $callback_loc, $find_command){
	$callback = $update->getCallbackQuery();
	$message = $callback->getMessage();
	$chatId = $message->getChat()->getId();
	$data = $callback->getData();
	
	if($data == "data_test"){
		$bot->answerCallbackQuery( $callback->getId(), "This is Ansver!",true);
	}
	if($data == "data_test2"){
		$bot->sendMessage($chatId, "Это ответ!");
		$bot->answerCallbackQuery($callback->getId()); // можно отослать пустое, чтобы просто убрать "часики" на кнопке
	}

}, function($update){
	$callback = $update->getCallbackQuery();
	if (is_null($callback) || !strlen($callback->getData()))
		return false;
	return true;
});

Вот и все. Собственно, вот результат работы этой функции:

Ну и результат нажатия на вторую кнопку, для большей… полноты материала.

 

Обработка reply-кнопок

Если вы работали с botfather’ом то видели там такую панельку из кнопок под текстовым полем, выглядят они примерно так:

У людей возникает вопрос: как вывести эти кнопки? На самом деле это весьма просто сделать.

Вот код —

// Reply-Кнопки
$bot->command("buttons", function ($message) use ($bot) {
	$keyboard = new \TelegramBot\Api\Types\ReplyKeyboardMarkup([[["text" => "Власть советам!"], ["text" => "Сиськи!"]]], true, true);

	$bot->sendMessage($message->getChat()->getId(), "тест", false, null,null, $keyboard);
});

Тут задается команда /buttons после которой и появляются эти reply-кнопки. Как обработать? На самом деле никакой особой обработки не требуется, в смысле кнопки надо обрабатывать как обычные текстовые сообщения. В данном случае, я сделал это через метод on() —

// Отлов любых сообщений + обработка reply-кнопок
$bot->on(function($Update) use ($bot){
	
	$message = $Update->getMessage();
	$mtext = $message->getText();
	$cid = $message->getChat()->getId();
	
	if(mb_stripos($mtext,"Сиськи") !== false){
		$pic = "http://aftamat4ik.ru/wp-content/uploads/2017/05/14277366494961.jpg";

		$bot->sendPhoto($message->getChat()->getId(), $pic);
	}
	if(mb_stripos($mtext,"власть советам") !== false){
		$bot->sendMessage($message->getChat()->getId(), "Смерть богатым!");
	}
}, function($message) use ($name){
	return true; // когда тут true - команда проходит
});

Ну и, собственно, если на любую из этих кнопок ткнуть, получим результат.

Обработка inline-запросов

Что такое inline запрос у telegram? Это… Хм, на словах будет сложно объяснить, лучше покажу. Есть у нас бот, очень популярный у пользователей — @vkmusic_bot, он выполняет поиск музыки по вконтакте. И его можно вызывать в любом месте телеграма. Просто прописываем название бота и следом — название трека, который надо найти. Это и есть inline запрос.

Как сделать в своем боте такую-же фичу?

На самом деле эта задачка заставила меня попотеть изрядно. Я перелопатил половину буржунета и весь код долбаной библиотеки telebram-bot/api . Однако, решение все-таки нашел, к счастью.

Подготовка бота

Не только лишь все боты могут обрабатывать inline запросы, а только те, в которых автор включил эту фичу. Идем на botfather’а  и выполняем там команду /setinline, после чего выбираем бота. Вылезет что-то типа того:

Думаете все, режим включился? А вот фиг там было! Нам надо передать в botfather’а форму инлайн команды, примерно так: @revcom_bot тестовый inline ответ

Вот ТЕПЕРЬ можно начинать написание кода.

Код

Собственно в библиотеке бота есть метод $bot->inlineQuery(), именно он отвечает за обработку контекстных запросов. Но как заставить его работать? Оказывается у каждого поля, отправляемого в результат запроса свой формат + для некоторых полей надо данные готовить заранее. Однако я все прокомментировал, так что разобраться с этим функционалом вы сможете в два счета. А вот мне пришлось чуть ли не в слепую угадывать что и куда ставить из-за отсутствия вменяемой документации к библиотеке.

// обработка инлайнов
$bot->inlineQuery(function ($inlineQuery) use ($bot) {
	mb_internal_encoding("UTF-8");
	$qid = $inlineQuery->getId();
	$text = $inlineQuery->getQuery();
	
	// Это - базовое содержимое сообщения, оно выводится, когда тыкаем на выбранный нами инлайн
	$str = "Что другие?
Свора голодных нищих.
Им все равно...
В этом мире немытом
Душу человеческую
Ухорашивают рублем,
И если преступно здесь быть бандитом,
То не более преступно,
Чем быть королем...
Я слышал, как этот прохвост
Говорил тебе о Гамлете.
Что он в нем смыслит?
Гамлет восстал против лжи,
В которой варился королевский двор.
Но если б теперь он жил,
То был бы бандит и вор.";
	$base = new \TelegramBot\Api\Types\Inline\InputMessageContent\Text($str,"Html");
	
	// Это список инлайнов
	// инлайн для стихотворения
	$msg = new \TelegramBot\Api\Types\Inline\QueryResult\Article("1","С. Есенин","Отрывок из поэмы `Страна негодяев`");
	$msg->setInputMessageContent($base); // указываем, что в ответ к этому сообщению надо показать стихотворение
	
	// инлайн для картинки
	$full = "http://aftamat4ik.ru/wp-content/uploads/2017/05/14277366494961.jpg"; // собственно урл на картинку 
	$thumb = "http://aftamat4ik.ru/wp-content/uploads/2017/05/14277366494961-150x150.jpg"; // и миниятюра
	
	$photo = new \TelegramBot\Api\Types\Inline\QueryResult\Photo("2",$full,$thumb);
	
	// инлайн для музыки
	$url = "http://aftamat4ik.ru/wp-content/uploads/2017/05/mongol-shuudan_-_kozyr-nash-mandat.mp3";
	$mp3 = new \TelegramBot\Api\Types\Inline\QueryResult\Audio("3",$url,"Монгол Шуудан - Козырь наш Мандат!");
	
	// инлайн для видео
	$vurl = "http://aftamat4ik.ru/wp-content/uploads/2017/05/bb.mp4";
	$thumb = "http://aftamat4ik.ru/wp-content/uploads/2017/05/joker_5-150x150.jpg";
	$video = new \TelegramBot\Api\Types\Inline\QueryResult\Video("4",$vurl,$thumb, "video/mp4","коммунальные службы","тут тоже может быть описание");
	
	// отправка
	try{
		$result = $bot->answerInlineQuery( $qid, [$msg,$photo,$mp3,$video],100,false);
	}catch(Exception $e){
		file_put_contents("rdata",print_r($e,true));
	}
});

Как это сработает в боте? Смотрим.

Проверить все три оставшихся варианта вы сможете прямо в telegram’е на странице моего бота, ну а тут я выведу вам результат теста только первого элемента с отрывком поэмы Сергея Есенина.

Надеюсь, я смог решить вашу проблему.

Исходники

Разумеется, важно выложить исходники бота. Если не хотите все перечитывать, просто скачайте их и тестируйте.

Желающие могут поиграться с демонстрационным ботом тут — revcom_bot

Ах да, вы таки не поверите, но я принимаю ДОНАТ! Если статья помогла вам — помогите и мне, хехе.

wm — R343924802694