Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

Оглавление
maxLevel1
outlinetrue

Отправка сообщения

  • Метод:

...

...

Примечание
titleВАЖНО

Вместо {token} нужно указать токен БОТа в телеграме, полученный от https://t.me/BotFather

Предупреждение

Предупреждение — Используйте параметр parse_mode только если он вам действительно необходим. В противном случае возможны ошибки при отправке сообщений.

Если вы никак не форматируете содержимое сообщения (форматированием считается, например, наклонный или подчеркнутый текст) — не используйте parse_mode в запросе.


Блок кода
languagephppy
themeDJango
firstline1
titleCURLInline клавиатура
linenumberstrue
collapsetrue
{
    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": {
        "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ссылка на веб-апп


Блок кода
languagephppy
themeDJango
firstline1
titlereply клавиатура
linenumberstrueCURL
collapsetrue
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": {
        "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 клавиатура):

...

Блок кода
languagepy
themeDJango
firstline1
titleУдаление reply клавиатуры
linenumberstrue
collapsetrue
{
	"reply_markup": {
		"remove_keyboard": true
	}
}

...

Поле

Описание

reply_markupобъект "клавиатуры"
reply_markup.remove_keyboard

true – удалить reply клавиатуру в чате


Блок кода
languagepy
themeDJango
firstline1
titleТекст сообщения
linenumberstrue
{
	"text": "Какой-то текст для отправки\nА это уже на следующей строке будет"
}

Описание тела запроса (Текст сообщения):

Поле

Описание

text
Текст для отправки. Для переноса строка используется символ переноса строки "\n"

Описание параметров метода:

ПараметрОбязательностьОписание

chat_id

да

Идентификатор чата, в который будет отправлено сообщение.

 

Подсказка
*

Узнать идентификатор чата можно, например, через https://t.me/myidbot

parse_modeнет

Режим парсинга текста. Может быть Markdown MarkdownV2 или HTML. Подробнее можно прочитать здесь 

*Используется для форматирования текста (жирный, с наклоном и тд.)

textда

Текст, который отправит бот. 

*Для переноса строки необходимо использовать специальную последовательность символов: %0A

Например, текст:

Тест1

Тест2

Тест3

Можно передать следующим образом: Тест1%0AТест2%0AТест3

message_thread_id

нет

Идентификатор "темы" для отправки сообщения в тему группы, в которой включены "темы"

...

Примечание
titleВАЖНО

Метод редактирования сообщения аналогичный методу отправки сообщения с несколькими особенностям:

  1. Новый обязательный параметр message_id, который принимает идентификатор сообщения для редактирования
  2. В ответе появляется поле edit_date, в которое записывается дата изменения сообщения
  3. НЕВОЗМОЖНО ОТРЕДАКТИРОВАТЬ СООБЩЕНИЕ С REPLY КЛАВИАТУРОЙ (с инлайн все также можно)
  4. Если передать тот же текст при редактировании, что и в оригинале, то вернется ошибка 400 (для редактирования только инлайн клавиатуры без редактирования текста нужно использовать метод editMessageReplyMarkup без параметра text)