Event

The Event action is for generating custom events in the User event domain. It's used to queue up follow-up work, either immediately or in the future, and can be useful when designing complex workloads, separating work between tasks.

Events generated by this action may be responded to by other tasks, or by the task that generated this action.

Events generated by this action are child events of the event responsible for the current action.

Options

Notes

If a run_at value specifies a time in the past, the new event will be run immediately.

Tasks specified by task_ids or task_id must subscribe to the event topic being used. As with all subscriptions, offsets may be used, and will be respected.

Examples

Using the Event tag

{% assign data = hash %}
{% assign data["foo"] = "bar" %}

{% action "event", topic: "user/foo/bar", data: data %}

Using specific tasks

Using task_id

Uses the optional task_id parameter to control which singular task is allowed to respond to this event.

That task must be subscribed to the event topic being used.

{% assign data = hash %}
{% assign data["foo"] = "bar" %}
{% assign task_id = "293b7040-6689-4eb1-8b5d-64f4d33eb2ae" %}
{% comment %} For multiple tasks use `task_ids` {% endcomment %}

{% action "event", topic: "user/foo/bar", data: data, task_id: task_id %}

Notes

You can limit a task to itself by referencing it's own task.id

See options to have a user configurable input instead of hardcoding the task id(s).

Scheduling future events

Using run_at

This example uses the run_at option to run the task at a later scheduled time.

{% assign one_day_in_seconds = 60 | times: 60 | times: 24 %}

{% action "event" %}
  {
    "topic": "user/foo/bar",
    "task_id": {{ task.id | json }},
    "run_at": {{ "now" | date: "%s" | plus: one_day_in_seconds | json }},
    "data": {
      "foo": "bar"
    }
  }
{% endaction %}

This task emails a customer daily until their order is paid. It works by scheduling a follow-up run of the same task, one day in the future, using the run_at option.

shopify/orders/create
user/orders/unpaid_reminder

Using subscription offsets

This task emails a customer daily until their order is paid. It works by firing the follow-up event immediately, using a subscription offset to respond to it a day later.

shopify/orders/create
user/orders/unpaid_reminder+1.day

Last updated