前提条件の設定
このチュートリアルを始める前に、いくつかの前提条件をクリアしておく必要があります。すでに完了している場合は、このステップをスキップしてください。
でVonageアカウントを作成できます。 ダッシュボード.
ダッシュボードでは、アプリケーションの作成やVonage Numbersの購入ができます。また Vonage CLI.
の手順に従ってください。 Vonage CLIを始める ページで コマンドラインをインストールして設定する。
あなたのWebhookは、公共のインターネットを介してVonageのAPIにアクセスできるようにする必要があります。開発中に独自のサーバを立ち上げることなくこれを実現する簡単な方法は ングロク.もっと詳しく知りたい方は、 Ngrokに関するドキュメントを読む.
ngrokをダウンロードしてインストールし、以下のコマンドを実行して、ポート3000のアプリケーションをパブリック・インターネットに公開する:
もしあなたが有料会員なら、このように入力できる:
注: この例では、Ngrok は Vonage アプリケーションを作成したときに指定した Vonage ウェブフックを次のように転送します。 localhost:3000.ここでは3000番ポートを示しているが、都合の良い空いているポートを使うことができる。
Voiceアプリケーションを作成するには、2つの方法があります:
- Vonage CLIの使用
- ダッシュボードの使用
それぞれの方法については、以下のセクションで説明する。
Vonage CLIを使用して音声アプリケーションを作成する方法
Vonage CLIを使用してアプリケーションを作成するには、以下のコマンドをシェルに置き換えて入力します。 NGROK_HOST_NAME を、ngrok をセットアップしたときに取得した ngrok ホストと置き換えます:
を使用してアプリケーションを作成します。 Vonage CLI次のコマンドを入力する:
vonage apps create 'Your application'
✅ Creating Application
Saving private key ... Done!
Application created
Name: Your application
Application ID: 00000000-0000-0000-0000-000000000000
Improve AI: Off
Private/Public Key: Set
Capabilities:
None Enabled
次に、アプリケーションに音声機能を追加します。 ngrok の代わりに example.com)
このコマンドは、音声付きVonageアプリケーションを作成します。 能力.それは
アプリケーションにアンサーとイベントのウェブフックURLを設定し、秘密鍵ファイルを生成します。 private.key,
をプロジェクト・ディレクトリに保存する。
コマンドは一意のアプリケーションIDを返します。このアプリケーションIDを使用して、次のコマンドを実行してVonageバーチャル番号をアプリケーションにリンクします。 アプリケーションにリンクするために使用します:
これにより、Vonage Virtual Numberがアプリケーションにリンクされ、その番号で発生するすべての音声イベントが指定したURLにルーティングされます。 その番号で発生したすべての音声イベントは、指定したURLにルーティングされます。
ダッシュボードを使用して音声アプリケーションを作成する方法
で音声アプリケーションを作成できます。 ダッシュボード.
ダッシュボードを使用してアプリケーションを作成します:
アンダー Applications をクリックします。 新規アプリケーションの作成 ボタンをクリックする。
アンダー 名称アプリケーション名を入力します。後で参照しやすいように名前を決めてください。
ボタンをクリックする 公開鍵と秘密鍵の生成.これで公開鍵と秘密鍵のペアが作成され、秘密鍵はブラウザからダウンロードされます。 秘密鍵はブラウザからダウンロードされます。生成された秘密鍵を保存します。
アンダー 能力 を選択する。 声 ボタンをクリックする。
の中で 回答URL ボックスに、着信コールのWebhookのURLを入力します、
http://example.com/webhooks/answer.の中で イベントURL ボックスに、コール・ステータスWebhookのURLを入力します、
http://example.com/webhooks/events.をクリックする。 新規アプリケーションの作成 ボタンをクリックする。
アプリケーションの作成手順の次のステップに進みます。 アプリケーションにリンクします。
これでアプリケーションの作成は完了です。
注: アプリケーションをテストする前に、Webhookが設定され、Webhookサーバーが動作していることを確認してください。
Rubyで通話音声を再生する
PSTN通話に音声を流すアプリの作り方を紹介するチュートリアル