The Handoff step starts chat or SMS message relay. Its editor is titled Agent handoff. For the capability explanation, read Chat and SMS handoff; for a walkthrough, use Set up handoff. Phone transfer uses the separate Call forward step.

Provider and customer fields

Handoff context: Full transcript, Custom (a string variable), or None. The editor starts a newly added step with Full transcript; select the intended mode explicitly.

Return path: enable for a connected follow-up or a return to the parent agent. Disable to end the session on return. Failure path: enable and connect the branch taken if creation fails.

Configuration JSON

Use a JSON object in Configuration. Quoted {variable} placeholders support interpolation. A value consisting only of a variable preserves that variable’s type.

Invalid JSON or a non-object produces no metadata. A known key with an invalid type is dropped while other valid keys remain. Unknown keys are retained; that does not make them supported Voiceflow settings. Unsupported wait-time modes fall back to provider behavior, so use None to disable an estimate.

"disableFileUpload": "{upload_flag}" needs a boolean variable, not the string "true". Configuration metadata resolves from variables; provider credentials belong in Integrations.

Configuration example

Kustomer Configuration example

This example adds a Kustomer note and hides customer uploads. It neither generates handoff_summary nor changes the human team’s permissions.

Use the up and down arrow keys to select a result, Enter to open it, and Escape to close the search.