前提条件の設定
このチュートリアルを始める前に、いくつかの前提条件をクリアしておく必要があります。すでに完了している場合は、このステップをスキップしてください。
Nexmo CLIを使用すると、コマンドラインで多くの操作を実行できます。例としては、アプリケーションの作成、番号の購入、アプリケーションへの番号のリンクなどがあります。
NPMでnexmo CLIをインストールするには、以下を使用できます:
Vonage APIキーと APIシークレットを使用するようにNexmo CLIを設定します。これらは、Vonage Dashboardの設定ページから取得できます。
ターミナルで次のコマンドを実行し、api_keyとapi_secretを独自のものに置き換えます:
Webhookをパブリックインターネット経由でVonageのAPIにアクセスできるようにする必要があります。開発中に独自のサーバーを起動せずにこれを達成する簡単な方法は、Ngrokを使用することです。詳細については、Ngrokに関するドキュメントをお読みください。
Ngrokをダウンロードしてインストールし、次のコマンドを実行して、ポート3000におけるアプリケーションをパブリックインターネットに公開します:
有料会員の場合、次のように入力できます:
注: この例では、NgrokはVonageアプリケーションの作成時に指定したVonage Webhookをlocalhost:3000に迂回させます。ここではポート3000が表示されていますが、ご都合に合わせて任意の空きポートを使用できます。
音声アプリケーションを作成するには、次の2つの方法があります:
- Nexmo CLI を使用する
- Dashboardを使用する
これらの各方法については、以降のセクションで説明します。
Nexmo CLIを使用して音声アプリケーションを作成する方法
Nexmo CLIを使用してアプリケーションを作成するには、次のコマンドをシェルに入力し、Ngrokを設定したときに取得したNgrokホストでNGROK_HOST_NAMEを置き換えます:
このコマンドは、音声機能を持つVonageアプリケーションを作成します。応答とイベントのWebhook URLを使用してアプリケーションを設定し、秘密鍵ファイルprivate.keyを生成します。このファイルはプロジェクトディレクトリに保存する必要があります。
このコマンドは、一意のアプリケーションIDを返します。このアプリケーションIDを使用して、以下を実行して、Vonage仮想番号をアプリケーションにリンクします:
これにより、そのVonage仮想番号がアプリケーションにリンクされ、その番号で発生したすべての音声イベントが指定されたURLにルーティングされます。
Dashboardを使用して音声アプリケーションを作成する方法
音声アプリケーションは、Dashboardで作成できます。
Dashboardを使用してアプリケーションを作成するには、次の手順に従います:
Dashboardのアプリケーションで、 [Create a new application (新しいアプリケーションの作成)] ボタンをクリックします。
[Name (名前)] に、アプリケーション名を入力します。後で参照しやすくするために、名前を選択してください。
[Generate public and private key (公開鍵と秘密鍵を生成)] ボタンをクリックします。これにより、公開鍵と秘密鍵のペアが作成され、秘密鍵がブラウザによってダウンロードされます。生成された秘密鍵を保存します。
[Capabilities (機能)] で [Voice (音声)] ボタンを選択します。
[Answer URL (応答URL)] ボックスに、着信通話WebhookのURL(
http://example.com/webhooks/answerなど)を入力します。[Event URL (イベントURL)] ボックスに、通話ステータスWebhookのURL(
http://example.com/webhooks/eventsなど)を入力します。[Generate new application (新しいアプリケーションの生成)] ボタンをクリックします。
これで、アプリケーションの作成手順の次の手順に進みます。ここで、Vonage番号をアプリケーションにリンクします。
これでアプリケーションが作成されました。
注: アプリケーションをテストする前に、Webhookが設定され、Webhookサーバーが実行されていることを確認してください。
.NETでボイスメールを作成する方法
.NETで着信通話を記録するアプリを作成する方法を説明するチュートリアル