Workflow blocks
Pass Conversation Control
Pass switchboard control to another integration (e.g. escalate to a human agent).
zendesk/pass-conversation-control — Pass switchboard control to another integration (e.g. escalate to a human agent).
Where it appears
The Pass Conversation Control block lives in the Integrations group of the Workflow Builder. Connect the Zendesk integration before adding it.
Fields
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
conversationId | text (supports references) | Yes | — | Sunshine Conversations conversation ID whose switchboard control should be passed. Use a literal ID or <StepName.field>. |
metadata | code | No | — | Optional metadata to attach to the passControl event. |
Inputs and outputs
Inputs are the configurable fields above. The block produces these outputs:
Outputs
Reference an output downstream with <Pass Conversation Control.field>.
| Name | Type | Description |
|---|---|---|
success | boolean | Success status |
error | string | Error message if failed |
Example
A minimal configuration for this block:
{
"type": "zendesk/pass-conversation-control",
"config": {
"conversationId": "<PreviousStep.field>"
}
}Limits and failure modes
- Requires a connected Zendesk integration. Calls fail if that integration is disconnected or its authorization has expired.
- Required field (
conversationId) must be set, or the block fails validation before it runs. - On failure the
erroroutput is populated; downstream blocks that reference other outputs may not receive values.