Описание

Функция позволяет автоматически публиковать истории (фото или видео) в Telegram через бота с возможностью настройки параметров публикации, таких как длительность, подпись, защита контента и другие.

Как получить Business Connection ID?
1️⃣ Настройте Telegram Business:
Зайдите в Настройки → Telegram для бизнеса.
Подключите бота, который будет постить Stories.
Дайте ему права отвечать в чатах.
2️⃣ Получите ID:
В любом чате (даже тестовом) отправьте команду:
/bid
Бот пришлет ваш Business Account ID — сохраните его для функции.

Параметры

Параметры, которые можно передать в функцию telegram_post_story:
token – Токен бота Telegram.
Уникальный ключ для доступа к API Telegram Bot.

media_url – URL медиафайла.
Ссылка на фото или видео, которое будет опубликовано в истории.

business_connection_id – ID бизнес-соединения.
Идентификатор бизнес-аккаунта, если публикация осуществляется от его имени.

active_period – Период активности публикации.
Время, в течение которого история будет доступна (например, 86400 для 24 часов).

is_photo – Тип медиа.

true – если медиа является фото,

false – если видео.

duration – Длительность видео в секундах.
Обязателен, если is_photo = false.

cover_frame_timestamp – Временная метка кадра для обложки видео.
Указывает, какой кадр из видео использовать как обложку.

is_animation – Является ли видео анимацией.

true – если видео является анимацией (GIF),

false – обычное видео.

caption – Подпись к медиа.
Текст, который будет отображаться в истории.

parse_mode – Режим парсинга текста.
Поддерживаются Markdown и HTML для форматирования текста.

caption_entities – Сущности для форматирования подписи.
Массив объектов для тонкой настройки текста (жирный, курсив, ссылки).

areas – Области для наложения.
JSON-строка с описанием областей для интерактивных элементов (кнопки, стикеры).

post_to_chat_page – Постить в чат-страницу.

true – опубликовать историю также в чате бота,

false – только в историях.

protect_content – Защитить контент.

true – запретить пересылку и сохранение контента,

false – разрешить.

Примеры использования

"Опубликуй фото по ссылке [URL] в истории бота с токеном [токен]. Подпись: 'Новое поступление!', период активности — 24 часа."

"Запости видео [URL] через бота [токен]. Длительность: 15 секунд, обложка — 5-я секунда. Бизнес-аккаунт: [ID]. Защитить контент."

Кейсы