現在のキャリア

現在のキャリアインサイトは、指定した電話番号に現在割り当てられているモバイルネットワーク事業者を識別します。元の割り当てに基づくインサイトとは異なり、この機能は番号ポータビリティを反映し、電話番号がどのキャリアに関連付けられているかについての最新情報を提供します。

この洞察は、通信効率、配信可能性、ユーザーの確認が重要なシナリオにおいて不可欠です。番号がモバイルネットワークにアクティブに割り当てられているかどうかを確認することで、企業はSMS、音声、またはデータベースの通信の正確なルーティングを保証することができます。これにより、企業は、非アクティブ化された（どのキャリアにも関連していない）番号や非モバイル番号への連絡に関連する不必要なコストや運用の非効率性を回避することができます。

重要な使用例のひとつに、顧客データベースのクレンジングと更新があり、連絡先情報が最新かつ有効であることを保証する。例えば、番号が携帯電話会社に割り当てられていないことを特定することで、メッセージの失敗を避け、再試行を減らし、ユーザーとのエンゲージメントの質を高く保つことができる。また、固定電話やバーチャル回線、プレミアム回線に比べ、一般的に個人的で個人が使用する可能性の高い携帯電話番号に焦点を当てることで、プライバシーを意識したアウトリーチもサポートします。

詐欺防止や本人確認プロセスにおいて、現在の携帯電話会社を知ることは、ユーザーの正当性を検証し、リスクを軽減するためのシグナルとして役立つ。

このインサイトを活用することで、企業はコミュニケーション・ワークフローをより適切に管理し、ユーザー体験を向上させ、リアルタイムの電話番号インテリジェンスに基づいてエンゲージメント戦略を最適化することができます。

注：このアプリケーションは携帯電話番号にのみ適用されます。

前提条件

Identity Insights を使用するには、アカウントが正しく設定されていることを確認する必要があります。はじめにのガイドを参照されたい：

アカウントの作成
Identity Insights API で使用する Vonage アプリケーションの作成、
利用可能なさまざまな環境と、それらを使用するためのアカウントの設定方法、
また、Dashboard Getting Started UIを使用して、コードを書かずにAPIを使用する方法も紹介します。

このガイドでは、cURLを使用してプログラムで現在のキャリアインサイトを使用する方法を説明します。

Identity Insights API は、複数の地域のエンドポイントから利用できる。本ガイドの例では EU エンドポイントを使用していますが、全リストは以下を参照してください。技術詳細.

APIを呼び出す

Identity Insights API の認証は、コンパクトで自己完結型の JSON トークンである JWT を介して行われます。JWT を生成するには、当社のオンラインジェネレーターあるいは Vonage CLI.JWTを生成するには、アプリケーションIDと秘密鍵が必要です。JWTを取得したら、APIにリクエストを送信できます。

この例では、Current Carrierインサイトに対するcURLリクエストを示す：

curl -X POST https://api-eu.vonage.com/identity-insights/v1/requests  \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "14040000000",
    "purpose": "FraudPreventionAndDetection",
    "insights": {
      "current_carrier": {}
        }
    }'

APIは、電話番号が現在割り当てられているネットワークに関する情報（名前、ネットワークタイプ、国コードなど）を返す：

{
  "request_id": "c2cc7a65-9b10-493f-9c0a-1c86751a91c4",
  "insights": {
    "current_carrier": {
         "name": "Orange Espana, S.A. Unipersonal",
         "network_type": "MOBILE",
         "country_code": "ES",
         "network_code": "21403",
         "status": {
            "code": "OK",
            "message": "Success"
         }
      }
  }
}

以下のフィールドが current_carrier 配列である：

フィールド	説明
`name`	以下の航空会社の正式名称 `phone_number` が関連している。
`network_type`	ネットワークの種類 `phone_number` に関連付けられます。常に `MOBILE`.
`country_code`	の2文字の国コード `phone_number`.これは ISO 3166-1 alpha-2 という形式をとっている。
`network_code`	モバイル国コード（MCC） + モバイルネットワークコード（MNC）。 E.212 国際移動加入者ID.
`status`	指定された電話番号について返された情報のステータスを示す。
`code`	リクエストのステータスを示すコード。のいずれかでなければならない： `NO_COVERAGE`:国またはモバイルネットワークは、利用可能なサプライヤーによってサポートされていません。 `INVALID_PURPOSE`:使用された目的は、このインサイトで有効または許可されていません。 `UNAUTHORIZED`:アプリケーション、サプライヤー、電話番号の組み合わせでは、リクエストを承認できませんでした。 `INTERNAL_ERROR`:リクエストの処理中に内部エラーが発生しました。 `SUPPLIER_ERROR`:サプライヤーがリクエスト処理中にエラーを返しました。 `NOT_FOUND`:このインサイトの電話番号が見つかりません。 `INVALID_NUMBER_FORMAT`:電話番号フォーマットは、キャリアからユーザーへの割り当てには無効です。 `OK`:インサイトは正常に処理されました。
`message`	より詳細なステータスの説明。

さらに読む

Identity Insights API の詳細については、以下を参照してください。 APIリファレンス.
ご不明な点がございましたら、下記までお問い合わせください。 VonageコミュニティSlack.