前提条件の設定
このチュートリアルを始める前に、いくつかの前提条件をクリアしておく必要があります。すでに完了している場合は、このステップをスキップしてください。
でVonageアカウントを作成できます。 ダッシュボード.
ダッシュボードでは、アプリケーションの作成やVonage Numbersの購入ができます。また Vonage CLI.
の手順に従ってください。 Vonage CLIを始める ページで コマンドラインをインストールして設定する。
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 apps capabilities update 00000000-0000-0000-0000-000000000000 voice ^
--voice-answer-url='https://example.com/webhooks/voice/answer' ^
--voice-event-url='https://example.com/webhooks/voice/event' ^
--voice-fallback-url='https://example.com/webhooks/voice/fallback'
✅ Fetching Application
✅ Adding voice capability to application 00000000-0000-0000-0000-000000000000
Name: Your application
Application ID: 00000000-0000-0000-0000-000000000000
Improve AI: Off
Private/Public Key: Set
Capabilities:
VOICE:
Uses Signed callbacks: On
Conversation TTL: 41 hours
Leg Persistence Time: 6 days
Event URL: [POST] https://example.com/webhooks/voice/event
Answer URL: [POST] https://example.com/webhooks/voice/answer
Fallback URL: [POST] https://example.com/webhooks/voice/fallback
このコマンドは、音声付きVonageアプリケーションを作成します。 能力.それは
アプリケーションにアンサーとイベントのウェブフックURLを設定し、秘密鍵ファイルを生成します。 private.key,
をプロジェクト・ディレクトリに保存する。
コマンドは一意のアプリケーションIDを返します。このアプリケーションIDを使用して、次のコマンドを実行してVonageバーチャル番号をアプリケーションにリンクします。 アプリケーションにリンクするために使用します:
vonage apps numbers link 00000000-0000-0000-0000-000000000000 16127779311
✅ Fetching Application
Fetching Owned numbers [===============================================] 1/1 100%
Number linked
Number: 16127779311
Country: 🇺🇸 United States
Type: Toll-free
Features: MMS, SMS, VOICE
Monthly Cost: Not Set
Setup Cost: Not Set
Linked Application ID: 00000000-0000-0000-0000-000000000000
Voice Callback: app
Voice Callback Value: 00000000-0000-0000-0000-000000000000
Voice Status Callback: Not Set
これにより、Vonage Virtual Numberがアプリケーションにリンクされ、その番号で発生するすべての音声イベントが指定したURLにルーティングされます。 その番号で発生したすべての音声イベントは、指定したURLにルーティングされます。
ダッシュボードを使用して音声アプリケーションを作成する方法
で音声アプリケーションを作成できます。 ダッシュボード.
ダッシュボードを使用してアプリケーションを作成します:
アンダー Applications をクリックします。 新規アプリケーションの作成 ボタンをクリックする。
アンダー 名称アプリケーション名を入力します。後で参照しやすいように名前を決めてください。
ボタンをクリックする 公開鍵と秘密鍵の生成.これで公開鍵と秘密鍵のペアが作成され、秘密鍵はブラウザからダウンロードされます。 秘密鍵はブラウザからダウンロードされます。生成された秘密鍵を保存します。
アンダー 能力 を選択する。 声 ボタンをクリックする。
の中で 回答URL ボックスに、着信コールのWebhookのURLを入力します、
http://example.com/webhooks/answer.の中で イベントURL ボックスに、コール・ステータスWebhookのURLを入力します、
http://example.com/webhooks/events.をクリックする。 新規アプリケーションの作成 ボタンをクリックする。
アプリケーションの作成手順の次のステップに進みます。 アプリケーションにリンクします。
これでアプリケーションの作成は完了です。
注: アプリケーションをテストする前に、Webhookが設定され、Webhookサーバーが動作していることを確認してください。
ダッシュボードの使用
まず、以下をご覧ください。 既存の Numbers.
予備のNumbersがない場合は、以下の方法がある。 買う.
Vonage CLIの使用
納得のいく番号が見つかったら、その番号を vonage numbers buy コマンドを使用している:
vonage numbers buy US 16127779311
✅ Searching for numbers
Are you sure you want to purchase the number 16127779311 for €0.90? [y/n] y
✅ Purchasing number
Number 16127779311 purchased
Number: 16127779311
Country: 🇺🇸 United States
Type: Mobile
Features: MMS, SMS, VOICE
Monthly Cost: €0.90
Setup Cost: €0.00
Linked Application ID: Not linked to any application
Voice Callback: Not Set
Voice Callback Value: Not Set
Voice Status Callback: Not Set
ダッシュボードの使用
- でアプリケーションを検索します。 ダッシュボード.
- Your Applications "リストでアプリケーションをクリックします。次にNumbersタブをクリックします。
- Vonage番号とアプリケーションをリンクするには、[リンク]ボタンをクリックします。
Vonage CLIの使用
適当な番号が決まったら、Vonageアプリケーションとリンクさせることができます。
vonage apps numbers link 00000000-0000-0000-0000-000000000000 16127779311
✅ Fetching Application
Fetching Owned numbers [===============================================] 1/1 100%
Number linked
Number: 16127779311
Country: 🇺🇸 United States
Type: Toll-free
Features: MMS, SMS, VOICE
Monthly Cost: Not Set
Setup Cost: Not Set
Linked Application ID: 00000000-0000-0000-0000-000000000000
Voice Callback: app
Voice Callback Value: 00000000-0000-0000-0000-000000000000
Voice Status Callback: Not Set
あなたのWebhookは、公共のインターネットを介してVonageのAPIにアクセスできるようにする必要があります。開発中に独自のサーバを立ち上げることなくこれを実現する簡単な方法は ングロク.もっと詳しく知りたい方は、 Ngrokに関するドキュメントを読む.
ngrokをダウンロードしてインストールし、以下のコマンドを実行して、ポート3000のアプリケーションをパブリック・インターネットに公開する:
もしあなたが有料会員なら、このように入力できる:
注: この例では、Ngrok は Vonage アプリケーションを作成したときに指定した Vonage ウェブフックを次のように転送します。 localhost:3000.ここでは3000番ポートを示しているが、都合の良い空いているポートを使うことができる。
コールメニューの作成
顧客からの電話に対応するための音声自動応答(IVR)メニューの作成