Transfer a call
A code snippet that shows how to transfer control of the current call to control by a new NCCO.
Example
Replace the following variables in the example code:
| Key | Description |
|---|---|
VOICE_CALL_ID | The UUID of the call leg. |
VOICE_NCCO_URL | The URL of the NCCO to execute. URLs must be array type. |
Prerequisites
Execute the following command at your terminal prompt to create the JWT for authentication:
Run your code
Save this file to your machine and run it:
Prerequisites
Create a file named transfer-a-call.js and add the following code:
Run your code
Save this file to your machine and run it:
Prerequisites
Add the following to build.gradle:
implementation 'com.vonage:server-sdk-kotlin:2.1.1'Create a class named TransferCall and add the following code to the main method:
Run your code
We can use the application plugin for Gradle to simplify the running of our application. Update your build.gradle with the following:
apply plugin: 'application'
mainClassName = project.hasProperty('main') ? project.getProperty('main') : ''Run the following gradle command to execute your application, replacing com.vonage.quickstart.kt.voice with the package containing TransferCall:
Prerequisites
Add the following to build.gradle:
implementation 'com.vonage:server-sdk:9.3.1'Create a class named TransferCall and add the following code to the main method:
Run your code
We can use the application plugin for Gradle to simplify the running of our application. Update your build.gradle with the following:
apply plugin: 'application'
mainClassName = project.hasProperty('main') ? project.getProperty('main') : ''Run the following gradle command to execute your application, replacing com.vonage.quickstart.voice with the package containing TransferCall:
Prerequisites
Write the code
Add the following to TransferCall.cs:
var credentials = Credentials.FromAppIdAndPrivateKeyPath(VONAGE_APPLICATION_ID, VONAGE_PRIVATE_KEY_PATH);
var client = new VonageClient(credentials);
var callEditCommand = new CallEditCommand()
{
Action = CallEditCommand.ActionType.transfer,
Destination = new Destination()
{
Url = new[] { VOICE_NCCO_URL }
}
};
var response = await client.VoiceClient.UpdateCallAsync(VOICE_CALL_ID, callEditCommand);Prerequisites
Run your code
Save this file to your machine and run it:
Prerequisites
Write the code
Add the following to transfer-a-call.py:
from vonage import Auth, Vonage
client = Vonage(
Auth(
application_id=VONAGE_APPLICATION_ID,
private_key=VONAGE_PRIVATE_KEY,
)
)
client.voice.transfer_call_answer_url(VOICE_CALL_ID, VOICE_NCCO_URL)Run your code
Save this file to your machine and run it:
Prerequisites
Run your code
Save this file to your machine and run it:
Try it out
You will need to:
- Set up a call and obtain the call UUID. You could use the 'connect an inbound call' code snippet to do this.
- Run the example code to transfer the call.
- Control will be transferred to a new NCCO, and you will hear a text-to-speech message to confirm this.
Further Reading
- Conference Calling - This guide explains the two concepts Vonage associates with a call, a leg and a conversation.