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

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon Pinpoint での電話番号の検証

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

  • この電話番号は E.164 形式です。

  • 電話番号の種類 (携帯電話、固定電話、または VoIP など)。

  • 電話番号の市および国または。

  • 電話番号に関連付けられているサービスプロバイダー。

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

重要

米国およびカナダから発信された電話番号の場合、電話番号の検証APIでは、City、、CountyTimezoneおよび のデータが返されなくなります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 プロパティを更新できます。

  • メッセージを送信する前に適切なチャネルを選択する – メッセージを送信する予定SMSだが、送信先番号が無効であると判断した場合は、別のチャネルを介して受信者にメッセージを送信できます。例えば、エンドポイントがSMSメッセージを受信できない場合は、代わりに音声メッセージを送信できます。

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

次の例は、 を使用して電話番号を検証する方法を示しています AWS CLI。詳細については、 コマンドリファレンスphone-number-validateの「」を参照してください。 AWS CLI 検証レスポンスの例については、「」を参照してください電話番号検証のレスポンス。の設定の詳細については AWS CLI、「 ユーザーガイド」の「 の設定 AWS CLIAWS Command Line Interface」を参照してください。

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

  • コマンドラインで以下のコマンドを入力します。

    aws pinpoint phone-number-validate --number-validate-request PhoneNumber=+442079460881,IsoCountryCode=GB

    上記のコマンドで、+442079460881 検証する電話番号と GB を 2 桁のISO国または地域コードで入力します。

    注記

    電話番号を電話番号検証サービスに入力するときは、必ず国コードを含める必要があります。国コードを含めないと、サービスは別の国の電話番号の情報を返す場合があります。電話番号にダッシュを付けることができます。例えば、+44-207-946-0881.

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

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

注記

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

有効な携帯電話番号

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

{
    "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 が である電話番号に SMSまたは 音声メッセージを送信することは避けてください。これらの番号は実際の受信者に属している可能性が低いINVALIDためです。

その他の電話番号

場合によっては、電話番号検証サービスからのレスポンスに 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リファレンス」の「電話番号の検証」を参照してください。