Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.omneo.io/llms.txt

Use this file to discover all available pages before exploring further.

Reactions are Omneo’s automation engine. A reaction watches for something to happen (or a schedule to fire), evaluates conditions, and executes a chain of actions.

Two types of reactions

TypeWhat fires itExample use
TriggerAn Omneo event (e.g. transaction.created, tier.achieved)Award points when a transaction is recorded
AutomationA scheduled time or intervalSend a win-back benefit to lapsed customers each Monday
Both are configured the same way — the difference is the trigger field value.

Anatomy of a reaction

A reaction has:
  • trigger — the event or schedule that fires the reaction
  • is_active — whether the reaction is enabled
  • actions — an ordered array of steps to execute, each with a sort_order
Actions run in sort_order sequence. If an action fails its condition (e.g., a filter action returns false), the chain stops.

Common action types

ActionWhat it does
filterEvaluates a JSON Logic condition — stops the chain if false
points.awardAwards points to the profile
benefit.createIssues a benefit to the profile
reward.createIssues a reward to the profile
tier.assignAssigns a tier to the profile
achievement.progressIncrements an achievement
target.sendSends a Twig-templated JSON payload to a configured target endpoint

Common trigger events

EventFires when
transaction.createdA transaction is recorded
profile.createdA new profile is created
profile.updatedA profile is updated
tier.achievedA profile achieves a new tier
benefit.claimedA benefit is claimed
reward.redeemedA reward is redeemed
points.awardedPoints are awarded

Data available in reactions

All reaction filters and actions have access to the Event Context for the triggering event. The context includes the profile, the triggering object (transaction, benefit, etc.), and related data. See Reaction Filters and JSON Conditions for how to access and evaluate this data.

Managing reactions

Reactions can be created and managed via the API (/api/v3/triggers) or via CX Manager under Settings → Reactions. A reaction must have is_active: true to fire.