1. Messaging
Platform API
  • Введение
  • 00-Templates
  • 01-Documentation
    • API Style Guide
    • Breaking Changes
    • API versioning folder structure
    • Proposals
      • Предложение - Разделение ответственности: `sourceA -> sourceB?ids=...`
    • Architecture Decision Records
      • Формат Response Data
      • Переиспользование ресурсов в микросервисной архитектуре
  • Devices
    • Зарегистрировать устройство
      POST
  • Authentication
    • Получить токен пользователя
      POST
    • Регистрация нового пользователя
      POST
  • Advertising
    • Реклама
  • User (Profile, Levels, Gifts, Awards, Feedbacks, Following)
    • Profile
      • Birthday Greeting
        • Получить поздравление с днем рождения
        • Отметить поздравление с днем рождения как просмотренное
      • Email
        • Сменить почту
        • Подтвердить смену почты по токену
        • Подтвердить почту
        • Подтвердить почту по токену
    • Level Stages
      • Документация
      • Получить список всех стадий
      • Получить данные о текущей стадии пользователя
      • Получить данные о стадии по ID
    • Gifts
      • Документация
      • Получить список всех подарков
      • Получить список всех категорий подарков
      • Получить данные об одном подарке по ID
      • Пометить подарок как полученный
    • Awards
      • Получить награды пользователя
    • Follow
      • Подписывает текущего пользователя на указанный профиль
      • Получение подписчиков пользователя
      • Получение списка подписок
      • Удаляет подписчика пользователя
    • Получить данные о текущем пользователе
      GET
    • Получить публичный профиль пользователя по ID
      GET
    • Удалиться
      POST
  • Samagonka | Sprint | Summarace | Knowledge Sprint
    • Получить саммагонку на текущую неделю
    • Получить календарь саммагонки
    • Получить статистику по спринту
    • Получить Топ пользователей по саммагонке
    • Получить рейтинг по сданным экзаменам
    • Получить историю рейтинга экзаменов
    • Получить топ 20 курсов
  • Categories
    • 2025-08-01 / Иконки категорий
    • Получить список категорий
  • Subscription
    • v5
      • Получить статус подписки
  • Combo Summary
    • Моё
      • Получить список избранных комбо-саммари
      • Получить список начатых комбо-саммари
      • Получить список пройденных комбо-саммари
      • Изменить состояние избранного для комбо-саммари по ID
    • Получить список комбо-саммари
    • Получить комбо-саммари по ID
    • Получить диплом для комбо-саммари по ID
    • Получить список комбо-саммари в которые входит саммари по ID саммари
    • Сгенерировать диплом для комбо-саммари по ID
  • Courses | Summary | Lectures
    • v5
      • Получить случайный саммари
      • Скачать видео из курса
      • Получить список качеств видео из курса
      • Получить список общие качества всех видео из курса
    • v3
      • Моё
        • Получить список просмотренных саммари (Начатые, Пройденные)
      • Получить список саммари
    • unspecified
      • Получить саммари по ID
  • Compilations
    • v3
      • Получить подборки
  • Bookmarks
    • v3
      • Создать закладку в лекции
    • v5
      • Создать закладки в лекции
  • Notifications
    • Получить список уведомлений
    • Получить количество непрочитанных уведомлений
  • Feedbacks
    • Получить мнения для саммари по ID
    • Получить все мнения текущего пользователя
    • Получить все мнения пользователя по User ID
    • Получить комментарии к мнению по ID
    • Получить список мнений для "Сейчас обсуждают"
    • Получить мнение по ID
    • Получить список мнений пользователя
  • Achievements
    • Получить достижение по ID
    • Получить список достижений
    • Установить saluted на true
  • Lecturers
    • Получить список лекторов
    • Получить лектора по ID
  • Tests/Games/Quizzes/Exams
    • Введение
    • Quizzes
      • v5
        • Bookmark Templates
          • Получить шаблон для создания закладки по ID квиза и ID вопроса
      • Получить данные по квизу по ID
      • Получить результат квиза по ID
    • Plays
      • Начать квиз для данного пользователя
      • Получить вопрос теста по ID
      • Завершить текущий квиз
      • Отправить ответ на вопрос
      • [Deprecated] Начать квиз для данного пользователя - V3
    • In-Player Quiz
      • v5
        • In-Player Quiz: описание модуля
        • Get In-Player Quiz questions
        • Complete In-Player Quiz Question
  • Playlist
    • v5
      • Документация
      • Summary
        • Получить начальную пагинацию плейлиста саммари.
        • Получить следующую пагинацию плейлиста саммари.
        • Получить информацию о видео из плейлиста.
      • Favorites
        • Получить начальную пагинацию плейлиста избранного.
        • Получить cледующую пагинацию плейлиста избранного.
  • Subscription Certificates
    • Инфа о сетификате
    • Создать подарочный сертификат
    • Получение сертификатов пользователя
    • Активировать сертификат
  • Orders
  • Rating
    • Бусты
    • v5
      • Получить модификаторы для баллов
      • Получить активный буст баллов
    • unspecified
      • Получить топ-100 пользователей рейтинга
      • Получить историю рейтингов
      • Переключает флаг пользователя на отображение топа предыдущего месяца
  • In-Design
    • Messaging
      • Введение
      • Триггеры
      • Сегментация
      • Способы доставки
      • Представление и Виджеты
  • Success-Story
    • Получить историю успеха
  • Intensives
    • Получить все интенсивы
  • Mascot
    • Получить текущий статус маскота
    • Получить прогресс пользователя по текущему статусу маскота
    • Получить все статусы маскота
    • Получить скиллы маскота
    • Получить модификаторы по скиллам маскота
    • Получить график статистики по скиллам маскота
    • Получить скилл, который относится к заданной категории.
  • Animations
    • Получить анимации
    • Получить анимацию по ID
  • Quiz-Card
    • Получить квиз карточки по id саммари или slug для текущего клиента
    • Получить группы квиз карточек по саммари пользователя доступные на текущую дату
    • Отвязать(удалить) выбранные карточки из групп карточек пользователя
  • Files
    • Загрузить файл
  • Mini-Tasks
    • Получить мини-задания
  • Live Activity
    • Зарегистрировать токен LA за пользователем
  • Recommendations
    • AI Рекомендации
    • Получить AI рекомендации
  • Timecodes
    • Получить список аннотаций для лекции/видео
  • Archetypes
    • Эпохи
    • Персонажи
    • Навыки
    • Notifications
      • Получить список уведомлений от Маскота
      • Получить кол-во уведомлений от Маскота
      • Отметить уведомления от Маскота просмотренными
    • Skills
      • SkillLevels
        • Запросить генерацию сертификата по уровню навыка
        • Пометить уровень навыка как просмотренный
        • Получить SkillLevel2DTO по ID уровня
        • Получить список SkillLevel1DTO
      • SkillSuperPowers
        • Получить список всех суперспособностей
        • Пометить суперспособность как просмотренную
      • Получить список SkillProgressDTO
      • Получить SkillProfessionDTO по ID навыка
      • Получить лекцию навыка по ID навыка и индексу
      • Получить навык по идентификатору
      • Получить навык по ID категории
    • Characters
      • Получить диалог с персонажом по его ID
      • Получить персонажа по его ID
      • Получить открытых персонажей
      • Обновить персонажа по ID
    • Получить текущую эпоху
  • Schemas
    • Core
      • LanguageText
      • Metadata
      • ApiError
      • File
      • AnimationProperties
      • Metadata2
    • Basic
      • Ranges
        • DateRange
      • GradientV2
      • Gradient
      • Color
    • Resources
      • Courses
        • Course
        • CourseListItem
      • Recommendations
        • RecommendedCourseListItem
    • Schemas
      • Achievements
        • Achievement
      • Animations
        • Animation
        • AnimationListItem
      • Playlist
        • v5
          • Summary
            • Cursor
          • Favorites
            • Cursor
          • Video
      • Subscription
        • SubscriptionInfo
        • UserSubscriptionInfo
      • Lecturers
        • LecturerListItem.Invalid
        • Lecturer
      • ComboSummary
        • ComboSummaryListItem
        • ComboProgressItem
        • ComboSummary
      • Feedbacks
        • Feedback
        • FeedbackComment
        • UserFeedback
        • FeedbackAchievement
        • FeedbackListItem
        • FeedbackDetails
        • FeedbackUser
      • KnowledgeSprint
        • KnowledgeSprintCalendar
        • KnowledgeSprintTopUser
        • KnowledgeSprintStats
      • MiniTasks
        • MiniTask
      • Level System
        • LevelStage
        • GiftCategory
        • Gift
      • User
        • User
        • ActiveUser
        • Award
      • Tests | Quizzes
        • v5
          • In-Player Quiz
            • InPlayerQuiz
            • InPlayerQuizQuestion
            • InPlayerQuizAnswer
            • InPlayerQuizCompletedState
        • QuizInfo
        • QuestionInfo
        • QuizPlay
        • QuizResult
        • QuizFinishState
      • Subscription Certificates
        • Certificate
        • CreateCertificate
      • Rating
        • RatingInfo
        • RatingTopUsers
        • RatingTopUser
        • ActiveBoost
      • SuccessStory
        • SuccessStory
      • Intensive
        • Intensive
      • Notifications
        • NotificationsUnreadCount
        • Notification
      • Archetypes
        • Notifications
          • ArchetypeNotification
        • Skills
          • SkillProgressDTO
          • SkillProfessionDTO
          • SkillCourseItem
          • Superpower
          • SkillLevel1DTO
          • SkillLevel2DTO
          • Skill
        • Characters
          • Character
          • UnlockedCharacters
          • CharacterChat
          • CharacterChatMessageItem
          • NextCharacterProgress
          • CharacterDetails
        • UserSkillLevel
        • Epoch
      • Samagonka_Duplicate
        • SummaraceDay
        • SummaraceDays
        • SummaraceTarget
        • KnowledgeSprintData
        • SummaraceDataUser
        • SummaraceTopInfo
        • TopHistoryData
        • TopCourse
      • Mascot
        • Graph
        • Skills
          • MascotSkillModifiers
          • MaskotSkill
        • Statuses
          • MaskotStatusListItem
          • MascotStatus
          • MascotStatusProgress
        • MascotStats
      • Quiz-Card
        • QuizCard
        • QuizCardGroup
        • QuizCardGroupSummaryInfo
      • Categories
        • Category
    • Timecodes
      • Timecode
    • Bookmark
    • BookmarkTemplate
  1. Messaging

