-
Создана пользователем
Владимир Диев. Последнее обновление: 04 мая, 2023
Время чтения: 3 мин.
ОТПРАВКА СООБЩЕНИЯ
Метод: GET/POST
Authorization: No Auth
ВАЖНО
Вместо {token} нужно указать токен БОТа в телеграме, полученный от https://t.me/BotFather
{
"reply_markup": {
"inline_keyboard": [
[
{
"text": "Ссылка на сайт",
"url": "https://twin24.ai"
},
{
"text": "WebApp",
"web_app": {
"url": "https://twin24.ai"
}
}
],
[
{
"text": "Ссылка на сайт2",
"url": "https://twin24.ai"
},
{
"text": "WebApp2",
"web_app": {
"url": "https://twin24.ai"
}
}
]
]
}
}
Описание тела запроса (inline клавиатура):
| Поле | Описание |
|---|---|
| reply_markup | объект "клавиатуры" |
| reply_markup.inline_keyboard | Инлайн клавиатура (под сообщением) |
| reply_markup.inline_keyboard.text | Текст кнопки |
| reply_markup.inline_keyboard.url | ссылка для перехода при нажатии кнопки |
| reply_markup.inline_keyboard.web_app | объект веб-аппа |
| reply_markup.inline_keyboard.web_app.url | ссылка на веб-апп |
{
"reply_markup": {
"one_time_keyboard": true,
"input_field_placeholder": "выберите пункт",
"resize_keyboard": true,
"keyboard": [
[
{
"text": "Просто кнопка-ответ"
},
{
"text": "WebApp",
"web_app": {
"url": "https://twin24.ai"
}
}
],
[
{
"text": "Запрос контакта",
"request_contact": true
},
{
"text": "Запрос локации",
"request_location": true
}
]
]
}
}
Описание тела запроса (reply клавиатура):
| Поле | Описание |
|---|---|
| reply_markup | объект "клавиатуры" |
| reply_markup.one_time_keyboard | true - клавиатура исчезнет (свернется) после нажатия клавиши false - [значение по умолчанию] клавиатура будет существовать, пока ее не удалят или не заменят новой |
| reply_markup.input_field_placeholder | Текст-подсказка в поле ввода |
| reply_markup.resize_keyboard | true - клавиатура уменьшится по количеству строк для удобства false - [значение по умолчанию] полноразмерная клавиатура |
| reply_markup.keyboard | Реплай клавиатура (вместо системной клавиатуры / кнопки) |
| reply_markup.keyboard.text | Текст кнопки |
| reply_markup.keyboard.web_app | объект веб-аппа |
| reply_markup.keyboard.web_app.url | ссылка на веб-апп |
| reply_markup.keyboard.request_contact | запрос номера телефона |
| reply_markup.keyboard.request_location | запрос геолокации |
{
"reply_markup": {
"remove_keyboard": true
}
}
Описание тела запроса (Удаление reply клавиатуры):
| Поле | Описание |
|---|---|
| reply_markup | объект "клавиатуры" |
| reply_markup.remove_keyboard | true – удалить reply клавиатуру в чате |
Описание параметров метода:
| Параметр | Обязательность | Описание |
|---|---|---|
chat_id | да | Идентификатор чата, в который будет отправлено сообщение. *Узнать идентификатор чата можно, например, через https://t.me/myidbot |
| parse_mode | нет | Режим парсинга текста. Может быть Markdown или HTML. Подробнее можно прочитать здесь *Используется для форматирования текста (жирный, с наклоном и тд.) |
| text | да | Текст, который отправит бот. *Для разрыва строки необходимо использовать специальную последовательность символов: %0A Например, следующий текст: Тест1 Тест2 Тест3 Можно передать следующим образом: Тест1%0AТест2%0AТест3 |
message_thread_id | нет | Идентификатор "темы" для отправки сообщения в тему группы, в которой включены "темы" |
{
"ok": true,
"result": {
"message_id": 1902,
"from": {
"id": 5351196660,
"is_bot": true,
"first_name": "Тестовый бот",
"username": "test_bot"
},
"chat": {
"id": -1001586696720,
"title": "Тестовая группа",
"type": "supergroup"
},
"date": 1663837925,
"text": "Тест\nТест"
}
}
ВАЖНО
В случае успешного ответа код ответа будет 200. Неуспешные ответы возвращают другой код ответа. Подробнее можете изучить на официальном сайте api telegram
Описание полей ответа:
| Поле | Обязательность | Описание |
|---|---|---|
| ok | да | Результат запроса. При успешном запросе всегда возвращает "true" |
| result | да | Массив результата ответа |
| message_id | да | Идентификатор сообщения |
| from | да | Массив информации отправителя |
| id | да | Идентификатор отправителя |
| is_bot | да | Признак того, бот ли отправитель |
| first_name | да | Имя отправителя |
| username | да | Уникальный username отправителя |
| chat | да | Массив информации чата, куда отправлено сообщение |
| id | да | Идентификатор чата |
| title | да | Название чата |
| type | да | Тип чата |
| date | да | Дата отправки сообщения |
| text | да | Текст сообщения |
РЕДАКТИРОВАНИЕ СООБЩЕНИЯ
ВАЖНО
Метод редактирования сообщения аналогичный методу отправки сообщения с несколькими особенностям:
- Новый обязательный параметр message_id, который принимает идентификатор сообщения для редактирования
- В ответе появляется поле edit_date, в которое записывается дата изменения сообщения
- НЕВОЗМОЖНО ОТРЕДАКТИРОВАТЬ СООБЩЕНИЕ С REPLY КЛАВИАТУРОЙ (с инлайн все также можно)
- Если передать тот же текст при редактировании, что и в оригинале, то вернется ошибка 400 (для редактирования только инлайн клавиатуры без редактирования текста нужно использовать метод editMessageReplyMarkup без параметра text)
Метод: GET/POST
Authorization: No Auth