Transferir uma chamada

Um trecho de código que mostra como transferir o controle da chamada atual para um novo NCCO.

Exemplo

Substitua as seguintes variáveis no código de exemplo:

Chave	Descrição
`VOICE_CALL_ID`	The UUID of the call leg.
`VOICE_NCCO_URL`	The URL of the NCCO to execute. URLs must be array type.

Pré-requisitos

Execute o seguinte comando no prompt do terminal para criar o arquivo ` JWT ` para autenticação:

export JWT=$(nexmo jwt:generate $PATH_TO_PRIVATE_KEY application_id=$NEXMO_APPLICATION_ID)

Escreva o código

Adicione o seguinte ao arquivo ` transfer-a-call.sh`:

curl -X PUT https://api.nexmo.com/v1/calls/$VOICE_CALL_ID \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json"\
  -d '{"action": "transfer",
      "destination": {"type": "ncco", "url": ["'"$VOICE_NCCO_URL"'"]}}'

Ver código-fonte completo

Execute seu código

Salve este arquivo no seu computador e execute-o:

bash transfer-a-call.sh

Pré-requisitos

npm install @vonage/server-sdk

Crie um arquivo chamado ` transfer-a-call.js ` e insira o seguinte código:

const { Vonage } = require('@vonage/server-sdk');

const vonage = new Vonage({
  applicationId: VONAGE_APPLICATION_ID,
  privateKey: VONAGE_PRIVATE_KEY,
});

Ver código-fonte completo

Escreva o código

Adicione o seguinte ao arquivo ` transfer-a-call.js`:

vonage.voice.transferCallWithURL(VOICE_CALL_ID, VOICE_NCCO_URL)
  .then(() => console.log(`Call transfered to ${VOICE_NCCO_URL}`))
  .catch((error) => console.error(error));

Ver código-fonte completo

Execute seu código

Salve este arquivo no seu computador e execute-o:

node transfer-a-call.js

Pré-requisitos

Adicione o seguinte ao arquivo ` build.gradle`:

implementation 'com.vonage:server-sdk-kotlin:2.1.1'

Crie um arquivo chamado ` TransferCall ` e adicione o código a seguir ao método ` main `:

val client = Vonage {
    applicationId(VONAGE_APPLICATION_ID)
    privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
}

Ver código-fonte completo

Escreva o código

Adicione o seguinte ao método ` main ` do arquivo ` TransferCall `:

client.voice.call(VOICE_CALL_ID).transfer(VOICE_NCCO_URL)

Ver código-fonte completo

Execute seu código

Podemos usar o plugin “ aplicativo ” para o Gradle a fim de simplificar a execução do nosso aplicativo. Atualize seu arquivo ` build.gradle ` com o seguinte:

apply plugin: 'application'
mainClassName = project.hasProperty('main') ? project.getProperty('main') : ''

Execute o seguinte comando ` gradle ` para rodar seu aplicativo, substituindo ` com.vonage.quickstart.kt.voice ` pelo pacote que contém ` TransferCall`:

gradle run -Pmain=com.vonage.quickstart.kt.voice.TransferCall

Pré-requisitos

Adicione o seguinte ao arquivo ` build.gradle`:

implementation 'com.vonage:server-sdk:9.3.1'

Crie um arquivo chamado ` TransferCall ` e adicione o código a seguir ao método ` main `:

VonageClient client = VonageClient.builder()
        .applicationId(VONAGE_APPLICATION_ID)
        .privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
        .build();

Ver código-fonte completo

Escreva o código

Adicione o seguinte ao método ` main ` do arquivo ` TransferCall `:

client.getVoiceClient().transferCall(VOICE_CALL_ID, VOICE_NCCO_URL);

Ver código-fonte completo

Execute seu código

Podemos usar o plugin “ aplicativo ” para o Gradle a fim de simplificar a execução do nosso aplicativo. Atualize seu arquivo ` build.gradle ` com o seguinte:

apply plugin: 'application'
mainClassName = project.hasProperty('main') ? project.getProperty('main') : ''

Execute o seguinte comando ` gradle ` para rodar seu aplicativo, substituindo ` com.vonage.quickstart.voice ` pelo pacote que contém ` TransferCall`:

gradle run -Pmain=com.vonage.quickstart.voice.TransferCall

Pré-requisitos

Install-Package Vonage

Escreva o código

Adicione o seguinte ao arquivo ` 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);

Ver código-fonte completo

Pré-requisitos

composer require vonage/client

Escreva o código

Adicione o seguinte ao arquivo ` index.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);

$call = $client->voice()->get(UUID);
$client->voice()->transferCall(
    $call->getUuid(),
    new \Vonage\Voice\NCCO\Action\Transfer("https://raw.githubusercontent.com/nexmo-community/ncco-examples/gh-pages/transfer.json")
);

Ver código-fonte completo

Execute seu código

Salve este arquivo no seu computador e execute-o:

php index.php

Pré-requisitos

pip install vonage python-dotenv

Escreva o código

Adicione o seguinte ao arquivo ` 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)

Ver código-fonte completo

Execute seu código

Salve este arquivo no seu computador e execute-o:

python voice/transfer-a-call.py

Pré-requisitos

gem install vonage

Escreva o código

Adicione o seguinte ao arquivo ` transfer-a-call.rb`:

client = Vonage::Client.new(
  application_id: VONAGE_APPLICATION_ID,
  private_key: VONAGE_PRIVATE_KEY
)

ncco = {"type": "ncco", "url": [VOICE_NCCO_URL]}

response = client.voice.transfer(VOICE_CALL_ID, destination: ncco)

Ver código-fonte completo

Execute seu código

Salve este arquivo no seu computador e execute-o:

ruby transfer-a-call.rb

Experimente

Você precisará:

Estabeleça uma chamada e obtenha o UUID da chamada. Você pode usar o trecho de código “conectar uma chamada recebida” para fazer isso.
Execute o código de exemplo para transferir a chamada.
O controle será transferido para um novo NCCO, e você ouvirá uma mensagem de conversão de texto em fala para confirmar isso.

Leitura complementar

Teleconferência - Este guia explica os dois Concepts que a Vonage associa a uma chamada: “leg” e “conversação”.