Триггеры

In-App сообщения показываются пользователям на основании триггеров — специальных условий, которые срабатывают при возникновении определенных событий в приложении. Триггер может содержать логику проверки параметров события с использованием JsonLogic, что позволяет гибко настраивать условия показа сообщений.

Как работают триггеры#

Триггер — это условие, привязанное к событию в приложении.
Событие — это действие пользователя или системы, которое имеет название и может содержать параметры (например, покупка товара или завершение уровня в игре).
JsonLogic — это формат, используемый для проверки условий триггера. Он позволяет сравнивать параметры события и принимать решение о показе сообщения на основе этих данных.
Триггеры должны быть сериализуемыми, чтобы их можно было передавать по сети и сохранять.

Пример события#

Пример события может выглядеть так:
{
  "event": "purchase",
  "parameters": {
    "amount": 120.50,
    "currency": "USD",
    "product_id": "12345"
  }
}

Пример триггера с использованием JsonLogic#

Этот триггер сработает, если пользователь совершил покупку (событие purchase) на сумму больше 100 USD.
{
  "event": "purchase",
  "condition": {
    "and": [
      { "==": [{ "var": "currency" }, "USD"] },
      { ">": [{ "var": "amount" }, 100] }
    ]
  }
}

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

1.
Показ сообщения после успешной покупки:
{
  "event": "purchase",
  "condition": {
    "and": [
      { "==": [{ "var": "currency" }, "USD"] },
      { ">": [{ "var": "amount" }, 50] }
    ]
  }
}
2.
Сообщение при достижении нового уровня:
{
  "event": "level_up",
  "condition": {
    "==": [{ "var": "level" }, 10]
  }
}
3.
Показ сообщения пользователю, завершившему регистрацию:
{
  "event": "registration_complete",
  "condition": {}
}

Пример полученного сообщения от API#

{
  "id": "welcome_back",
  "triggers": [
    {
      "event": "user_login",
      "condition": {
        "==": [{ "var": "login_count" }, 2]
      }
    },
    {
      "event": "profile_incomplete",
      "condition": {}
    }
  ],
  "widget_id": "welcome_back"
}
Modified at 2026-07-08 15:19:33
Previous
Введение
Next
Сегментация
Built with