Call transfers

Transfers can target the customer’s PBX or another AI4CALL assistant. A PBX destination may be an extension, group, or queue managed by that PBX.

For an assistant-to-assistant transfer, each destination requires a transfer condition. A pre-announcement is optional and the full conversation is passed to the destination assistant. Transfer chains are supported.

Configure assistant transfers with PATCH /assistants/{assistantId}/runtime/hangup. The target requires a non-empty condition in description:

{
  "enableTransferAgent": true,
  "transferAgentNotificationText": "I will transfer you to the appropriate team.",
  "availableAgents": [{
    "assistantApiKey": "<TARGET_ASSISTANT_API_KEY>",
    "description": "Transfer when the caller asks for billing."
  }]
}

Omitted fields retain their current values. Sending enableTransferAgent: false clears the transfer notification and all destinations. Validate configuration on a non-production number before enabling live traffic.