В новом уроке мы с вами рассмотрим отправку базовых запросов в Telegram. Я покажу вам как отправлять простые текстовые сообщения в Telegram, как отправлять кнопки и дополнительные клавиатуры.
Всю информацию по параметрам запросов мы будем брать из официальной документации Telegram
https://core.telegram.org/bots/api/
Все ответы от Telegram приходят в виде JSON строки. Для удобного отображения массива ответа в браузере, советую вам установить специальное расширение для браузера, которое называется JSON Viewer
Отправка простых сообщений
Для отправки простых текстовых сообщений, нам необходимо воспользоваться методом sendMessage.
Ранее я показывал вам, как отправлять запросы с передачей параметров в URL, теперь для удобства я буду использовать запись параметров в массиве и с помощью функции http_build_query мы будем формировать строку с GET параметрами.
$token = "5340791844:AAEXXDduvInvQrlykV91USOQSevrPVU";
$getQuery = [
"chat_id" => 1424625511,
"text" => "Новое сообщение из формы",
"parse_mode" => "html"
];
$ch = curl_init("https://api.telegram.org/bot". $token ."/sendMessage?" . http_build_query($getQuery));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_HEADER, false);
$resultQuery = curl_exec($ch);
curl_close($ch);
echo $resultQuery;
Каждый запрос будет иметь переменную с записанным токеном, массив с параметрами запроса, код для создания запроса через Curl и вывод или запись полученной информации.
Отправка ответа на сообщение
Для отправки ответа на ранее созданное сообщения, вам необходимо в новом запросе на метод sendMessage отправить дополнительный параметр reply_to_message_id, передав в него id сообщения, которое вы хотите прикрепить.
Полный запрос будет выглядеть так…
$token = "5340791844:AAEXXDduvInvQrlykV91USOQSevrPVU";
$getQuery = [
"chat_id" => 1424625511,
"text" => "Новое сообщение из формы",
"parse_mode" => "html",
"reply_to_message_id" => 7
];
$ch = curl_init("https://api.telegram.org/bot". $token ."/sendMessage?" . http_build_query($getQuery));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_HEADER, false);
$resultQuery = curl_exec($ch);
curl_close($ch);
echo $resultQuery;
Удаление сообщений из чата
Для удаления сообщений, вам нужно воспользоваться методом deleteMessage и знать id сообщения, которое вы хотите удалить.
Пример кода для удаления сообщений выглядит так:
$token = "5340791844:AAEXXDduvInvQrlykV91USOQSevrPVU";
$getQuery = [
"chat_id" => 1424625511,
"message_id" => 32456,
];
$ch = curl_init("https://api.telegram.org/bot". $token ."/deleteMessage?" . http_build_query($getQuery));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_HEADER, false);
$resultQuery = curl_exec($ch);
curl_close($ch);
echo $resultQuery;
Отправка кнопок в чат
Существует 3 вида кнопок в чате в Telegram.
- Кнопки которые прикреплены к сообщению (inline_keyboard)
- Кнопки которые располагаются под строкой ввода сообщения, они называются клавиатурой (keyboard)
- Кнопки меню команд, которые чаще всего располагаются слева от строки ввода сообщения
Для начала давайте рассмотрим как нам добавить кнопки которые будут прикреплены к сообщению.
Для отправки таких кнопок, нам нужно воспользоваться методом sendMessage и передать ему в качестве параметра reply_markup — массив со свойствами клавиатуры.
Данный массив выглядит следующим образом…
'reply_markup' => json_encode([
'inline_keyboard' => [
[
[
'text' => 'Button 1',
'callback_data' => 'test_2',
],
[
'text' => 'Button 2',
'callback_data' => 'test_2',
],
]
],
])
Разберём всё по порядку.
Первое важное правило, reply_markup принимает json, поэтому для создания кнопок, вам нужно конвертировать массив в JSON с помощью функции json_encode.
В массиве с параметрами кнопок, есть особые параметры. Эти параметры, так же, указаны в документации
- С помощью параметра text вы можете передать текст кнопки
- параметр url указывает ссылку, если вам нужно сделать кнопку для перехода на внешний ресурс
- параметр callback_data указывает строку которая будет возвращена после нажатия на кнопку. Данную строку используют как команду.
Массив для кнопок имеет сложную многоуровневую систему. Первый уровень отвечает за общую запись параметров, второй уровень отвечает за ряд кнопок, третий уровень отвечает за параметры кнопки.
Таким образом, для создания 2 кнопок в одном ряду, мы будем использовать следующий код
...
'reply_markup' => json_encode([
'inline_keyboard' => [
[
[
'text' => 'Button 1',
'callback_data' => 'test_2',
],
[
'text' => 'Button 2',
'callback_data' => 'test_2',
],
]
],
]),
...
Для создания 2 рядов по 2 кнопки используйте код
...
'reply_markup' => json_encode([
'inline_keyboard' => [
[
[
'text' => 'Button 1',
'callback_data' => 'test_2',
],
[
'text' => 'Button 2',
'callback_data' => 'test_2',
],
],
[
[
'text' => 'Button 3',
'callback_data' => 'test_3',
],
[
'text' => 'Button 4',
'callback_data' => 'test_4',
],
]
],
]),
...
И для создания одной кнопки в первом ряду и 2 — во втором, используйте следующий код.
...
'reply_markup' => json_encode([
'inline_keyboard' => [
[
[
'text' => 'Button 2',
'callback_data' => 'test_2',
],
],
[
[
'text' => 'Button 3',
'callback_data' => 'test_3',
],
[
'text' => 'Button 4',
'callback_data' => 'test_4',
],
]
],
]),
...
Надеюсь, я смог объяснить данную тему доступно, если у вас будут вопросы, пишите их в нашем Telegram канале.
Отправка клавиатуры в чат
Аналогичные параметры имеет и массив для отправки клавиатуры в чат. Для создания клавиатуры пропишем следующий код.
...
'reply_markup' => json_encode([
'keyboard' => [
[
[
'text' => 'Тестовая кнопка 1',
'url' => 'YOUR BUTTON URL',
],
[
'text' => 'Тестовая кнопка 2',
'url' => 'YOUR BUTTON URL',
],
]
],
'one_time_keyboard' => true,
'resize_keyboard' => true,
]),
...
Структура массивом для кнопок та же, но только есть отличие в названиях и количестве параметров.
Ключ inline_keyboard заменяется на keyboard.
А так же для клавиатуры добавляются 2 дополнительных параметра:
- one_time_keyboard — скрыть клавиатуру, как только она была использована. Клавиатура по-прежнему будет доступна, но клиенты будут автоматически отображать обычную, буквенную клавиатуру в чате — пользователь может нажать специальную кнопку в поле ввода, чтобы снова увидеть пользовательскую клавиатуру. Значение по умолчанию равно false.
- resize_keyboard — изменяет размер клавиатуры по вертикали для оптимальной подгонки (например, уменьшить клавиатуру, если есть только два ряда кнопок). По умолчанию установлено значение false, и в этом случае пользовательская клавиатура всегда имеет ту же высоту, что и стандартная клавиатура приложения.
Подведём итоги!
- В новом уроке мы с вами разобрали самый популярный метод для работы с Телеграм ботами — sendMessage. Данный метод позволяет отправлять текстовые сообщения с привязанными кнопками и клавиатурами.
- Научились удалять сообщения
- Разобрали какие бывают типы кнопок и научились создавать массивы для гибкой структуры вывода дополнительных клавиатур и кнопок.
В следующем уроке, я вам покажу как отправлять файлы и изображения в чат.
Дополнения к записи от 04.11.2022
Дополнение от доброго комментатора с сайта Habr, с ником FanatPHP — https://habr.com/ru/users/FanatPHP/
Пользователь предложил добавить вспомогательную функцию для работы с Curl.
function curl($url, $data = [], $method = 'GET', $options = [])
{
$default_options = [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HEADER => false,
CURLOPT_SSL_VERIFYPEER => false,
];
if ($method === 'GET') {
$url .= (strpos($url, '?') === false) ? '?' : '&';
$url .= http_build_query($data);
}
if ($method === 'POST') {
$options[CURLOPT_POSTFIELDS] = http_build_query($data);
}
if ($method === 'JSON') {
$options[CURLOPT_POSTFIELDS] = json_encode($data);
$options[CURLOPT_HTTPHEADER][] = 'Content-Type:application/json';
}
$ch = curl_init($url);
curl_setopt_array($ch, array_replace($default_options, $options));
$result = curl_exec($ch);
if ($result === false) {
throw new ErrorException("Curl error: ".curl_error($ch), curl_errno($ch));
}
curl_close($ch);
return $result;
}
$token = "5340791844:AAEXXDduvInvQrlykV91USOQSevrPVU";
$url = "https://api.telegram.org/bot$token/sendMessage";
$getQuery = [
"chat_id" => 1424625511,
"text" => "Новое сообщение из формы",
"parse_mode" => "html"
];
echo curl($url, $getQuery);