ИП Горелов Максим Николаевич 8 (915) 093-74-75
Публикация историй в Telegram через бота
Доступно на тарифе:
Стартовый
Бизнес 2025
Профи 2025
Что такое функция?
Функции — внешние инструменты (фрагменты кода), к которым могут обращаться LLM модели для решения задач пользователей. Модель не исполняет функции, но самостоятельно принимает решение о том как, когда и с какими параметрами их следует вызвать. При принятии решения о вызове функции модель исходит из доступных знаний, данных текущего разговора и описания функции. После обращения к функции модель может обработать результат ее работы.
Что такое параметры?
Это входные данные, которые функция использует для выполнения своей задачи. Они позволяют сделать функцию гибкой и многоразовой, так как она может работать с разными данными без изменения своего кода. Например, функция для генерации изображений может принимать параметры query (описание изображения) и resolution (разрешение), чтобы создавать разные картинки по запросу. Параметры нужны, чтобы функция знала, что именно ей нужно обработать или какие условия учесть при выполнении действия.
Как научить ИИ агента использовать эти параметры в функции?
Чтобы объяснить ИИ, какой параметр нужно передать, вы должны включить в промпт бота четкие инструкции. Эти инструкции должны описывать:
Когда нужно вызвать функцию (условие или триггер).
Какую функцию вызвать (по названию или номеру).
Какие параметры и из какой информации в диалоге их брать.
Например, если у вас есть функция для отправки лида (№26), и она принимает параметры name, phone, email, вы можете написать в промпте:
"Если клиент пришлет свой номер телефона, то сразу же вызови функцию №26 (отправка лида). В качестве phone передай номер телефона клиента, в качестве name используй имя, которое клиент указал в диалоге, а email возьми, если клиент его предоставил."
ИИ будет анализировать диалог и, когда увидит соответствующее условие (например, клиент назвал свой номер телефона), он попытается извлечь нужные данные и передать их в указанную функцию.
Как научить ИИ агента правильно отвечать после выполнения функции?
Чтобы агент не отправлял технические данные, ему нужно дать инструкции что отвечать после того, как функция была вызвана.
Например для 26-й функции (отправка уведомлений) это выглядит так:
Если клиент пришлёт номер телефона, то сразу же вызови функцию отправки лида, а в качестве результата вышли клиенту дословно: «спасибо, заявка принята»
Например для 15й функции (генерация картинки) это выглядит так:
Если клиент попросит создать или нарисовать изображение, то сразу же вызови функцию 15, а в качестве результата вышли ему полученную ссылку.
Функция позволяет автоматически публиковать истории (фото или видео) в 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]. Защитить контент."
ИП Горелов Максим Николаевич ИНН 500104951533 ОГРН 309500106900065