Поток событий

Ссылка, по которой события бота приходят сразу, как они происходят, в формате Server-Sent Events. Это те же события, что ложатся в GETИсторию событий. Поток подходит боту, который не принимает вебхуки на свой адрес, но должен отвечать быстро, например на нажатие кнопки или отправку формы.

Поток работает, только когда в настройках бота включён пункт «Сохранять историю событий». Если пункт выключен или поток недоступен, метод отвечает 404 без тела. Метод работает только с токеном бота.

Ссылку открывают без токена, например через EventSource или curl -N: доступ даёт сама ссылка, поэтому храните её как секрет. Каждое событие приходит записью истории с полями id, event_type, payload и created_at, а служебные сообщения подключения отличаются полем type.

Ссылка действует до expires_at, а потом поток перестаёт присылать события, не закрывая соединение. Новую ссылку берите в последние пять минут перед expires_at: более ранний запрос вернёт ту же ссылку. Чтобы ничего не пропустить, после подключения дождитесь подтверждения подписки и только потом прочитайте GETИсторию событий, и так после каждого переподключения и смены ссылки. Доставка в поток не гарантирована: обработанные события по-прежнему удаляйте методом DELETEУдаление события истории, а повторы отсекайте по id. Если у бота есть адрес вебхука, повторная доставка на него приходит в поток ещё раз с новым id: такие повторы отсекают по ключу из payload, как в разделе Идемпотентная обработка. Подробнее — в разделе Поллинг.