検索の動作を選択する
| ティア | 1 クエリあたりの公開価格 | 動作 |
|---|---|---|
| Starter | $0.0026 | 独自データおよびキャッシュされた発信者名情報を使用します。 |
| Standard | $0.0037 | クエリごとにリアルタイムのネットワーク検索を行います。 |
| Mixed | $0.004 | 最初にリアルタイム検索を試み、名前が見つからない場合は Starter のデータにフォールバックします。 |
検索の動作は選択したサービスによって決まります。Mixed はキャッシュ優先の検索ではありません。本番で使用する前に、お客様のアカウントに設定されている料金を確認してください。発信者名は、本人確認や所有者の証明にはなりません。
送信元を許可する
- SBC またはアプリケーションが使用するパブリック送信元 IP を CNAM IP 設定 に追加し、対象のサービスを関連付けてください。
cnam.multitel.netに SIP INVITE を送信します。request-URI のユーザー部には電話番号の全桁を指定してください。公開されているトランスポートは UDP、宛先ポートは 5060 です。- Via、From、To、Contact、Call-ID、CSeq など、トランザクションに必要なその他のヘッダーは、お使いの SIP スタックで生成してください。下記のリクエストラインだけを送信しないでください。
- SIP トランザクションを正しく完了し、使用可能な結果が含まれている場合にのみ、返された名前を使用してください。
INVITE sip:12025550123@cnam.multitel.net SIP/2.0この検索サービスは SIP 登録を受け付けません。アクセスの許可は、設定済みの送信元アドレスに基づいて行われます。これは NAT ゲートウェイのパブリックアドレスである場合があります。
SIP 検索結果を読み取る
サービスは、P-Asserted-Identity ヘッダー付きの 380 SIP レスポンスで結果を返します。これは検索結果のトランザクションであり、電話が応答されて通話が成立したことを示すものではありません。理由句に返された名前が含まれる場合がありますが、特定の固定フレーズに頼らず、発信者識別ヘッダーを解析してください。
SIP/2.0 380 EXAMPLE CALLER
P-Asserted-Identity: "EXAMPLE CALLER" <sip:12025550123@192.0.2.10>
Content-Length: 0この抜粋ではトランザクションヘッダーを省略しています。例中の 192.0.2.10 は、リクエスト元のシステムを表します。実際の応答は、お使いの SIP スタックの Call-ID および CSeq と照合する必要があります。
- 使用可能な名前を伴う 380
- P-Asserted-Identity から表示名を読み取り、SIP スタックを通じて最終的な INVITE レスポンスに確認応答を返し、通話ワークフローを続行してください。
- 使用可能な名前なし
- エラーメッセージ、空の値、または照会した番号を、確認済みの発信者名の代わりに使用しないでください。通常の「名前不明」の扱いで通話を継続してください。
- 403 またはその他の拒否
- リクエストメソッド、宛先ドメイン、送信元 IP の承認、アカウントおよびサービスの状態を確認してください。認可エラーを短い間隔で繰り返し再試行しないでください。
- タイムアウト
- SIP トランザクションの再送と、新しい検索を区別してください。新しい試行は別のクエリ料金が発生する可能性があるため、回数を制限してください。
課金、再試行、および発信者 ID 更新との違い
新しい検索にはクエリ料金が発生する場合があります。これらの検索インターフェースには冪等性キーが文書化されていないため、新たに再試行すると 2 回目の課金対象クエリになる可能性があります。トランスポートやサービスの障害には、回数を制限したバックオフを使用し、アカウントのエラーを先に解決し、報告されたクエリ料金を照合してください。キャッシュは、アプリケーションに適した期間に限って行ってください。発信者名のデータは変更されることがあります。
CNAM 検索は名前を読み取る操作です。発信通話で表示される名前は変更されません。LIDB の発信者名更新は別の操作であり、独自のフィールド、承認、料金、処理があります。