Voice APIを使い始める

このページでは、Vonage Voice APIを利用するために必要な手順を説明します。

前提条件

始める前に、以下のものが必要です：

Vonageアカウントの作成

当社のAPIを使用するには、次のものが必要です。アカウント登録.これでAPIキーとシークレットが発行され、APIにアクセスできるようになります。

Voice APIを使って音声通話ができます。テスト番号を使う 123456789 として発信者番号通知をクリックし、サインアップ時に入力した番号にお電話ください。この機能は、アカウントにクレジットを追加するまで、デモまたはトライアルアカウントでのみご利用いただけます。

Voice APIを試す

その後 Vonage APIアカウントへのサインアップにアクセスする。開発者ダッシュボードに移動する。音声通話をするセクションをご覧ください。ここでは、Voice APIの動作を確認するためのテストコールを行うことができます。

アプリケーションでVoice APIを使用する方法を学びましょう。

アプリケーションの作成

に行く。アプリケーションのページをダッシュボードに表示し Name あなたのApplicationsのために。

をクリックしてください。 公開鍵と秘密鍵の生成 ボタンをクリックし、ファイル private.key のあたりだ。

次に声ケイパビリティを持つ。当面は、すべてデフォルトのままにしておいてください。

An example of enabling Voice capabilities

最後に 新規アプリケーションの作成 ページの一番下にある

チェックアウト Vonage CLIを始める CLIのインストールと設定方法の詳細については、こちらを参照してください。

Vonageアプリケーションを作成するには、次のコマンドを使用します：

アプリケーションができたら、次に voice WebhookのURLを自分のものに置き換えてください：

アプリケーションはその後作成され、必要な機能を持ちます。アプリケーションの作成とアプリケーション機能の追加については申請書類.

番号を借りる

番号を借りるには、まず以下の手続きが必要です。アカウントにクレジットを追加する.

テスト番号を使用する場合は、この手順を省略できます。 123456789 として発信者番号通知をクリックし、サインアップの際に入力した番号にお電話ください。

ダッシュボードでナンバーズを買うページをご覧ください。必ず声を検索フィルターに入力し、番号を購入したい国を選択してください。国によっては、追加の書類が必要な場合があるため、番号をリクエストする必要があります。

をクリックします。購入ボタンをクリックし、購入手続きを行ってください。

おめでとうございます！あなたのバーチャルナンバーがあなたのナンバーズ.

アウトバウンドコールをかける

Vonage API音声プラットフォームとの主なやり取りは、以下の方法で行います。パブリックAPI.アウトバウンドコールをかけるには POST リクエスト https://api.nexmo.com/v1/calls.

Voice APIを使って最初の通話を行うには、以下から言語を選択し、サンプルコードの以下の変数を置き換えてください：

キー	説明
`VONAGE_NUMBER`	発信元のVonage番号。例 `447700900000`.をスキップした場合番号を借りるステップでは、テスト番号「123456789」を使用します。
`TO_NUMBER`	E.164形式で発信したい番号。例 `447700900001`.をスキップした場合番号を借りるステップでは、サインアップ時に入力した Numbers を使用します。

Prerequisites

Execute the following command at your terminal prompt to create the JWT for authentication:

Write the code

Add the following to make-an-outbound-call.sh:

View full source

Run your code

Save this file to your machine and run it:

bash make-an-outbound-call.sh

Prerequisites

Create a file named make-an-outbound-call.js and add the following code:

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

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

View full source

Write the code

Add the following to make-an-outbound-call.js:

vonage.voice.createOutboundCall({
  to: [
    {
      type: 'phone',
      number: VOICE_TO_NUMBER,
    },
  ],
  from: {
    type: 'phone',
    number: VONAGE_VIRTUAL_NUMBER,
  },
  answer_url: [VOICE_ANSWER_URL],
})
  .then((resp) => console.log(resp))
  .catch((error) => console.error(error));

View full source

Run your code

Save this file to your machine and run it:

node make-an-outbound-call.js

Prerequisites

Add the following to build.gradle:

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

Create a class named OutboundTextToSpeechCall and add the following code to the main method:

View full source

Write the code

Add the following to the main method of the OutboundTextToSpeechCall class:

View full source

Run your code

We can use the アプリケーション 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 OutboundTextToSpeechCall:

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

Prerequisites

Add the following to build.gradle:

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

Create a class named OutboundTextToSpeech and add the following code to the main method:

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

View full source

Write the code

Add the following to the main method of the OutboundTextToSpeech class:

client.getVoiceClient().createCall(new Call(VOICE_TO_NUMBER, VONAGE_VIRTUAL_NUMBER, VOICE_ANSWER_URL));

View full source

Run your code

We can use the アプリケーション 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 OutboundTextToSpeech:

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

Prerequisites

Write the code

Add the following to MakeOutboundCall.cs:

View full source

Prerequisites

Write the code

Add the following to text-to-speech-outbound.php:

require_once __DIR__ . '/../config.php';
require_once __DIR__ . '/../vendor/autoload.php';

// Building Blocks
// 1. Make a Phone Call
// 2. Play Text-to-Speech

$keypair = new \Vonage\Client\Credentials\Keypair(
    file_get_contents(VONAGE_APPLICATION_PRIVATE_KEY_PATH),
    VONAGE_APPLICATION_ID
);
$client = new \Vonage\Client($keypair);

$outboundCall = new \Vonage\Voice\OutboundCall(
    new \Vonage\Voice\Endpoint\Phone(TO_NUMBER),
    new \Vonage\Voice\Endpoint\Phone(VONAGE_NUMBER)
);
$outboundCall->setAnswerWebhook(
    new \Vonage\Voice\Webhook(
        'https://raw.githubusercontent.com/nexmo-community/ncco-examples/gh-pages/text-to-speech.json',
        \Vonage\Voice\Webhook::METHOD_GET
    )
);
$response = $client->voice()->createOutboundCall($outboundCall);

var_dump($response);

View full source

Run your code

Save this file to your machine and run it:

php text-to-speech-outbound.php

Prerequisites

Write the code

Add the following to make-an-outbound-call.py:

View full source

Run your code

Save this file to your machine and run it:

python voice/make-an-outbound-call.py

Prerequisites

Write the code

Add the following to outbound_tts_call.rb:

View full source

Run your code

Save this file to your machine and run it:

ruby outbound_tts_call.rb

これを容易にするために、Vonageは以下を提供します。サーバーSDK 認証や正しいリクエストボディの作成は、さまざまな言語で行われている。

次はどうする？

最初の通話ができたら、Voice APIの他の面も試してみましょう。まずは技術詳細のページでVonage Voice APIの包括的な概要をご覧ください。様々なコールフローを理解するには通話フローガイドを参照してください。基本的な音声通知アプリケーションの作成に興味がある場合は、以下のガイドを参照してください。音声通知ハウツーガイド詳しくはVoice APIのドキュメントをご覧ください。