Convalida dei numeri di telefono in Amazon Pinpoint - Amazon Pinpoint
Casi d'uso della funzione di convalida dei numeri di telefonoUtilizzo del servizio di convalida dei numeri di telefonoRisposte di convalida dei numeri di telefono

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Convalida dei numeri di telefono in Amazon Pinpoint

Amazon Pinpoint include un servizio di convalida dei numeri di telefono che è possibile utilizzare per stabilire se un numero di telefono è valido e per ottenere ulteriori informazioni su tale numero. Ad esempio, quando si utilizza il servizio di convalida dei numeri di telefono, restituisce le informazioni riportate di seguito.

  • Il numero di telefono nel formato E.164.

  • Il tipo di numero di telefono (ad esempio mobile, rete fissa o VoIP).

  • La città e il paese collegati al numero di telefono.

  • Il fornitore di servizi associato al numero di telefono.

Non vi sono costi aggiuntivi per l'utilizzo del servizio di convalida dei numeri di telefono. Per ulteriori informazioni, consulta Prezzi di Amazon Pinpoint.

Importante

Per i numeri di telefono con origine negli Stati Uniti e in Canada, la convalida dei numeri di telefono non API restituirà più i dati per CityCounty, Timezone e. ZipCode

Casi d'uso della funzione di convalida dei numeri di telefono

È possibile utilizzare il servizio di convalida dei numeri di telefono per diversi casi d'utilizzo, tra cui i seguenti:

  • Verifica di numeri di telefono forniti su un modulo Web: se utilizzi moduli basati sul Web per raccogliere informazioni di contatto dai clienti, devo convalidare il numero di telefono fornito dai clienti prima di inviare il modulo. Usa il backend del tuo sito Web per convalidare il numero utilizzando Amazon Pinpoint. API La API risposta indica se il numero non è valido, ad esempio se il numero di telefono è formattato in modo errato. Se verifichi che il numero di telefono che il cliente ha fornito non è valido, il modulo di richiesta del cliente Web può chiedere al cliente di fornire un numero diverso.

  • Pulizia del database di contatti esistente: se disponi di un database dei numeri di telefono dei clienti, puoi convalidare ogni numero di telefono e aggiornare il database in base ai risultati. Ad esempio, se trovi endpoint con numeri di telefono che non sono in grado di ricevere SMS messaggi, puoi modificare la ChannelType proprietà dell'endpoint da a. SMS VOICE Puoi prima convalidare il numero di telefono e poi aggiornare la proprietà ChannelType per gli endpoint nuovi o esistenti seguendo le istruzioni in Aggiunta di endpoint ad Amazon Pinpoint per un singolo endpoint o in Aggiunta di un batch di endpoint ad Amazon Pinpoint per più endpoint.

  • Scelta del canale giusto prima di inviare un messaggio: se intendi inviare un SMS messaggio ma ritieni che il numero di destinazione non sia valido, puoi inviare un messaggio al destinatario tramite un canale diverso. Ad esempio, se l'endpoint non è in grado di ricevere SMS messaggi, puoi invece inviare un messaggio vocale.

Utilizzo del servizio di convalida dei numeri di telefono

L'esempio seguente mostra come convalidare un numero di telefono utilizzando il. AWS CLI Per ulteriori informazioni, vedere phone-number-validatenel AWS CLI Command Reference. Ad esempio, le risposte di convalida, vedereRisposte di convalida dei numeri di telefono. Per ulteriori informazioni sulla configurazione di AWS CLI, vedere Configure the AWS CLI nella Guida per l'AWS Command Line Interface utente.

Per utilizzare il servizio di convalida del numero di telefono utilizzando AWS CLI

  • Nella riga di comando, inserisci il comando seguente:

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

    Nel comando precedente, sostituisci +442079460881 con il numero di telefono che desideri convalidare e GB con il codice del ISO paese o della regione a due cifre.

    Nota

    Quando si fornisce un numero di telefono al servizio di convalida del numero di telefono, includere sempre il prefisso internazionale. Se non si include il prefisso internazionale, il servizio può restituire informazioni per un numero di telefono in un paese diverso. Ad esempio, puoi avere dei trattini nel numero di telefono +44-207-946-0881.

Risposte di convalida dei numeri di telefono

Le informazioni che il servizio di convalida dei numeri di telefono fornisce variano leggermente in base ai dati disponibili per il numero di telefono fornito dall'utente. Questa sezione contiene esempi di risposte che il servizio di convalida dei numeri di telefono restituisce.

Nota

I dati forniti dal servizio di convalida dei numeri di telefono si basano su informazioni fornite dai provider di servizi di telecomunicazione e da altre entità in tutto il mondo. I provider in alcuni paesi potrebbero aggiornare queste informazioni meno frequentemente rispetto a provider di altri paesi. Ad esempio, se invii una richiesta di convalida di un numero di telefono cellulare e il numero fornito è stato trasferito da un operatore mobile a un altro, la risposta dal servizio di convalida dei numeri di telefono potrebbe includere il nome dell'operatore originale, rispetto a quello corrente.

Numeri di cellulare validi

Quando invii una richiesta al servizio di convalida dei numeri di telefono e il numero di telefono è un numero di telefono cellulare valido, restituisce informazioni simili al seguente esempio:

{
    "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"
    }
}
Numeri di telefono fisso validi

Se la richiesta contiene un numero di telefono fisso valido, il servizio di convalida dei numeri di telefono restituisce informazioni simili al seguente esempio:

{
    "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"
}
Numeri di telefono VoIP validi

Se la richiesta contiene un numero di telefono VoIP valido (Voice over Internet Protocol), il servizio di convalida dei numeri di telefono restituisce informazioni simili al seguente esempio:

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

Se la richiesta contiene un numero di telefono non valido, il servizio di convalida dei numeri di telefono restituisce informazioni simili al seguente esempio:

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

Notare che la proprietà PhoneType in questo tipo di risposta indica che questo numero di telefono è INVALID e che non include informazioni sull'operatore o su un percorso associato al numero di telefono. È consigliabile evitare di inviare SMS messaggi vocali ai numeri di telefono in cui si trovaINVALID, poiché PhoneType è improbabile che tali numeri appartengano ai destinatari effettivi.

Altri numeri di telefono

Occasionalmente, la risposta dal servizio di convalida dei numeri di telefono include un valore PhoneType di OTHER. Il servizio può restituire questo tipo di risposta nelle seguenti situazioni:

  • Il numero di telefono è un numero gratuito.

  • Il numero di telefono è riservato all'utilizzo in programmi televisivi e filmati, ad esempio numeri di telefono del Nord America che iniziano con 555.

  • Il numero di telefono include un prefisso che non è attualmente in uso, ad esempio il prefisso 999 in America del Nord.

  • Il numero di telefono è riservato a un altro scopo.

L'esempio seguente mostra la risposta che il servizio di convalida dei numeri di telefono fornisce quando la richiesta include un numero di telefono dell'America del Nord fittizio:

{
    "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"
    }
}
Numeri di telefono prepagati

Se la richiesta contiene un numero di telefono prepagato valido, il servizio di convalida dei numeri di telefono restituisce informazioni simili al seguente esempio:

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

Per ulteriori informazioni sulle informazioni contenute in queste risposte, consulta Convalida del numero di telefono in Amazon API Pinpoint Reference.