電話番号検証のユースケース電話番号検証サービスを使用する電話番号検証のレスポンス

Amazon Pinpoint での電話番号の検証

Amazon Pinpoint には、電話番号が有効かどうかを判断したり、電話番号自体に関する追加情報を入手するために使用できる電話番号検証サービスが含まれています。例えば、電話番号検証サービスを使用すると、次のような情報が返されます。

この電話番号は E.164 形式です。
電話番号の種類 (携帯電話、固定電話、または VoIP など)。
電話番号の市および国または。
電話番号に関連付けられているサービスプロバイダー。

電話番号検証サービスの使用には追加料金が発生します。詳細については、「Amazon Pinpoint pricing」を参照してください。

重要

米国とカナダの電話番号発信の場合、電話番号検証 API は City、County、Timezone、ZipCode のデータを返しません。

電話番号検証のユースケース

電話番号検証サービスを使用すると、以下のようないくつかのユースケースを有効にできます。

[Verifying phone numbers provided on a web form] - ウェブベースのフォームを使用してお客様の連絡先情報を収集する場合は、フォームを送信する前にお客様が提供する電話番号を検証します。ウェブサイトのバックエンドを使用して、Amazon Pinpoint API を使用して番号を検証します。API レスポンスは、番号が無効であるかどうか（例えば、電話番号が正しくフォーマットされていないなど）を示します。お客様が提供した電話番号が無効であると判断した場合、ウェブフォームはお客様に別の番号を提供するように促すことができます。
[Cleansing your existing contact database] - お客様の電話番号のデータベースがある場合は、各電話番号を検証して、調査結果に基づいてデータベースを更新することができます。例えば、SMS メッセージを受信できない電話番号を持つエンドポイントを見つけた場合は、そのエンドポイントの ChannelType プロパティを SMS から VOICE に変更できます。最初に電話番号を確認してから、Amazon Pinpoint へエンドポイントを追加する (単一のエンドポイントの場合) またはエンドポイントのバッチを Amazon Pinpoint に追加する (複数のエンドポイント場合) の指示に従って、新規または既存のエンドポイントの ChannelType プロパティを更新できます。
[Choosing the right channel before you send a message] - SMS メッセージを送信しようとしているが送信先番号が無効であると判断した場合は、別のチャネルを介して受信者にメッセージを送信できます。例えば、エンドポイントが、SMS メッセージを受信できない場合は、代わりに音声メッセージを送信できます。

電話番号検証サービスを使用する

番号を検証するには、Amazon Pinpoint API の /v1/phone/number/validate/ URI に HTTP POST リクエストを送信します。次の例のリクエストには、必須の HTTP ヘッダーと、シンプルな JSON 本文が含まれています。本文では、PhoneNumber パラメータを使用して検証する数値を指定します。


POST /v1/phone/number/validate/ HTTP/1.1
Host: pinpoint.us-east-1.amazonaws.com
Content-Type: application/json
X-Amz-Date: 20190805T031042Z
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20190805/us-east-1/mobiletargeting/aws4_request, SignedHeaders=content-length;content-type;host;x-amz-date, Signature=39df573629ddb283aea1fa2f7eef4106c0fb4826edf72e9934f03cf77example
Cache-Control: no-cache

{
	"PhoneNumber": "+12065550100"
}

サポートされているメソッド、パラメータ、スキーマの詳細については、「Amazon Pinpoint API リファレンス」の「電話番号の検証」を参照してください。

また、を使用して個々の電話番号をすばやく確認することもできます。 AWS CLI

を使用して電話番号検証サービスを利用するには AWS CLI

コマンドラインで以下のコマンドを入力します。
```
aws pinpoint phone-number-validate --number-validate-request PhoneNumber=+442079460881
```
前述のコマンドで、+442079460881 を検証する電話番号に置き換えます。詳細については、『AWS CLI コマンドリファレンス』phone-number-validateのを参照してください。

注記
電話番号を電話番号検証サービスに入力するときは、必ず国コードを含める必要があります。国コードを含めないと、サービスは別の国の電話番号の情報を返す場合があります。

電話番号検証のレスポンス

電話番号検証サービスが提供する情報は、入力した電話番号に使用できるデータによって多少異なります。このセクションには、電話番号検証サービスが返すレスポンスの例が含まれています。

注記

電話番号検証サービスによって提供されるデータは、電気通信プロバイダーおよび世界中の他のエンティティによって提供される情報に基づいています。一部の国のプロバイダーは、他の国のプロバイダーほど頻繁にこの情報を更新しない場合があります。例えば、携帯電話番号を検証するリクエストを発行し、指定した番号がある携帯電話会社から別の携帯電話会社に移動した場合、電話番号検証サービスからのレスポンスには、現在の携帯電話会社ではなく、元の携帯電話会社の名前が含まれます。

有効な携帯電話番号

