Оглавление maxLevel 1 outline true
Отправка сообщения
- Метод:
...
- POST
- Authorization: No Auth
- URL: https://api.telegram.org/bot{token}/sendMessage?chat_id={chat_id}&parse_mode=
...
...
| Примечание | ||
|---|---|---|
| ||
Вместо {token} нужно указать токен БОТа в телеграме, полученный от https://t.me/BotFather |
| Предупреждение |
|---|
Предупреждение — Используйте параметр parse_mode только если он вам действительно необходим. В противном случае возможны ошибки при отправке сообщений. Если вы никак не форматируете содержимое сообщения (форматированием считается, например, наклонный или подчеркнутый текст) — не используйте parse_mode в запросе. |
| Блок кода | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
{
"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 клавиатуру в чате |
| Блок кода | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"text": "Какой-то текст для отправки\nА это уже на следующей строке будет"
} |
Описание тела запроса (Текст сообщения):
| Поле | Описание |
|---|---|
text | Текст для отправки. Для переноса строка используется символ переноса строки "\n" |
Описание параметров метода:
| Параметр | Обязательность | Описание | ||
|---|---|---|---|---|
chat_id | да | Идентификатор чата, в который будет отправлено сообщение.
| ||
| parse_mode | нет | Режим парсинга текста. Может быть Markdown MarkdownV2 или 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Тест"
}
} |
...
| Поле | Обязательность | Описание |
|---|---|---|
| ok | да | Результат запроса. При успешном запросе всегда возвращает "true" |
| result | да | Массив результата ответа |
| message_id | да | Идентификатор сообщения |
| from | да | Массив информации отправителя |
| id | да | Идентификатор отправителя |
| is_bot | да | Признак того, бот ли отправитель |
| first_name | да | Имя отправителя |
| username | да | Уникальный username отправителя |
| chat | да | Массив информации чата, куда отправлено сообщение |
| id | да | Идентификатор чата |
| title | да | Название чата |
| type | да | Тип чата |
| date | да | Дата отправки сообщения |
| text | да | Текст сообщения |
Редактирование сообщения
| Примечание | ||
|---|---|---|
| ||
Метод редактирования сообщения аналогичный методу отправки сообщения с несколькими особенностям:
|
- Метод: GET/POST
- Authorization: No Auth
- URL: https://api.telegram.org/bot{token}/editMessageText?chat_id={chat_id}&parse_mode=MarkdownV2&text={text}&message_thread_id={topic_id}&message_id={message_id}