Вы просматриваете старую версию данной страницы. Смотрите текущую версию.

Сравнить с текущим просмотр истории страницы

« Предыдущий Версия 9 Следующий »

Метод: GET/POST

Authorization: No Auth 

URL: https://api.telegram.org/bot{token}/sendMessage?chat_id={chat_id}&parse_mode=Markdown&text={text}

ВАЖНО


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

Inline клавиатура
{
    "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 клавиатура
{
    "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запрос геолокации

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

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

chat_id

да

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

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

parse_modeнет

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

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

textда

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

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

%0A

Например, следующий текст:

Тест1

Тест2

Тест3

Можно передать следующим образом:

Тест1%0AТест2%0AТест3

Успешный ответ в формате Json
{
    "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даТекст сообщения
  • Нет меток