SIP PBX Trigger Queue Event

Overview

Use SIP PBX Trigger with Trigger On = Queue Event to receive daemon-owned queue lifecycle events.

This trigger does not place callers into a queue by itself. Queue placement is performed by SIP PBX -> Queue -> Put Leg In Queue.

Parameters

Parameter	Required	Description
Trigger On	Yes	Select Queue Event.
Queue Ref	Yes	Stable public queue name.
Extensions	Yes	Comma-separated operator extension numbers used by the daemon for dispatch.

Output Branches

Branch	Meaning
Placed	The leg was placed into the queue.
Dispatch	An operator became available and the daemon started dispatching.
Offline	Queue dispatch could not proceed with available operators or retries were exhausted.

Placed Output Payload

Field	Meaning
ref	Public queue ref.
legId	Caller leg placed into the queue.
callerNumber	Caller number associated with the queue entry.
callerName	Caller display name associated with the queue entry.
trunkRef	Source trunk ref when known.
sipPbx.ref	Hidden routing metadata.
sipPbx.legId	Hidden leg resolution metadata.

Dispatch Output Payload

Field	Meaning
ref	Public queue ref.
mode	live or callback.
dialId	Dial created for operator dispatch.
legId	Original live caller leg, when still present.
callerNumber	Caller number associated with the queue entry.
callerName	Caller display name associated with the queue entry.
trunkRef	Source trunk ref when known.
sipPbx.ref	Hidden routing metadata.
sipPbx.dialId	Hidden dial resolution metadata.
sipPbx.legId	Hidden leg resolution metadata when present.

Offline Output Payload

Field	Meaning
ref	Public queue ref.
mode	live or callback.
legId	Original live caller leg, when still present.
callerNumber	Caller number associated with the queue entry.
callerName	Caller display name associated with the queue entry.
trunkRef	Source trunk ref when known.
sipPbx.ref	Hidden routing metadata.
sipPbx.legId	Hidden leg resolution metadata when present.

Notes

Topic	Meaning
Queue ownership	Queue routing and retry decisions are daemon-owned, not workflow-raced.
Operator lookup	Operator resolution is by extension number, not by one explicit extensions trigger ref.
Workflow scope	Matching operator lookup spans visible extensions refs inside the same workflow scope.
callback mode	callback means the queue entry survived after the caller leg ended with callback already enabled. Turning callback on does not remove the live caller from queue by itself.

Related Action Page

Read SIP PBX Queue Actions together with this page.