Call transfer

Call transfer moves an active leg into a new conversation context. In client callbacks, callId remains stable while conversationId changes.

Common use cases include contact center routing and IVR handoff to agents.

Client transfer event — onCallTransfer

    client.setCallTransferListener { call, conversationId ->
        println("Received Call Transfer for call: $call  into the conversation: $conversationId")
    }
}

State expectations

• callId: unchanged
• conversationId: updated to destination conversation
• media session: continues through transfer flow

Transfer NCCO

INFO

The example below illustrates the required NCCO structure. Your actual implementation will vary based on your backend language and framework.

const transferNcco = [
  {
    action: 'transfer',
    conversation_id: 'CON-destination-conversation-id'
  }
];

res.json(transferNcco);

Reference: NCCO transfer action