.NET

前提条件の設定

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

でVonageアカウントを作成できます。 ダッシュボード.

ダッシュボードでは、アプリケーションの作成やVonage Numbersの購入ができます。また Vonage CLI.

の手順に従ってください。 Vonage CLIを始める ページで コマンドラインをインストールして設定する。

あなたのWebhookは、公共のインターネットを介してVonageのAPIにアクセスできるようにする必要があります。開発中に独自のサーバを立ち上げることなくこれを実現する簡単な方法は ングロク.もっと詳しく知りたい方は、 Ngrokに関するドキュメントを読む.

ngrokをダウンロードしてインストールし、以下のコマンドを実行して、ポート3000のアプリケーションをパブリック・インターネットに公開する：

./ngrok http 3000

もしあなたが有料会員なら、このように入力できる：

./ngrok http 3000 -subdomain=your_domain

注： この例では、Ngrok は Vonage アプリケーションを作成したときに指定した Vonage ウェブフックを次のように転送します。 localhost:3000.ここでは3000番ポートを示しているが、都合の良い空いているポートを使うことができる。

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

  1. Vonage CLIの使用
  2. ダッシュボードの使用

それぞれの方法については、以下のセクションで説明する。

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にルーティングされます。

ダッシュボードを使用して音声アプリケーションを作成する方法

で音声アプリケーションを作成できます。 ダッシュボード.

ダッシュボードを使用してアプリケーションを作成します：

  1. アンダー Applications をクリックします。 新規アプリケーションの作成 ボタンをクリックする。

  2. アンダー 名称アプリケーション名を入力します。後で参照しやすいように名前を決めてください。

  3. ボタンをクリックする 公開鍵と秘密鍵の生成.これで公開鍵と秘密鍵のペアが作成され、秘密鍵はブラウザからダウンロードされます。 秘密鍵はブラウザからダウンロードされます。生成された秘密鍵を保存します。

  4. アンダー 能力 を選択する。 声 ボタンをクリックする。

  5. の中で 回答URL ボックスに、着信コールのWebhookのURLを入力します、 http://example.com/webhooks/answer.

  6. の中で イベントURL ボックスに、コール・ステータスWebhookのURLを入力します、 http://example.com/webhooks/events.

  7. をクリックする。 新規アプリケーションの作成 ボタンをクリックする。

  8. アプリケーションの作成手順の次のステップに進みます。 アプリケーションにリンクします。

これでアプリケーションの作成は完了です。

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

.NETで通話中に音声を再生する

PSTN通話に音声を流すアプリの作り方を紹介するチュートリアル

以下の言語で利用可能:
.NET Ruby
手順
1
このチュートリアルの紹介
2
Prerequisites
3
.NET 音声アプリケーションの作成
4
Vonageドットネットをインストールする
5
音声コントローラーの追加
6
メイク・コール・アクションの追加
7
着信ルートを追加する
8
ボイスビューの追加
9
スタートアップ・ルートの設定
10
ASP.NETアプリの設定
11
.NETアプリの実行
12
次はどうする？