Skip to main content

Documentation Index

Fetch the complete documentation index at: https://www.cometchat.com/docs/llms.txt

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

Sequences let you define the order in which notification channels fire and the conditions that stop the sequence early. Instead of broadcasting the same message across all channels simultaneously, you deliver in a prioritised chain where each step waits for a result before deciding whether to proceed.

Why use sequences

  • Improve deliverability. Target the channel most likely to reach the user based on their prior engagement pattern.
  • Avoid notification fatigue. Stop the chain as soon as the user has seen or acted on the message, rather than hitting them on every channel.

How it works

Sequences are configured at the template level. When you create or edit a template in the Dashboard:
  1. Add two or more channels to the template.
  2. Enable the Sequence toggle in the template settings.
  3. Arrange the channels in the desired delivery order. The first channel fires immediately at send time.
  4. For each subsequent step, configure:
    • Stop condition. The engagement signal that halts the sequence. Available conditions depend on the channel:
      • In-app: delivered | read | engaged
      • Push: delivered | clicked
    • Wait window. How long to wait for the stop condition before moving to the next step: 5, 10, 30, 60, 240, or 1440 minutes.
If the stop condition is met within the wait window, the remaining steps are skipped. If the window expires without the condition being met, the next channel fires.

Example

A template with two channels configured as a sequence:
StepChannelStop conditionWait
1In-appdelivered30 min
2Pushn/an/a
At send time, the in-app notification is dispatched immediately. If the item is marked delivered within 30 minutes, the sequence stops and push is never sent. If 30 minutes pass without a delivery signal, push fires as a fallback.

Metrics

When a template uses sequencing, per-step delivery metrics are available through the Dashboard and the analytics API. Which metrics are reported depends on the channel:
ChannelRequestedDeliveredClicked
In-app
Push
These metrics help you evaluate whether your sequence order and wait windows are tuned correctly, and where users are dropping off.