Workflows

Workflows automate behavior-based communication using queue-driven execution.

​

How Execution Works

1. Trigger conditions place items in workflow_queue.
2. Worker claims due queued rows safely.
3. Execution records are created per queue item.
4. Email action is rendered and sent.
5. Queue and execution status are finalized.

Current behavior in phase one:

• Primary action is email send execution.
• Worker runs in-process with polling.
• Row-level locking prevents duplicate claims in multi-instance setups.

​

Statuses You Will See

Workflow queue:

• queued
• processing
• completed
• expired
• failed

Workflow execution:

• queued
• executing
• completed
• failed
• cancelled
• skipped

​

Skip And Failure Scenarios

Typical skip reasons:

• contact has no email
• contact is unsubscribed

Typical failure reasons:

• missing default template
• provider not configured
• provider send errors

​

Operational Best Practices

1. Keep templates workflow-safe and variable-safe.
2. Validate sender provider config before enabling high-volume triggers.
3. Monitor failed queue items and retry trends.
4. Use event quality checks to reduce noisy triggers.