Compre um número

Você precisa adquirir um serviço da Vonage número virtual se você quiser:

  • Fazer ou receber chamadas telefônicas com o Voice API
  • Receba SMS recebidas com o SMS API
  • Utilize mensagens multicanais com o Messages API

Esta página mostra como comprar um número por meio de programação.

Você também pode cancelar um número pela internet, usando o painel do desenvolvedor ou pela linha de comando, usando o CLI da Vonage.

Substitua as seguintes variáveis no código de exemplo pelos seus próprios valores:

ChaveDescrição
VONAGE_API_KEY

Your Vonage API key (see it on your dashboard).

VONAGE_API_SECRET

Your Vonage API secret (also available on your dashboard).

COUNTRY_CODE

The two digit country code for the number. For example: GB for the United Kingdom

VONAGE_NUMBER

Your Vonage Number. E.g. 447700900000

Escreva o código

Adicione o seguinte ao arquivo ` buy-number.sh`:

curl -X POST \
  -u "${VONAGE_API_KEY}:${VONAGE_API_SECRET}" \
  "https://rest.nexmo.com/number/buy" \
  -H "Content-Type: application/x-www-form-urlencoded" \

Ver código-fonte completo

Execute seu código

Salve este arquivo no seu computador e execute-o:

sh buy-number.sh

Pré-requisitos

npm install @vonage/server-sdk

Crie um arquivo chamado ` buy-number.js ` e insira o seguinte código:

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

const vonage = new Vonage({
  apiKey: VONAGE_API_KEY,
  apiSecret: VONAGE_API_SECRET,
});

Ver código-fonte completo

Escreva o código

Adicione o seguinte ao arquivo ` buy-number.js`:

vonage.number.buyNumber({
  country: COUNTRY_CODE,
  msisdn: VONAGE_NUMBER,
})
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

Ver código-fonte completo

Execute seu código

Salve este arquivo no seu computador e execute-o:

node buy-number.js

Pré-requisitos

Adicione o seguinte ao arquivo ` build.gradle`:

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

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

val client = Vonage {
    apiKey(VONAGE_API_KEY)
    apiSecret(VONAGE_API_SECRET)
}

Ver código-fonte completo

Escreva o código

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

client.numbers.number(NUMBER_COUNTRY_CODE, NUMBER_MSISDN).buy()

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.numbers ` pelo pacote que contém ` BuyNumber`:

gradle run -Pmain=com.vonage.quickstart.kt.numbers.BuyNumber

Pré-requisitos

Adicione o seguinte ao arquivo ` build.gradle`:

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

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

VonageClient client = VonageClient.builder()
        .apiKey(VONAGE_API_KEY)
        .apiSecret(VONAGE_API_SECRET)
        .build();

Ver código-fonte completo

Escreva o código

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

client.getNumbersClient().buyNumber(NUMBER_COUNTRY_CODE, NUMBER_MSISDN);

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.numbers ` pelo pacote que contém ` BuyNumber`:

gradle run -Pmain=com.vonage.quickstart.numbers.BuyNumber

Pré-requisitos

Install-Package Vonage

Crie um arquivo chamado ` BuyNumber.cs ` e insira o seguinte código:

using Vonage;
using Vonage.Numbers;
using Vonage.Request;

Ver código-fonte completo

Adicione o seguinte ao arquivo ` BuyNumber.cs`:


var credentials = Credentials.FromApiKeyAndSecret(vonageApiKey, vonageApiSecret);

Ver código-fonte completo

Escreva o código

Adicione o seguinte ao arquivo ` BuyNumber.cs`:


var request = new NumberTransactionRequest() { Country = countryCode, Msisdn = vonageNumber };

Ver código-fonte completo

Pré-requisitos

composer require vonage/client

Crie um arquivo chamado ` purchase.php ` e insira o seguinte código:

$basic = new \Vonage\Client\Credentials\Basic(VONAGE_API_KEY, VONAGE_API_SECRET);
$client = new \Vonage\Client($basic);

Ver código-fonte completo

Escreva o código

Adicione o seguinte ao arquivo ` purchase.php`:

try {
    $client->numbers()->purchase(VONAGE_NUMBER, COUNTRY_CODE);
    echo "Number purchased";
} catch (Exception $e) {
    echo "Error purchasing number";
}

Ver código-fonte completo

Execute seu código

Salve este arquivo no seu computador e execute-o:

php purchase.php

Pré-requisitos

pip install vonage python-dotenv

Escreva o código

Adicione o seguinte ao arquivo ` buy.py`:

from vonage import Auth, Vonage
from vonage_numbers import NumberParams, NumbersStatus

client = Vonage(Auth(api_key=VONAGE_API_KEY, api_secret=VONAGE_API_SECRET))

status: NumbersStatus = client.numbers.buy_number(
    params=NumberParams(
        country=NUMBER_COUNTRY_CODE,
        msisdn=NUMBER_MSISDN,
    )
)

print(status.model_dump())

Ver código-fonte completo

Execute seu código

Salve este arquivo no seu computador e execute-o:

python numbers/buy.py

Pré-requisitos

gem install vonage

Crie um arquivo chamado ` buy.rb ` e insira o seguinte código:

client = Vonage::Client.new(
  api_key: VONAGE_API_KEY,
  api_secret: VONAGE_API_SECRET
)

Ver código-fonte completo

Escreva o código

Adicione o seguinte ao arquivo ` buy.rb`:

response = client.numbers.buy(
  country: COUNTRY_CODE,
  msisdn: VONAGE_NUMBER
)

Ver código-fonte completo

Execute seu código

Salve este arquivo no seu computador e execute-o:

ruby buy.rb

Veja também