JavaScript

前提条件の設定

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

スマートナンバーを使用するには、アカウントでスマートナンバーアドオンを有効にする必要があります：

訪問 VBC管理ポータルでログインする。
ナビゲーションメニューから ストア > アドオン.
スマート」を検索してアドオンのリストを絞り込む：
クリック追加をクリックしてスマートナンバーを買い物かごに追加してください。
定期的な月額料金に注意し チェックアウト.
について ご注文プレビュー ページでAccountの支払い方法をVerifyし、次のボタンをクリックします。 注文を送信する.

これでスマートナンバーが有効になりました。次のステップは Nexmo音声アプリケーションの作成.

作成するSmart Numbersアプリケーションは、すべてNexmo Voiceアプリケーションと関連付ける必要があります。

注:混乱を避けるため、 Application ここではNexmo Applicationsを指します。あなたが構築しているアプリケーションは「アプリケーション」と呼ばれます。

Nexmoアプリケーションは、アプリケーションが使用するスマートナンバーやWebhookコールバックURLの詳細などの設定情報を保存します。VBCスマートナンバーコールをNexmoでゼロレート化するには、アプリケーションを vbc そして voice を使用する。 NexmoアプリケーションAPI.

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

スマートナンバーを操作するためのNexmo Applicationsを作成するには、次のコマンドを実行します。 curl コマンドを次のように置き換えます。 NEXMO_API_KEY そして NEXMO_API_SECRET をそれぞれNexmo APIキーとシークレットに置き換えてください。この情報は Nexmo開発者ダッシュボード.

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

1つ目は、NexmoのAPIがあなたのスマートナンバーに電話がかかってきたときにリクエストを出すウェブフックです。
もうひとつは、NexmoのAPIが、あなたのアプリケーションが興味を持ちそうなイベント（例えば、通話が応答されたとか終了したとか）の詳細を投稿する場所である。

curl -X POST \ https://api.nexmo.com/v2/applications \ -H 'Authorization: Basic Base64($NEXMO_API_KEY:$NEXMO_API_SECRET)' \ -H 'Content-Type: application/json' \ -d '{ "name": "My Nexmo 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" } } } } }'

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

{
  "id": "27aa0583-7246-4822-aabb-17b03c25d52e",
  "name": "My Nexmo 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"
    }
  }
}

次のステップはスマート・ナンバーズの提供 Nexmoアプリケーションを使用して id.

VBCアカウントでSmart Numbersアドオンを有効にし、Nexmo Voice APIアプリケーションを作成したら、Smart Numbersサービスをプロビジョニングする準備が整いました。どの番号を使用するかを選択し、Nexmo Voice APIアプリケーションに関連付けます。

サインイン VBC管理ポータル
左側のナビゲーション・メニューで ビジネスアプリケーション > Smart Numbers というメニューがある。

注:が表示されない場合は スマート・ナンバーズ メニュー・オプションを選択する必要があります。アドオンを有効にする.
表の各行はスマート・ナンバーを参照しています。未設定のスマート・ナンバーをクリックして編集します。
について スマートナンバー・サービスの編集 ページを参照されたい：
サービス名を入力します。
Nexmo Voice APIアプリケーションにアクセスするために呼び出す直通ダイヤルの番号を少なくとも1つ選択します。
Nexmo Voice APIを貼り付けます。 application_id.
を確認する。 スマートナンバーステータススイッチ に設定されている。 アクティブ.
をクリックする。 セーブ ボタンをクリックする。