queue.consumer
queue.consumer automation events are triggered by the Background Queue scheduler to process a batch of messages from an automation-backed queue.
The batch size is configured per queue – use 1 for expensive per-message operations, or 10-100+ to amortize batch operations.
Placeholders
The automation event dictionary starts with the following values:
| Key | Type | Notes |
|---|---|---|
queue_* |
record | The queue being consumed. Supports key expansion. |
queue_job_* |
record | The queue job that owns this batch, if any. Supports key expansion. |
messages |
array | An array of {uuid, message, available_at, job_id} dicts for the batch. |
Outputs
(none)
Any non-error response is treated as successful delivery of the entire batch. If the automation returns an error: outcome, the messages are marked failed and retried per the queue's retry policy.