Vonage APIプラットフォームアプリケーションの作成

構築するSmart Numbersアプリケーションはすべて、Vonage API Platform Voiceアプリケーションと関連付ける必要があります。

:混乱を避けるため、 Application ここではVonage API Platform Applicationsを指します。構築するアプリケーションは「アプリケーション」と呼ばれます。

Vonage API Platform Applicationは、アプリケーションが使用するスマートナンバーやWebhookコールバックURLの詳細などの設定情報を保存します。Vonage API PlatformでVBC Smart Numbersコールをゼロレーティングにするには、アプリケーションを vbc そして voice を使用する。 Vonage API プラットフォーム アプリケーション API.

アプリケーションAPIの使用

スマートナンバーを使用するためのVonage APIプラットフォームアプリケーションを作成するには、次のコマンドを実行します。 curl コマンドを次のように置き換えます。 VONAGE_API_KEY そして VONAGE_API_SECRET をそれぞれ Vonage API Platform API キーとシークレットに置き換えてください。この情報は Vonage APIプラットフォーム開発者ダッシュボード.

あなたが提供する2つのURLは、あなたのアプリケーションがVonage API Platformのサーバに公開するWebhookエンドポイントを参照しています:

  • 一つ目は、スマートナンバーに着信があった際にVonage API PlatformのAPIがリクエストを行うWebhookです。
  • もうひとつは、Vonage API PlatformのAPIが、アプリケーションが興味を持ちそうなイベント(例えば、通話が応答されたとか終了したとか)の詳細を投稿する場所である。
curl -X POST \ https://api.nexmo.com/v2/applications \ -H 'Authorization: Basic Base64($VONAGE_API_KEY:$VONAGE_API_SECRET)' \ -H 'Content-Type: application/json' \ -d '{ "name": "My VAPI VBC Application", "capabilities": { "vbc": {}, "voice": { "webhooks": { "answer_url": { "address": "https://example.com/webhooks/answer", "http_method": "POST" }, "event_url": { "address": "https://example.com/webhooks/event", "http_method": "POST" } } } } }'

レスポンスは、Vonage API Platform Applicationsを含むJSONオブジェクトです。 id Vonage API Platform Voice API との対話に使用します。

{
  "id": "27aa0583-7246-4822-aabb-17b03c25d52e",
  "name": "My VAPI VBC Application",
  "keys": {
    "private_key": "-----BEGIN PRIVATE KEY-----\nMIIEvAIBADANBgkq...
    -----END PRIVATE KEY-----\n",
    "public_key": "-----BEGIN PUBLIC_KEY-----\nMIIBIjANBgkqh...
    -----END PUBLIC KEY-----\n"
  },
  "capabilities": {
    "voice": {
      "webhooks": {
        "event_url": {
            "address": "https://example.com/webhooks/event",
            "http_method": "POST"
        },
        "answer_url": {
            "address": "https://example.com/webhooks/answer",
            "http_method": "POST"
        }
      }
    },
    "vbc": {}
  },
  "_links": {
    "self": {
      "href": "/v2/applications/27aa0583-7246-4822-aabb-17b03c25d52e"
    }
  }
}

次のステップは スマート・ナンバーズの提供 Vonage APIプラットフォームアプリケーションの使用 id.