Оглавление maxLevel 1 outline true
...
Отправка сообщения
- Метод:
...
- POST
- Authorization: No Auth
- URL: https://api.telegram.org/bot{token}/sendMessage?chat_id={chat_id}&
...
| Примечание | ||
|---|---|---|
| ||
Вместо {token} нужно указать токен БОТа в телеграме, полученный от https://t.me/BotFather |
| Предупреждение |
|---|
Предупреждение — Используйте параметр parse_mode только если он вам действительно необходим. В противном случае возможны ошибки при отправке сообщений. Если вы никак не форматируете содержимое сообщения (форматированием считается, например, наклонный или подчеркнутый текст) — не используйте parse_mode в запросе. |
| Блок кода | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
| Блок кода | ||||||||||
| ||||||||||
curl{ --location --globoff --request GET 'https://api.telegram.org/bot{token}/sendMessage?chat_id={chat_id}&text={text}&message_thread_id={topic_id}' \ --header 'Content-Type: application/json' \ --data '{ "reply_markup": { " "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" } } ] ] } }' |
| Блок кода | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"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 клавиатура):
...
Описание тела запроса (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 | ссылка на веб-апп |
...
| language | php |
|---|---|
| theme | DJango |
| title | CURL |
| collapse | true |
...
| Блок кода | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
{
"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 | объект "клавиатуры" |
| reply_markup.one_timeresize_keyboard | true - клавиатура исчезнет (свернется) после нажатия клавишиуменьшится по количеству строк для удобства false - [значение по умолчанию] клавиатура будет существовать, пока ее не удалят или не заменят новойполноразмерная клавиатура | ||
| reply_markup.keyboard | Реплай клавиатура (вместо системной клавиатуры / кнопки) | ||
| reply_markup.input_field_placeholder.keyboard.text | Текст кнопки | ||
| reply_markup.keyboard.web_app | объект веб-аппаТекст-подсказка в поле ввода | ||
| reply_markup.resize_keyboardkeyboard.web_app.url | ссылка на веб-апп true - клавиатура уменьшится по количеству строк для удобства false - [значение по умолчанию] полноразмерная клавиатура | ||
| reply_markup.keyboard.request_contact | запрос номера телефонаРеплай клавиатура (вместо системной клавиатуры / кнопки) | ||
| reply_markup.keyboard.text | Текст кнопки | ||
| reply_markup.keyboard.web_app | объект веб-аппа | ||
| reply_markup.keyboard.web_app.url | ссылка на веб-апп | ||
| request_location | запрос геолокации |
| Блок кода | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
{
"reply_markup": {
"remove_keyboard": true
}
} |
Описание тела запроса (Удаление reply клавиатуры):
| Поле | Описание | ||
|---|---|---|---|
| reply_markup | объект "клавиатуры" | reply_markup.keyboard.request_contact | запрос номера телефона |
| reply_markup.remove_keyboard.request_location | true – удалить reply клавиатуру в чате запрос геолокации |
| Блок кода | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"reply_markuptext": {
"remove_keyboard": true
}
}"Какой-то текст для отправки\nА это уже на следующей строке будет"
} |
Описание тела запроса (Удаление reply клавиатурыТекст сообщения):
| Поле | Описание |
|---|---|
| reply_markup | объект "клавиатуры" | reply_markup.remove_keyboard | true – удалить reply клавиатуру в чате
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 | да | Идентификатор сообщения |
| 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}