diff --git a/fern/server-url/events.mdx b/fern/server-url/events.mdx index 4f4fa615c..8119b710b 100644 --- a/fern/server-url/events.mdx +++ b/fern/server-url/events.mdx @@ -146,6 +146,40 @@ Respond with either an existing assistant ID, a transient assistant, or transfer { "destination": { "type": "number", "phoneNumber": "+11234567890" } } ``` +#### Transfer only (skip AI) + +If you want to immediately transfer the call without using an assistant, return a `destination` in your `assistant-request` response. This bypasses AI handling. + +```json +{ + "destination": { + "type": "number", + "phoneNumber": "+14155552671", + "callerId": "{{phoneNumber.number}}", + "extension": "101", + "message": "Connecting you to support." + } +} +``` + +```json +{ + "destination": { + "type": "sip", + "sipUri": "sip:support@example.com", + "sipHeaders": { "X-Account": "gold" }, + "message": "Transferring you now." + } +} +``` + + + When `destination` is present in the `assistant-request` response, the call forwards immediately and assistantId, assistant, squadId, and squad are ignored. + You must still respond within 7.5 seconds. + To transfer silently, set destination.message to an empty string. + For caller ID behavior, see Call features. + + Or return an error message to be spoken to the caller: ```json