View a markdown version of this page

Utilizza il servizio di ricerca del corriere - AWS SMS di messaggistica per l'utente finale
Casi d'uso di Carrier LookupFormati di numeri di telefono supportatiUtilizzando il servizio di ricerca dell'operatore nel AWS CLI

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à.

Utilizza il servizio di ricerca del corriere

AWS End User Messaging SMS include un servizio di ricerca dell'operatore che è possibile utilizzare per ottenere informazioni su un numero di telefono, anche se il numero di telefono è valido. Il servizio di ricerca dell'operatore restituisce le seguenti informazioni per un numero di telefono:

  • Il numero di telefono in formato E164 (eliminato dall'input originale).

  • Il tipo di numero di telefono (ad esempio non valido, fisso, cellulare, altro).

  • Il nome del paese o dell'area geografica per il numero di telefono.

  • Il prefisso numerico del paese o della regione per il numero di telefono.

  • Il codice del paese o dell'area geografica a due caratteri, in formato ISO 3166-1 alpha-2, per il numero di telefono.

  • Per i numeri di cellulare, il prefisso internazionale del cellulare (MCC).

  • Per i numeri di cellulare, il codice di rete mobile (MNC).

  • L'operatore o il fornitore di servizi con cui è attualmente registrato il numero di telefono. In alcuni paesi e aree geografiche, questo valore può corrispondere all'operatore o al fornitore di servizi presso il quale il numero di telefono è stato originariamente registrato.

È previsto un costo aggiuntivo per l'utilizzo del servizio di ricerca dell'operatore. Per ulteriori informazioni, consulta i prezzi degli SMS per la messaggistica con l'utente AWS finale.

Casi d'uso di Carrier Lookup

Puoi utilizzare il servizio di ricerca dell'operatore per abilitare diversi casi d'uso, tra cui i seguenti:

  • Cerca i numeri di telefono forniti in un modulo Web: se utilizzi moduli basati sul Web per raccogliere informazioni di contatto per i tuoi clienti, puoi cercare i numeri di telefono forniti dai clienti prima di inviare il modulo. Utilizza il backend del tuo sito Web per cercare e convalidare il numero utilizzando l'API SMS di messaggistica per l'utente finale. AWS La risposta dell'API indica se il numero è valido, ad esempio se il numero di telefono è formattato correttamente. Se stabilisci che il numero di telefono fornito dal cliente non è valido, il modulo web può richiedere al cliente di fornire un numero valido.

  • Pulizia del database dei contatti esistente: se disponi di un database di numeri di telefono dei clienti, puoi cercare ogni numero di telefono e aggiornare il database utilizzando i risultati della ricerca dell'operatore. Ad esempio, se trovi endpoint con i numeri di telefono che non sono in grado di ricevere messaggi SMS, puoi modificare la proprietà ChannelType per l'endpoint da SMS a VOICE.

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

Formati di numeri di telefono supportati

I numeri di telefono devono essere in formato E164, iniziando con un segno più (+) seguito dal prefisso internazionale e dal numero di telefono (ad esempio, +12065551234). Il servizio di ricerca dell'operatore accetta vari caratteri di formattazione e li rimuove automaticamente durante l'elaborazione. È possibile includere i seguenti caratteri di formattazione nell'immissione del numero di telefono:

  • Parentesi: +1 (555) 123-4567

  • Staffe: +1 [555] 123-4567

  • Spazi: +1 555 123 4567

  • Trattini: +1-555-123-4567

  • Periodi: +1.555.123.4567

  • Virgole: +1,555,123,4567

  • Formattazione mista: +1 (555)-123.4567

Tutti i caratteri di formattazione vengono rimossi automaticamente durante l'elaborazione e il servizio restituisce il numero di telefono nel formato E164 standard (ad esempio,+15551234567) nel E164PhoneNumber campo della risposta.

Utilizzando il servizio di ricerca dell'operatore nel AWS CLI

L'esempio seguente mostra come utilizzare il servizio di ricerca del corriere in. AWS CLI Il servizio accetta numeri di telefono con vari caratteri di formattazione (parentesi, parentesi, spazi, trattini, punti, virgole) e li converte automaticamente in formato E164 per l'elaborazione. Per ulteriori informazioni, consulta il riferimento all'API SMS di messaggistica per l'utente AWS finale o la ricerca dell'operatore CarrierLookupnel riferimento dei comandi. AWS CLI

Per utilizzare il servizio di ricerca dell'operatore (CLI)

  • Nella riga di comando, immetti il comando seguente: Puoi utilizzare diversi formati di numeri di telefono: il servizio accetta caratteri speciali come parentesi, parentesi, spazi, trattini, punti e virgole:

    $ aws pinpoint-sms-voice-v2 carrier-lookup --phone-number "+1 (555) 555-5333"

    Oppure con il formato E164:

    $ aws pinpoint-sms-voice-v2 carrier-lookup --phone-number +15555555333

Risposte di ricerca dell'operatore

Le informazioni fornite dal servizio di ricerca dell'operatore variano leggermente in base ai dati disponibili per il numero di telefono fornito. Questa sezione contiene esempi delle risposte restituite dal servizio di ricerca dell'operatore.

Nota

I dati forniti dal servizio di ricerca dell'operatore si basano su informazioni fornite dai provider di telecomunicazioni 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 cellulare e il numero che hai fornito è stato trasferito da un operatore di telefonia mobile a un altro, la risposta del servizio di ricerca dell'operatore potrebbe includere il nome dell'operatore originale, anziché quello attuale.

Numeri di cellulare validi

La risposta seguente è un esempio di informazioni CarrierLookup restituite per un numero di cellulare valido:

{
    "E164PhoneNumber": "+15555555333",
    "DialingCountryCode": "1",
    "IsoCountryCode": "US",
    "Country": "United States",
    "MCC": "310",
    "MNC": "260",
    "Carrier": "ExampleCorp Mobile",
    "PhoneNumberType": "MOBILE"
}
Numeri di telefono fisso validi

La risposta seguente è un esempio di CarrierLookup restituzione di informazioni per un numero di telefono fisso valido:

{
    "E164PhoneNumber": "+15555555333",
    "DialingCountryCode": "1",
    "IsoCountryCode": "CA",
    "Country": "Canada",
    "Carrier": "ExampleCorp Landline",
    "PhoneNumberType": "LANDLINE"
}
Numeri di telefono non validi

Se la richiesta contiene un numero di telefono non valido, il servizio di ricerca dell'operatore restituisce informazioni simili al seguente esempio:

{
    "E164PhoneNumber": "+15555555333444666",
    "PhoneNumberType": "INVALID"
}}

Notare che la proprietà PhoneNumberType 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. Si consiglia di evitare l'invio di SMS o messaggi vocali ai numeri di telefono in cui PhoneNumberType è INVALID, perché questi numeri non appartengono a destinatari effettivi.

Altri numeri di telefono

I numeri di telefono non classificati come mobili, fissi o non validi vengono restituiti con un valore di. PhoneNumberType OTHER