Инструкция по созданию Telegram ботов. Часть 6. Делаем пользовательскую клавиатуру для бота


// создаём $keyboard - объект, описывающий клавиатуру
$keyboard = [
"inline_keyboard" =>
[ /* первый ряд кнопок - массив из наборов {подпись кнопки, даные для колбэка} */
[ /* первые две кнопки вызывают колбэк, а третья - открытие url-а */
[ "text" => "button 1",
"callback_data" => "data 1"
],
[ "text" => "button 2",
"callback_data" => "data 2"
],
[ "text" => "button 3",
"url" => $any_url
]
]
/* здесь мог бы быть второй массив для второго ряда кнопок и так далее */
]
];
...
...
// далее нужно просто добавить этот параметр в запрос (GET или POST) в качестве параметра reply_markup
// например, при использовании в GET-запросе:
$keyboard_json = json_encode($keyboard); // перекодируем в json
// формируем url для get-запроса и добавляем к этому url-у параметр reply_markup с описанием нашей клавиатуры
$url=$telegram_api_url.$bot_token.'/sendMessage?chat_id='.$chat_id.'&text='.urlencode($text_message).'&parse_mode=HTML'.'&reply_markup='.$keyboard_json;
// осталось только выполнить GET-запрос, например с помощью file_get_contents (ну или curl :))
file_get_contents($url); // отправляем get-запрос на сформированный url


// создаём $keyboard - объект, описывающий клавиатуру
$keyboard = [
"keyboard" =>
[ /* первый ряд кнопок - массив из наборов {подпись кнопки} */
[ /* перва кнопка отправляет команду /any_command в виде текстового сообщения, вторая - данные геолокации */
[ "text" => "/any_command"
],
[ "text" => "my location",
"request_location" => true
]
]
/* здесь мог бы быть второй массив для второго ряда кнопок и так далее */
]
];
...
...
// далее нужно просто добавить этот параметр в запрос (GET или POST) в качестве параметра reply_markup
// например, при использовании в GET-запросе:
$keyboard_json = json_encode($keyboard); // перекодируем в json
// формируем url для get-запроса и добавляем к этому url-у параметр reply_markup с описанием нашей клавиатуры
$url=$telegram_api_url.$bot_token.'/sendMessage?chat_id='.$chat_id.'&text='.urlencode($text_message).'&parse_mode=HTML'.'&reply_markup='.$keyboard_json;
// осталось только выполнить GET-запрос, например с помощью file_get_contents (ну или curl :))
file_get_contents($url); // отправляем get-запрос на сформированный url


// создаём $remove_keyboard - объект, описывающий удаление reply-клавиатуры
$remove_keyboard = [
"remove_keyboard" => true
];
...
...
// далее нужно просто добавить этот объект в запрос (GET или POST) в качестве параметра reply_markup
// например, при использовании в GET-запросе:
$remove_keyboard_json = json_encode($remove_keyboard); // перекодируем в json
// формируем url для get-запроса и добавляем к этому url-у параметр reply_markup с описывающим удаление клавиатуры объектом
$url=$telegram_api_url.$bot_token.'/sendMessage?chat_id='.$chat_id.'&text='.urlencode($text_message).'&parse_mode=HTML'.'&reply_markup='.$remove_keyboard_json;
// осталось только выполнить GET-запрос, например с помощью file_get_contents (ну или curl :))
file_get_contents($url); // отправляем get-запрос на сформированный url

"{"ok":true,"result":
[
{
"update_id":xxxxxxxxxx,
"callback_query":
{
"id":"xxxxxxxxxxx",
"from":
{
"id":xxxxxxxxx,
"first_name":"xxxxxxx",
"last_name":"xxxxxxx",
"username":"xxxxxxxxx",
"language_code":"ru"
},
"message":
{
"message_id":xxxx,
"from":
{
"id":xxxxxxxxx,
"first_name":"xxxxxxxx",
"username":"xxxxxxx"
},
"chat":
{
"id":xxxxxxxx,
"first_name":"xxxxxxx",
"last_name":"xxxxxxxx",
"username":"xxxxxxx",
"type":"private"
},
"date":1499854111,
"text":"test"
},
"chat_instance":"xxxxxxxxxxxx",
"data":"1"
}
}
]
}"


// если мы определили, что нам прилетел именно колбэк (по наличию поля "callback_query"), то:
// выделяем из этого колбэка необходимые для редактирования сообщения данные
$chat_id = $input_array['callback_query']['message']['chat']['id']; // идентификатор чата
$message_id = $input_array['callback_query']['message']['message_id']; //идентификатор сообщения
$data = $input_array['callback_query']['data']; // данные, которые были отправлены при нажатии на кнопку
...
...
// далее нужно просто выполнить запрос (GET или POST), обратившись, например, к методу editMessageText
$url=$telegram_api_url.$bot_token.'/editMessageText?chat_id='.$chat_id.'&message_id='.$message_id.'&text='.urlencode($edited_message).'&reply_markup='.$keyboard_json;
// $edited_message - отредактированный текст сообщения
// $keyboard_json - клавиатура, которая будет содержаться в отредактированном сообщении
file_get_contents($url); // отправляем get-запрос на сформированный url