SIP PBX Trigger

Overview

SIP PBX Trigger opens a long-lived trigger stream from the PBX daemon into n8n.

It has four trigger modes:

• Trunk Event
• Extension Event
• Queue Event
• AI Tool Call

Mode Summary

Mode	Main purpose	Output branches
Trunk Event	Inbound SIP traffic from external trunks, optional auth workflow for Dynamic Address, optional recording decisions	Call, optional Recording, optional Auth
Extension Event	Extension registration, extension-originated calls, optional auth workflow, optional recording decisions	Call, optional Recording, optional Auth
Queue Event	Queue lifecycle emitted by the daemon	Placed, Dispatch, Offline
AI Tool Call	Tool invocation requests from a live voice-agent session	Request

Common Parameters

Parameter	Applies to	Required	Description
Trigger On	All modes	Yes	Selects the trigger contract and visible parameter set.
ref	All modes except AI Tool Call uses AI Tool Ref label	Yes	Stable public routing key for this trigger group. Used in runtime state, emitted payloads, and follow-up actions.
Options	Depends on mode	No	Mode-specific advanced settings.

Common Output Rules

Rule	Meaning
json.sipPbx is emitted on trigger items	Carries hidden IDs and routing context used by follow-up actions.
Branch names are part of the public contract	Route workflow logic by branch name, not by branch index assumptions.
ref is always public	It is the stable identifier you choose in the trigger.

Common Output Metadata

Field	Meaning
sipPbx.ref	Trigger ref used by automatic ID resolution and follow-up actions.
sipPbx.legId	Present on call-like events when a live leg exists.
sipPbx.authRequestId	Present on Auth branches.
sipPbx.recordRequestId	Present on Recording branches.
sipPbx.aiToolRequestId	Present on AI tool request branches.

Mode Pages

Mode	Detailed page
Trunk Event	Trunk Event Trigger
Extension Event	Extension Event Trigger
Queue Event	Queue Event Trigger
AI Tool Call	AI Tool Call Trigger