loadRandomContent

loadRandomContent — загружает случайный контент из списка доступных в текущий контекст выполнения.

📝 Назначение

Используется для выбора случайного контента из всех созданных в разделе /adm → Публикации. После загрузки данные становятся доступны через переменную ${content}.

Когда это нужно:

• Рандомная рассылка (разные контенты разным пользователям)
• Игровые механики (случайный факт, случайный вопрос)
• Ротация рекламных объявлений
• A/B тестирование разных вариантов сообщений
• «Кнопка удачи» — случайный контент по запросу

💡 Совет: Комбинируйте с sendContent для отправки случайного контента пользователю.

📍 Результат

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

${content}

Структура ${content}:

🎲 Как выбирается случайный контент

⚠️ Важно: Выбор происходит случайным образом при каждом вызове. Нет гарантии, что разные пользователи не получат один и тот же контент.

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

Пример 1: Отправка случайного контента пользователю

Задача: При команде /random отправлять пользователю случайный контент из всех доступных.

Обработчик: Команда /random

Реакции:

1. loadRandomContent (список не указан)
2. sendContent → Контент: ${content.name}, Чат: ${chat.id}

Пример 2: Случайный факт из подборки

Задача: Отправлять случайный «факт дня» из списка контентов fact_01, fact_02, fact_03.

Обработчик: Команда /fact

Реакции:

1. loadRandomContent → Список контентов: fact_01, fact_02, fact_03
2. sendContent → Контент: ${content.name}, Чат: ${chat.id}

Пример 3: A/B тестирование (50/50)

Задача: 50% пользователей получают вариант A, 50% — вариант B.

Обработчик: Команда /test

Реакции:

1. loadRandomContent → Список контентов: variant_a, variant_b
2. sendContent → Контент: ${content.name}, Чат: ${chat.id}
3. SendMessage → (в технический чат) текст: Пользователю ${user.id} отправлен вариант: ${content.name}

Пример 4: Ротация рекламных объявлений

Задача: При каждом новом пользователе отправлять случайное рекламное объявление.

Обработчик: Команда /start

Реакции:

1. loadRandomContent → Список контентов: ad_winter, ad_spring, ad_summer, ad_autumn
2. sendContent → Контент: ${content.name}, Чат: ${user.id}

Пример 5: Кнопка «Удачи» (с исключением текущего)

Задача: При нажатии кнопки отправлять случайный контент, отличный от текущего.

Обработчик: Нажатие кнопки

Реакции:

1. loadContent → загрузить текущий контент (чтобы знать его ID)
2. loadRandomContent → Список контентов: content_1, content_2, content_3 (без текущего)
3. sendContent → Контент: ${content.name}, Чат: ${chat.id}

Пример 6: Использование в отложенном действии

Задача: Через час после подписки отправить случайный приветственный контент.

Реакции (при подписке):

1. StartTask → Отложенное действие: welcome_random, Отсрочка: 1h

В отложенном действии:

1. loadRandomContent (список не указан)
2. sendContent → Контент: ${content.name}, Чат: ${user.id}

🔄 Особенности поведения

📊 Пример распределения

При выборе из 4 контентов с равной вероятностью:

💡 Совет: Для неравномерного распределения (например, 70/30) используйте несколько вызовов loadRandomContent с разными наборами и условиями.

🔗 Связанные реакции

🔗 Связанные разделы

🔗 Быстрая навигация

• Вверх
• Параметры
• Результат
• Как выбирается случайный контент
• Примеры
• Особенности

🔗 Ссылка на официальную документацию

(Функция реализована на стороне платформы EnotPro, не является методом Telegram Bot API)