前提条件の設定

このチュートリアルを始める前に、いくつかの前提条件をクリアしておく必要があります。すでに完了している場合は、このステップをスキップしてください。

DashboardからVonageアカウントを作成できます。

Dashboardでは、アプリケーションを作成し、Vonage番号を購入することができます。Nexmo CLIを使用してこれらのタスクを実行することもできます。

Nexmo CLIを使用すると、コマンドラインで多くの操作を実行できます。例としては、アプリケーションの作成、番号の購入、アプリケーションへの番号のリンクなどがあります。

NPMでnexmo CLIをインストールするには、以下を使用できます:

npm install nexmo-cli -g

Vonage APIキーと APIシークレットを使用するようにNexmo CLIを設定します。これらは、Vonage Dashboardの設定ページから取得できます。

ターミナルで次のコマンドを実行し、api_keyapi_secretを独自のものに置き換えます:

nexmo setup API_KEY API_SECRET

Webhookをパブリックインターネット経由でVonageのAPIにアクセスできるようにする必要があります。開発中に独自のサーバーを起動せずにこれを達成する簡単な方法は、Ngrokを使用することです。詳細については、Ngrokに関するドキュメントをお読みください

Ngrokをダウンロードしてインストールし、次のコマンドを実行して、ポート3000におけるアプリケーションをパブリックインターネットに公開します:

./ngrok http 3000

有料会員の場合、次のように入力できます:

./ngrok http 3000 -subdomain=your_domain

注: この例では、NgrokはVonageアプリケーションの作成時に指定したVonage Webhookをlocalhost:3000に迂回させます。ここではポート3000が表示されていますが、ご都合に合わせて任意の空きポートを使用できます。

音声アプリケーションを作成するには、次の2つの方法があります:

  1. Nexmo CLI を使用する
  2. Dashboardを使用する

これらの各方法については、以降のセクションで説明します。

Nexmo CLIを使用して音声アプリケーションを作成する方法

Nexmo CLIを使用してアプリケーションを作成するには、次のコマンドをシェルに入力し、Ngrokを設定したときに取得したNgrokホストでNGROK_HOST_NAMEを置き換えます:

nexmo app:create "AspNetTestApp" http://NGROK_HOST_NAME/webhooks/answer http://NGROK_HOST_NAME/webhooks/events

このコマンドは、音声機能を持つVonageアプリケーションを作成します。応答とイベントのWebhook URLを使用してアプリケーションを設定し、秘密鍵ファイルprivate.keyを生成します。このファイルはプロジェクトディレクトリに保存する必要があります。

このコマンドは、一意のアプリケーションIDを返します。このアプリケーションIDを使用して、以下を実行して、Vonage仮想番号をアプリケーションにリンクします:

nexmo link:app VONAGE_NUMBER APPLICATION_ID

これにより、そのVonage仮想番号がアプリケーションにリンクされ、その番号で発生したすべての音声イベントが指定されたURLにルーティングされます。

Dashboardを使用して音声アプリケーションを作成する方法

音声アプリケーションは、Dashboardで作成できます。

Dashboardを使用してアプリケーションを作成するには、次の手順に従います:

  1. Dashboardのアプリケーションで、 [Create a new application (新しいアプリケーションの作成)] ボタンをクリックします。

  2. [Name (名前)] に、アプリケーション名を入力します。後で参照しやすくするために、名前を選択してください。

  3. [Generate public and private key (公開鍵と秘密鍵を生成)] ボタンをクリックします。これにより、公開鍵と秘密鍵のペアが作成され、秘密鍵がブラウザによってダウンロードされます。生成された秘密鍵を保存します。

  4. [Capabilities (機能)][Voice (音声)] ボタンを選択します。

  5. [Answer URL (応答URL)] ボックスに、着信通話WebhookのURL(http://example.com/webhooks/answerなど)を入力します。

  6. [Event URL (イベントURL)] ボックスに、通話ステータスWebhookのURL(http://example.com/webhooks/eventsなど)を入力します。

  7. [Generate new application (新しいアプリケーションの生成)] ボタンをクリックします。

  8. これで、アプリケーションの作成手順の次の手順に進みます。ここで、Vonage番号をアプリケーションにリンクします。

これでアプリケーションが作成されました。

注: アプリケーションをテストする前に、Webhookが設定され、Webhookサーバーが実行されていることを確認してください。