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

Ключ

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

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

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

  • Метод:

...

...

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

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

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

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

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


Блок кода
languagepy
themeDJango
firstline1
titleInline клавиатура
linenumberstrue
collapsetrue
{
    "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"
                    }
                }
            ]
        ]
    }
}

...

Блок кода
languagepy
themeDJango
firstline1
titlereply клавиатура
linenumberstrue
collapsetrue
{
    "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
                }
            ]
        ]
    }
}

...

Блок кода
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

нет

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

...

ПолеОбязательностьОписание
okдаРезультат запроса. При успешном запросе всегда возвращает "true"
resultдаМассив результата ответа
message_idдаИдентификатор сообщения
fromдаМассив информации отправителя
idдаИдентификатор отправителя
is_botдаПризнак того, бот ли отправитель
first_nameдаИмя отправителя
usernameдаУникальный username отправителя
chatдаМассив информации чата, куда отправлено сообщение
idдаИдентификатор чата
titleдаНазвание чата
typeдаТип чата
dateдаДата отправки сообщения
textдаТекст сообщения

Редактирование сообщения

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

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

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