Transfer a call with inline NCCO
A code snippet that shows how to transfer control of the current call to control using inline NCCO.
Example
Replace the following variables in the example code:
| Key | Description |
|---|---|
VOICE_CALL_ID | The UUID of the call leg. |
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-inline-ncco.js and add the following code:
const { Vonage } = require('@vonage/server-sdk');
const vonage = new Vonage({
applicationId: VONAGE_APPLICATION_ID,
privateKey: VONAGE_PRIVATE_KEY,
});Write the code
Add the following to transfer-a-call-inline-ncco.js:
vonage.voice.transferCallWithNCCO(VOICE_CALL_ID, {
action: 'transfer',
destination: {
'type': 'ncco',
'ncco': [
{
'action': 'talk',
'text': 'This is a transfer action using an inline NCCO',
},
],
},
})
.then(() => console.log('Call Transferred'))
.catch((error) => console.error(error));Run your code
Save this file to your machine and run it:
Prerequisites
Add the following to build.gradle:
Create a file named TransferCallWithNcco and add the following code to the main method:
Write the code
Add the following to the main method of the TransferCallWithNcco file:
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:
Run the following gradle command to execute your application, replacing com.vonage.quickstart.kt.voice with the package containing TransferCallWithNcco:
Prerequisites
Add the following to build.gradle:
Create a file named TransferCallNCCO and add the following code to the main method:
VonageClient client = VonageClient.builder()
.applicationId(VONAGE_APPLICATION_ID)
.privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
.build();Write the code
Add the following to the main method of the TransferCallNCCO file:
TalkAction talkAction = TalkAction.builder("This is a transfer action using an inline NCCO.").build();
client.getVoiceClient().transferCall(VOICE_CALL_ID, new Ncco(talkAction));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:
Run the following gradle command to execute your application, replacing com.vonage.quickstart.voice with the package containing TransferCallNCCO:
Prerequisites
Prerequisites
Write the code
Add the following to index.php:
require_once __DIR__ . '/../../config.php';
require_once __DIR__ . '/../../vendor/autoload.php';
$keypair = new \Vonage\Client\Credentials\Keypair(file_get_contents(VONAGE_APPLICATION_PRIVATE_KEY_PATH), VONAGE_APPLICATION_ID);
$client = new \Vonage\Client($keypair);
if (count($argv) != 2) {
error_log("You must supply a UUID of currently connected call to update");
exit(1);
}
define('UUID', $argv[1]);
try {
$call = $client->voice()->get(UUID);
$ncco = new \Vonage\Voice\NCCO\NCCO();
$ncco->addAction(new \Vonage\Voice\NCCO\Action\Talk('This call was transferred'));
$client->voice()->transferCall(
$call->getUuid(),
new \Vonage\Voice\NCCO\Action\Transfer($ncco)
);
} catch (\Vonage\Client\Exception\Request $e) {
error_log("Client error: " . $e->getMessage());
exit(1);
} catch (\Vonage\Client\Exception\Server $e) {
error_log("Server error: " . $e->getMessage());
exit(1);
}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:
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.