View a markdown version of this page

Scelta di un numero di telefono 10DLC in base al prefisso - AWS Messaggistica SMS per l'utente finale
PrerequisitiTipi di pattern di ricercaConsiderazioni importantiCerca e richiedi un numero di telefono 10DLC

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

Scelta di un numero di telefono 10DLC in base al prefisso

Quando richiedi un numero di telefono con codice lungo 10 cifre (10DLC), puoi cercare e scegliere un numero specifico invece di ricevere un'assegnazione casuale. Puoi effettuare la ricerca per prefisso o per uno schema all'interno del numero di telefono. Puoi anche richiedere un numero di telefono esatto. Questa funzione è disponibile solo per i numeri di telefono 10DLC degli Stati Uniti.

La selezione del numero di telefono avviene in due fasi:

  1. Cerca: utilizza l'ListAvailablePhoneNumbersAPI o la console per sfogliare i numeri 10DLC disponibili filtrati per prefisso o modello.

  2. Richiesta: utilizza l'RequestPhoneNumberAPI con il NumberPreference parametro opzionale o seleziona un numero nella console per richiedere un numero di telefono specifico.

Prerequisiti

Prima di poter cercare e scegliere un numero di telefono 10DLC, devi avere quanto segue:

La ricerca del numero di telefono restituisce i numeri disponibili tramite l'aggregatore associato alla registrazione della campagna 10DLC. Non è necessario specificare un aggregatore.

Tipi di pattern di ricerca

È possibile cercare i numeri di telefono disponibili utilizzando i seguenti tipi di pattern:

Tipo di motivo Description Esempio
StartsWith Restituisce numeri che iniziano con le cifre specificate. Usalo per cercare in base al prefisso. Il filtro +1510 restituisce i numeri nel prefisso 510, ad esempio+15103921111.
EndsWith Restituisce i numeri che terminano con le cifre specificate. Il filtro 1234 restituisce numeri che terminano con 1234, ad esempio+12025551234.
Contains Restituisce numeri che contengono le cifre specificate in un punto qualsiasi del numero. Il filtro 555 restituisce numeri contenenti 555, ad esempio+15105559876.
ExactMatch Richiede un numero di telefono specifico. Questo tipo è valido solo con l'RequestPhoneNumberAPI, non conListAvailablePhoneNumbers. Il filtro +15103921234 richiede quel numero esatto.

Considerazioni importanti

  • La disponibilità del numero di telefono non è garantita. Un numero visualizzato nei risultati di ricerca può essere acquistato da un altro cliente prima di richiederlo. In tal caso, richiedi un numero diverso o esegui nuovamente la ricerca.

  • I risultati della ricerca non sono una prenotazione. I numeri non vengono conservati per te tra la fase di ricerca e la fase di richiesta.

  • I risultati della ricerca restituiscono un massimo di 10 numeri per pagina. Per recuperare pagine aggiuntive di risultati, utilizzate il NextToken parametro.

  • Se non si specifica a NumberPreference durante la chiamataRequestPhoneNumber, il comportamento esistente rimane invariato e gli SMS di messaggistica per l'utente AWS finale assegnano automaticamente un numero di telefono.

  • Questa funzione è disponibile solo per i numeri di telefono 10DLC (TEN_DLC) degli Stati Uniti.

Cerca e richiedi un numero di telefono 10DLC

Puoi cercare e richiedere un numero di telefono 10DLC specifico utilizzando la console SMS di messaggistica per l'utente AWS finale o il. AWS CLI

Console

Puoi cercare e scegliere un numero di telefono 10DLC specifico durante il processo di richiesta del numero di telefono nella console SMS di messaggistica per utenti AWS finali.

