Numbers

Vonage Voice API を使用する上で、Numbers は重要な概念です。Vonageアプリケーションを開発する前に、以下の点を考慮する必要があります。

フォーマット

Vonage Voice (API または SIP Trunking) 内では、すべての Numbers は E.164 形式です。つまり、Numbers：

  • 先頭の + といった国際アクセスコードを入力する。 00 または 001.
  • スペースなどの特殊文字を含まないこと、 () または -

例えば、米国の番号の場合、次のような形式になります。 14155550101.英国の番号は次のような形式です。 447700900123.

Numbersの書式がわからない場合は Number Insight API を使えば、Numbersに関する正しい情報を見つけることができる。

ボンテージ番号

Vonageは、世界各国でレンタル番号を提供しています。国によっては、番号がSMSまたは音声のみに対応している場合もあれば、両方に対応している場合もあります。

Vonageはまた、多くの国の「固定電話」と「携帯電話」の両方の番号を提供することができます。利用可能な番号を検索し、レンタルすることができます：

発信者番号通知

アウトバウンドコールをかける場合、発信者IDは from の値は APIを呼び出す または コネクト Voice API 用のアクションです。また、SIP INVITE SIP Trunkingでは、以下のようになります。 PAI ヘッダが設定されていればそのヘッダに、そうでなければ From ヘッダーに表示されます。以下の番号を発信者番号として使用できます：

  • 発信通話に制限のない、アカウントに関連付けられたVonage番号（「制限」フィールドを参照してください。 ナンバーズを買う ページをご覧になるか、サポートにお問い合わせください）。
  • 所有権の証明に必要な情報を提供した後、非ボンテージ・ナンバー。地域制限あり、 お問い合わせ をクリックして、あなたの電話番号をVerify Caller IDとして登録してください。
  • Vonage番号に電話をかけてきた相手のオリジナルの発信者番号（電話エンドポイント・タイプにのみ適用）。これは、通話転送や通話追跡のシナリオに役立ちます。たとえば 15551111111 あなたのVonage番号へ 15552222222接続アクションを持つアウトバウンドコールを番号にかけることができます。 15553333333 オリジナルの発信者番号通知 15551111111 を送信元番号に設定してください。

注：この機能は国内通話にのみ対応しています。つまり、3つの番号すべてが同じ国内にあり、現地の規制当局による規制を受けていない必要があります。

それ以外の番号が発信者番号通知として使用された場合、通話はブロックされます。

発信者番号通知

Vonageからレンタルした電話番号を音声アプリケーションで使用するには、以下の手順で電話番号をアプリケーションにリンクする必要があります。 ダッシュボード アプリケーションのページで、または Numbers API.SIP Trunkingの場合は、SIPドメインにNumbersをリンクする必要があります。 SIPダッシュボード.複数のNumbersを同じアプリケーションにリンクさせることができ、コールされた番号は、あなたの answer_url での to パラメータ、または To ヘッダ INVITE SIP Trunking用。

電話を受けると、発信者番号が アンサーウェブフック として from フィールド、または From ヘッダーを含む。 INVITE SIPトランキング用。

{
  "from": "442079460000",
  "to": "447700900000",
  "uuid": "aaaaaaaa-bbbb-cccc-dddd-0123456789ab",
  "conversation_uuid": "CON-aaaaaaaa-bbbb-cccc-dddd-0123456789ab"
}

Vonageは、Vonageアプリケーションに電話をかけてきた相手の発信者IDを国際形式で表示するよう Applications を試みます。ただし、発信元ネットワークにより、このフォーマットが正しくない場合があります。Vonageは、番号サプライヤーから受信した番号を通過させます。インバウンドの発信者番号通知について詳しくは、以下をご覧ください。 音声機能の概要 のページをご覧ください。