電話番号検証サービスにリクエストを送信したときに、その電話番号が有効な携帯電話番号である場合は、次の例のような情報が返されます。


{
    "NumberValidateResponse": {
        "Carrier": "ExampleCorp Mobile",
        "City": "Seattle",
        "CleansedPhoneNumberE164": "+12065550142",
        "CleansedPhoneNumberNational": "2065550142",
        "Country": "United States",
        "CountryCodeIso2": "US",
        "CountryCodeNumeric": "1",
        "OriginalPhoneNumber": "+12065550142",
        "PhoneType": "MOBILE",
        "PhoneTypeCode": 0,
        "Timezone": "America/Los_Angeles",
        "ZipCode": "98101"
    }
}

有効な固定電話番号

リクエストに有効な固定電話番号が含まれている場合、電話番号検証サービスは次の例のような情報を返します。


{
    "CountryCodeIso2": "US",
    "CountryCodeNumeric": "1",
    "Country": "United States",
    "City": "Santa Clara",
    "ZipCode": "95037",
    "Timezone": "America/Los_Angeles",
    "CleansedPhoneNumberNational": "4085550101",
    "CleansedPhoneNumberE164": "14085550101",
    "Carrier": "AnyCompany",
    "PhoneTypeCode": 1,
    "PhoneType": "LANDLINE",
    "OriginalPhoneNumber": "+14085550101"
}

有効な VoIP 電話番号

リクエストに有効なボイスオーバーインターネットプロトコル (VoIP) 電話番号が含まれている場合、電話番号検証サービスは次の例のような情報を返します。


{
    "NumberValidateResponse": {
        "Carrier": "ExampleCorp",
        "City": "Countrywide",
        "CleansedPhoneNumberE164": "+441514960001",
        "CleansedPhoneNumberNational": "1514960001",
        "Country": "United Kingdom",
        "CountryCodeIso2": "GB",
        "CountryCodeNumeric": "44",
        "OriginalPhoneNumber": "+441514960001",
        "PhoneType": "VOIP",
        "PhoneTypeCode": 2
    }
}

無効な電話番号

リクエストに無効な電話番号が含まれている場合、電話番号検証サービスは次の例のような情報を返します。


{
    "NumberValidateResponse": {
        "CleansedPhoneNumberE164": "+44163296076",
        "CleansedPhoneNumberNational": "163296076",
        "Country": "United Kingdom",
        "CountryCodeIso2": "GB",
        "CountryCodeNumeric": "44",
        "OriginalPhoneNumber": "+440163296076",
        "PhoneType": "INVALID",
        "PhoneTypeCode": 3
    }
}

このレスポンスの PhoneType プロパティは、この電話番号が INVALID であること、および電話番号に関連付けられた携帯電話会社または場所に関する情報が含まれていないことを示しています。PhoneType が INVALID である電話番号に SMS または音声メッセージを送信することは避けてください。これらの番号は実際の受信者に属しているとは考えられないためです。

その他の電話番号

場合によっては、電話番号検証サービスからのレスポンスに OTHER の PhoneType 値が含まれています。次のような状況では、サービスはこのようなレスポンスを返す場合があります。

この電話番号は通話料無料の番号です。
この電話番号は、555 で始まる北米の電話番号など、テレビ番組や映画での使用にリザーブされています。
この電話番号には、北米の999 市外局番など、現在使用されていない市外局番が含まれています。
この電話番号は他の目的のためにリザーブされています。

以下の例は、リクエストに架空の北米の電話番号が含まれている場合に電話番号検証サービスが提供するレスポンスを示しています。


{
    "NumberValidateResponse": {
        "Carrier": "Multiple OCN Listing",
        "CleansedPhoneNumberE164": "+14255550199",
        "CleansedPhoneNumberNational": "4255550199",
        "Country": "United States",
        "CountryCodeIso2": "US",
        "CountryCodeNumeric": "1",
        "OriginalPhoneNumber": "+14255550199",
        "PhoneType": "OTHER",
        "PhoneTypeCode": 4,
        "Timezone": "America/Los_Angeles"
    }
}

プリペイド電話の番号

リクエストに有効なプリペイド電話の番号が含まれている場合、電話番号検証サービスは次の例のような情報を返します。


{
    "NumberValidateResponse": {
        "Carrier": "ExampleCorp",
        "City": "Countrywide",
        "CleansedPhoneNumberE164": "+14255550199",
        "CleansedPhoneNumberNational": "4255550199",
        "Country": "United States",
        "CountryCodeIso2": "US",
        "CountryCodeNumeric": "1",
        "OriginalPhoneNumber": "+14255550199",
        "PhoneType": "PREPAID",
        "PhoneTypeCode": 5
    }
}

これらの応答に含まれる情報の詳細については、「Amazon Pinpoint API リファレンス」の「電話番号の検証」を参照してください。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

アプリケーション内のメッセージの送信および取得

メッセージの送信