Scegli un numero di telefono 10DLC in base al prefisso (Console)

  1. Apri la console AWS End User Messaging SMS all'indirizzo. https://console.aws.amazon.com/sms-voice/

  2. Nel riquadro di navigazione, in Configurazioni, scegli Numeri di telefono, quindi Origine della richiesta.

  3. Nella pagina Seleziona il paese, scegli Stati Uniti (USA) dal menu a discesa Paese di destinazione del messaggio. Scegli Avanti.

  4. Completa la sezione dedicata ai casi d'uso della messaggistica e scegli Avanti.

  5. In Tipo di originatore, scegli il tipo di numero 10DLC e associa il marchio e la campagna registrati.

  6. (Facoltativo) Nella sezione Preferenza numero, cerca un numero di telefono specifico:

    1. Seleziona un tipo di modello di ricerca: Inizia con, Termina con o Contiene.

    2. Inserisci uno schema. Ad esempio, inserisci 510 per cercare i numeri nel prefisso 510. La console formatta automaticamente l'input con il prefisso internazionale.

    3. Selezionare Search (Cerca). Una tabella mostra fino a 10 numeri di telefono disponibili.

    4. Seleziona il numero di telefono desiderato, quindi scegli Avanti.

    Se salti questo passaggio, AWS End User Messaging SMS assegna automaticamente un numero di telefono.

  7. Se necessario, configura la condivisione dei criteri delle risorse, quindi scegli Avanti.

  8. In Rivedi e richiedi, verifica le impostazioni e scegli Richiedi.

AWS CLI

Usa per AWS CLI cercare i numeri di telefono 10DLC disponibili e poi richiedi un numero specifico.

Passaggio 1: cerca i numeri disponibili

Usa il comando list-available-phone-numbers per cercare i numeri di telefono 10DLC disponibili. L'esempio seguente cerca i numeri nel prefisso 510:

$ aws pinpoint-sms-voice-v2 list-available-phone-numbers \
    --iso-country-code US \
    --number-type TEN_DLC \
    --registration-id registration-1234567890 \
    --number-preference '[{"PreferenceType": ["StartsWith"], "Filter": ["+1510"]}]'

Se sono disponibili numeri che corrispondono ai criteri di ricerca, la risposta include un elenco di numeri di telefono nel E.164 formato:

{
    "AvailablePhoneNumbers": [
        "+15103921111",
        "+15103922222",
        "+15103923333",
        "+15103924444",
        "+15103925555"
    ],
    "NextToken": "AAMAJDUwNzE4ZTQwLWJkOTUtNDk4Ny..."
}

Nel comando precedente, apporta le modifiche seguenti:

  • Sostituiscilo registration-1234567890 con l'ID della tua registrazione approvata alla campagna 10DLC.

  • Sostituiscilo +1510 con il prefisso o il modello che desideri cercare.

  • Sostituisci StartsWith con EndsWith o Contains per modificare il tipo di modello di ricerca.

Se la risposta include un NextToken valore, passalo in una richiesta successiva per recuperare la pagina successiva dei risultati. Quando NextToken è nullo, non ci sono altri risultati.

Fase 2: Richiedere un numero specifico

Dopo aver trovato un numero di telefono nei risultati della ricerca, utilizza il comando request-phone-number con il --number-preference parametro per richiedere quel numero.

L'esempio seguente richiede un numero di telefono esatto:

$ aws pinpoint-sms-voice-v2 request-phone-number \
    --iso-country-code US \
    --message-type TRANSACTIONAL \
    --number-type TEN_DLC \
    --number-capabilities SMS \
    --registration-id registration-1234567890 \
    --number-preference '{"PreferenceType": ["ExactMatch"], "Filter": ["+15103921111"]}'

Puoi anche richiedere un numero di telefono utilizzando uno schema. L'esempio seguente richiede qualsiasi numero disponibile nel prefisso 510:

$ aws pinpoint-sms-voice-v2 request-phone-number \
    --iso-country-code US \
    --message-type TRANSACTIONAL \
    --number-type TEN_DLC \
    --number-capabilities SMS \
    --registration-id registration-1234567890 \
    --number-preference '{"PreferenceType": ["StartsWith"], "Filter": ["+1510"]}'

Nei comandi precedenti, apportate le seguenti modifiche:

  • Sostituiscilo registration-1234567890 con l'ID della tua registrazione approvata alla campagna 10DLC.

  • Sostituisci TRANSACTIONAL con PROMOTIONAL se stai inviando messaggi promozionali.

  • Sostituiscilo SMS con le funzionalità di cui hai bisogno. È possibile specificareSMS,MMS, eVOICE.

  • Sostituisci il numero di telefono o la sequenza Filter con il tuo valore preferito.

Se il numero richiesto è disponibile, la risposta è la stessa di una RequestPhoneNumber risposta standard, inclusi i Status campi PhoneNumberIdPhoneNumber, e. Se il numero esatto non è più disponibile, la richiesta restituisce un errore. Effettua una nuova ricerca per trovare un altro numero disponibile.