Richiedi un numero di telefono - SMS Amazon Pinpoint
Stato e funzionalità del numero 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à.

Richiedi un numero di telefono

Utilizzando la console Amazon Pinpoint SMS, ti consigliamo una delle seguenti identità di origine a seconda del tuo caso d'uso. I consigli si basano sui tuoi criteri di immissione, ad esempio se hai bisogno di SMS, MMS e/o funzionalità vocali, un numero bidirezionale e una stima dei messaggi mensili.

Nota

I seguenti tipi di numeri di telefono devono essere richiesti nella console del Support Center.

Puoi utilizzare la console Amazon Pinpoint SMS o richiedere un nuovo numero AWS CLI di telefono.

Request a phone number (Console)
Importante

Per richiedere un nuovo numero di telefono per gli Stati Uniti tramite la console Pinpoint SMS, segui le istruzioni nella scheda Richiedi un numero di telefono per gli Stati Uniti (Console).

Per richiedere un numero di telefono tramite la console Amazon Pinpoint SMS, attieniti alla seguente procedura:

Richiesta di un numero di telefono (Console)

  1. Apri la console Amazon Pinpoint 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 paese devi scegliere il Paese di destinazione del messaggio dal menu a discesa a cui verranno inviati i messaggi. Seleziona Successivo.

  4. Nella sezione Caso d'uso della messaggistica inserisci quanto segue:

    • In Funzionalità numeriche, scegli una combinazione qualsiasi di funzionalità disponibili:

      Importante

      Le funzionalità per SMS, MMS e voce non possono essere modificate dopo l'acquisto del numero di telefono.

      • Messaggi di testo (SMS) Scegli questa opzione se hai bisogno di funzionalità SMS.

      • Messaggi di testo e multimediali (SMS, MMS): scegli questa opzione se hai bisogno di funzionalità SMS e/o MMS.

        Nota

        Le funzionalità MMS sono disponibili solo in alcuni paesi e sono supportate solo su determinati tipi di origine. I messaggi di testo e multimediali (SMS, MMS) sono presenti solo se MMS è supportato nel Paese di destinazione dei messaggi. Per ulteriori informazioni, consulta Paesi e regioni supportati per la messaggistica MMS e Scelta di un numero di telefono o di un ID mittente.

      • Messaggi da testo a audio (voce): scegli questa opzione se hai bisogno di funzionalità vocali.

    • In Volume mensile stimato di messaggi: facoltativo, scegli il numero stimato di messaggi SMS che invierai ogni mese.

    • Per la sede centrale dell'azienda, facoltativo, scegli una delle seguenti opzioni:

      • Locale: scegli questa opzione se la sede centrale della tua azienda si trova nello stesso paese in cui risiedono i tuoi clienti, che ripristineranno i messaggi SMS. Ad esempio, scegli questa opzione se la tua sede centrale si trova negli Stati Uniti e anche gli utenti che riceveranno i messaggi si trovano negli Stati Uniti.

      • Internazionale: scegli questa opzione se la sede centrale della tua azienda non si trova nello stesso paese dei tuoi clienti, che daranno nuova vita ai messaggi SMS.

    • Per la messaggistica bidirezionale, scegli Sì se desideri la messaggistica bidirezionale.

  5. Seleziona Successivo.

  6. In Seleziona il tipo di mittente, scegli il tipo di numero di telefono consigliato o uno dei tipi di numero disponibili. Le opzioni disponibili si basano sulle informazioni sui casi d'uso inserite nei passaggi precedenti.

  7. Seleziona Successivo.

  8. In Verifica e richiedi puoi verificare e modificare la richiesta prima di inviarla. Scegli Richiedi.

  9. Potrebbe apparire una finestra di registrazione obbligatoria a seconda del tipo di numero di telefono richiesto. Il tuo numero di telefono o ID mittente è associato a questa registrazione e non puoi inviare messaggi finché la registrazione non viene approvata. Per ulteriori informazioni sui requisiti di registrazione, consultaRegistrazioni.

    1. Per Nome del modulo di registrazione, inserisci un nome descrittivo.

    2. Scegli Inizia la registrazione per completare la registrazione del numero di telefono o Registrati più tardi.

      Importante

      Il tuo numero di telefono o ID mittente non può inviare messaggi finché la registrazione non viene approvata.

      Ti verrà comunque addebitato il canone di locazione mensile ricorrente per il numero di telefono indipendentemente dallo stato della registrazione. Per ulteriori informazioni sui requisiti di registrazione, vedere. Registrazioni

Request a phone number for the United States (Console)
Importante

Segui queste indicazioni per richiedere un nuovo numero di telefono per gli Stati Uniti tramite la console Pinpoint SMS.

Prima di richiedere un numero di telefono da 10 DLC, devi avere un marchio registrato approvato da 10 DLC e una campagna registrata da 10 DLC da associare al numero di telefono dei 10 DLC. Per ulteriori informazioni sulla registrazione di un marchio registrato da 10 DLC e di una campagna registrata da 10 DLC, consulta e. Modulo di registrazione del marchio 10DLC Modulo di registrazione alla campagna 10DLC

Le funzionalità di messaggistica (SMS, MMS o VOICE) sono specificate nella campagna di registrazione ai 10 DLC e applicate alla richiesta di numero di telefono da parte dell'utente.

Richiedi un numero di telefono per gli Stati Uniti (Console)

  1. Apri la console Amazon Pinpoint 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 paese devi scegliere Stati Uniti (USA) dal menu a discesa Paese di destinazione del messaggio. Seleziona Successivo.

  4. Nella sezione Caso d'uso della messaggistica inserisci quanto segue:

    • In Volume mensile stimato di messaggi: facoltativo, scegli il numero stimato di messaggi SMS che invierai ogni mese.

    • Per la sede centrale dell'azienda, facoltativo, scegli una delle seguenti opzioni:

      • Locale: scegli questa opzione se la sede centrale della tua azienda si trova nello stesso paese in cui risiedono i tuoi clienti, che ripristineranno i messaggi SMS. Ad esempio, scegli questa opzione se la tua sede centrale si trova negli Stati Uniti e anche gli utenti che riceveranno i messaggi si trovano negli Stati Uniti.

      • Internazionale: scegli questa opzione se la sede centrale della tua azienda non si trova nello stesso paese dei tuoi clienti, che daranno nuova vita ai messaggi SMS.

    • Per la messaggistica bidirezionale, scegli Sì se desideri la messaggistica bidirezionale.

  5. Seleziona Successivo.

  6. In Tipo di mittente, scegli il tipo di numero di telefono consigliato o uno dei tipi di numero disponibili. Le opzioni disponibili si basano sulle informazioni sui casi d'uso inserite nei passaggi precedenti.

    • Per un numero di telefono da 10 DLC devi scegliere il marchio registrato e la campagna registrata da associare alla richiesta del numero di telefono dei 10 DLC.

      • Usa Associa a marchio registrato per scegliere un marchio.

      • Usa Associa alla campagna registrata per scegliere una campagna.

    • Se desideri richiedere un codice breve o un codice lungo, devi aprire una custodia con AWS Support. Per ulteriori informazioni, consulta Come richiedere codici brevi per la messaggistica e Richiesta di codici lunghi dedicati per la messaggistica.

  7. Seleziona Successivo.

  8. In Verifica e richiedi puoi verificare e modificare la richiesta prima di inviarla. Scegli Richiedi.

  9. Potrebbe apparire una finestra di registrazione obbligatoria a seconda del tipo di numero di telefono richiesto. Il tuo numero di telefono o ID mittente è associato a questa registrazione e non puoi inviare messaggi finché la registrazione non viene approvata. Per ulteriori informazioni sui requisiti di registrazione, consultaRegistrazioni.

    1. Per Nome del modulo di registrazione, inserisci un nome descrittivo.

    2. Scegli Inizia la registrazione per completare la registrazione del numero di telefono o Registrati più tardi.

      Importante

      Il tuo numero di telefono o ID mittente non può inviare messaggi finché la registrazione non viene approvata.

      Ti verrà comunque addebitato il canone di locazione mensile ricorrente per il numero di telefono indipendentemente dallo stato della registrazione. Per ulteriori informazioni sui requisiti di registrazione, vedere. Registrazioni

Request a phone number (AWS CLI)

Puoi usare il request-phone-numbercomando per aggiungere nuovi numeri di telefono al tuo account. La disponibilità dei numeri di telefono e le funzionalità supportate variano in base al paese.

Importante

Potrebbe essere necessario registrare il numero di telefono o l'ID del mittente dopo aver completato la richiesta. Ti verrà comunque addebitato il canone di locazione mensile ricorrente per il numero di telefono indipendentemente dallo stato della registrazione. Per ulteriori informazioni sui requisiti di registrazione, consulta. Registrazioni

Le funzionalità MMS sono disponibili solo in alcuni Paesi. Per ulteriori informazioni sui paesi supportati per SMS e MMS, consulta Paesi e regioni supportati per la messaggistica SMS e. Paesi e regioni supportati per la messaggistica MMS

Per richiedere un numero di telefono

  • Nella riga di comando, inserisci il comando seguente:

    $ aws pinpoint-sms-voice-v2 request-phone-number \
> --iso-country-code XX \
> --message-type TRANSACTIONAL \
> --number-capabilities VOICE \
> --number-type LONG_CODE \
> --pool-id poolId \
> --deletion-protection-enabled \
> --opt-out-list-name optOutListName \
> --registration-id CO123EX

    Nel comando precedente, apporta le modifiche seguenti:

    • Sostituisci XX con il codice ISO-3166 alpha-2 a due caratteri per il paese del numero di telefono, ad esempio CA per il Canada.

    • Se desideri utilizzare il numero di telefono per inviare contenuti promozionali o di marketing, sostituisci TRANSACTIONAL con PROMOTIONAL. In caso contrario, utilizzare TRANSACTIONAL.

    • Se desideri richiedere un numero di telefono per l'invio di messaggi SMS, sostituisci VOICE con SMS. Puoi richiedere un numero di telefono con funzionalità SMS, MMS e messaggi vocali specificando. SMS MMS VOICE

    • Sostituisci LONG_CODE con il tipo di numero di telefono che desideri richiedere. I valori accettabili sono LONG_CODE, TOLL_FREE e TEN_DLC.

    • Sostituisci poolId con l'ID o il nome della risorsa Amazon (ARN) del pool a cui desideri aggiungere il numero di telefono. Questo parametro è facoltativo. Se non desideri aggiungere il numero di telefono a un pool, omettere questo parametro.

    • Se desideri abilitare la protezione dall'eliminazione per questo numero di telefono, aggiungi il --deletion-protection-enabled parametro. Per impostazione predefinita, la protezione dall'eliminazione è disabilitata. Se la protezione da eliminazione è abilitata, non puoi eliminare il numero di telefono utilizzando l'ReleasePhoneNumberAPI, a meno che non aggiorni la configurazione del numero di telefono per disabilitare questa funzione.

    • Sostituisci optOutListName con il nome o l'ARN dell'elenco di opt-out che desideri associare al numero di telefono. Questo parametro è facoltativo. Se non desideri associare il numero di telefono a un elenco di opt-out, ometti questo parametro.

    • Se richiedi un numero di telefono da utilizzare per una campagna 10DLC, sostituisci CO123EX con l'ID della campagna 10DLC che desideri utilizzare.

      Nota

      Se intendi utilizzare un numero di telefono 10DLC, devi prima registrare la tua azienda e la tua campagna. Attualmente, l'unico modo per completare questi processi di registrazione è utilizzare la console SMS di Amazon Pinpoint. Per ulteriori informazioni sulla registrazione a 10 DLC, consulta. Procedura di registrazione 10DLC

Se il numero viene aggiunto correttamente al tuo account, verrà visualizzato un output simile al seguente:

{
    "PhoneNumberArn": "arn:aws:sms-voice:us-east-1:111122223333:phone-number/phone-615790209ea34aea8da9b729fexample",
    "PhoneNumberId": "phone-615790209ea34aea8da9b729fexample",
    "PhoneNumber": "+12045550123",
    "Status": "PENDING",
    "IsoCountryCode": "CA",
    "MessageType": "TRANSACTIONAL",
    "NumberCapabilities": [
        "SMS"
    ],
    "NumberType": "LONG_CODE",
    "MonthlyLeasingPrice": "1.00",
    "TwoWayEnabled": false,
    "SelfManagedOptOutsEnabled": false,
    "OptOutListName": "Default",
    "DeletionProtectionEnabled": false,
    "CreatedTimestamp": 1645568542.0
}
Nota

Quando acquisti un numero di telefono per la prima volta, il valore dell'attributo Status è PENDING. Quando il numero di telefono è pronto per l'uso, il valore di Status cambia in ACTIVE.

Se un numero di telefono che soddisfa i parametri specificati non è disponibile, la richiesta ha esito negativo e restituisce un errore.

Modify phone number capabilities (AWS CLI)

Dopo aver richiesto un numero di telefono, puoi utilizzare la update-phone-numberCLI per modificare le impostazioni di quel numero di telefono o per abilitare funzionalità aggiuntive. È possibile modificare diverse impostazioni del numero di telefono, tra cui il pool e l'elenco di opt-out associati al numero di telefono, nonché l'impostazione della protezione dall'eliminazione.

Un esempio di funzionalità aggiuntiva che è possibile abilitare aggiornando un numero di telefono è la messaggistica bidirezionale. Il supporto della messaggistica bidirezionale varia a seconda del paese a cui intendi inviare messaggi. Per un elenco dei paesi supportati, consultaPaesi e regioni supportati per la messaggistica SMS.

$ aws pinpoint-sms-voice-v2 update-phone-number \
> --phone-number-id phone-d2b0f5dd4fd14ebdb2a3b9128example \
> --deletion-protection-enabled true \
> --opt-out-list-name optOutListName \ 
> --self-managed-opt-outs-enabled true \
> --two-way-enabled true \
> --two-way-channel-arn arn:aws:sns:us-east-1:111122223333:MyTopic

Nel comando precedente, procedi come segue.

  • Sostituisci phone-d2b0f5dd4fd14ebdb2a3b9128example con l' PhoneNumberID o l'Amazon Resource Name (ARN) del numero di telefono che desideri aggiornare. Puoi trovare entrambi questi valori utilizzando l'operazione DescribePhoneNumbers.

  • Sostituisci optOutListName con il nome dell'elenco di opt-out che desideri associare a questo numero di telefono.

  • Se desideri disabilitare la funzionalità di protezione dall'eliminazione, modifica il parametro DeletionProtectionEnabled impostando il valore false.

  • Se desideri utilizzare la funzionalità di disattivazione degli SMS autogestita, modifica il valore del parametro in. SelfManagedOptOutsEnabled false

  • Se desideri disabilitare la messaggistica SMS bidirezionale per questo numero di telefono, modifica il valore del parametro in. TwoWayEnabled false

  • Se abiliti la funzionalità di messaggistica bidirezionale per il numero di telefono, devi specificare l'ARN di un argomento Amazon SNS. Sostituisci arn:aws:sns:us-east- 1:111122223333: con l'MyTopicARN dell'argomento Amazon SNS che desideri utilizzare. Quando ricevi messaggi in arrivo, questi vengono inviati all'argomento specificato.

Il parametro PhoneNumberId è l'unico parametro obbligatorio per questo comando. Se non desideri modificare le impostazioni corrispondenti, puoi omettere uno qualsiasi degli altri parametri.

List phone numbers (AWS CLI)

Puoi utilizzarli describe-phone-numbersper ottenere ulteriori informazioni sui numeri di telefono di origine nel tuo account Amazon Pinpoint.

Per elencare tutti i numeri di telefono presenti nel tuo account, utilizza il AWS CLI

  • Nella riga di comando, inserisci il comando seguente:

    $ aws pinpoint-sms-voice-v2 describe-phone-numbers

L'output di questo comando include dettagli su tutti i numeri di telefono nel tuo account. Puoi anche visualizzare informazioni su numeri di telefono specifici includendo il parametro PhoneNumberId.

Per visualizzare informazioni su un numero di telefono specifico, utilizzare il AWS CLI

  • Nella riga di comando, inserisci il comando seguente:

    $ aws pinpoint-sms-voice-v2 describe-phone-numbers \
>  --phone-number-id phone-d2b0f5dd4fd14ebdb2a3b9128example

Nell'esempio precedente, sostituisci phone-d2b0f5dd4fd14ebdb2a3b9128example con l' PhoneNumberID o l'Amazon Resource Name (ARN) del numero di telefono su cui desideri visualizzare ulteriori informazioni.

Puoi anche utilizzare il parametro filter per filtrare l'elenco dei numeri di telefono in base a criteri definiti da te. Ad esempio, puoi filtrare in base al Paese del numero di telefono o in base alle sue funzionalità (ovvero se supporta SMS, MMS, messaggi vocali o tutti).

Per visualizzare un elenco filtrato di numeri di telefono utilizzando AWS CLI

  • Nella riga di comando, inserisci il comando seguente:

    $ aws pinpoint-sms-voice-v2 describe-phone-numbers \
> --filters Name=number-capability,Values=SMS \
> --filters Name=iso-country-code,Values=CA

Il filtro Name può avere uno qualsiasi dei seguenti valori:

  • status: stato attuale del numero di telefono, ad esempio ACTIVE.

  • iso-country-code: codice ISO-3166 alpha-2 a due caratteri del paese del numero di telefono.

  • message-type: tipo di messaggi per il quale il numero di telefono viene utilizzato per l'invio. I valori possibili sono TRANSACTIONAL o PROMOTIONAL.

  • number-capability: canali di messaggistica supportati dal numero di telefono. I valori possibili sono SMS, MMS e VOICE.

  • number-type— Il tipo di numero di telefono, ad esempio LONG_CODESHORT_CODE, oTOLL_FREE.

  • two-way-enabled: valore booleano che indica se la messaggistica SMS bidirezionale è abilitata o meno.

  • self-managed-opt-outs-enabled: valore booleano che indica se le operazioni di opt-out autogestito per la ricezione di SMS sono abilitate.

  • opt-out-list-name: nome dell'elenco di opt-out associato al numero di telefono.

  • deletion-protection-enabled: valore booleano che indica se il numero di telefono può essere eliminato o meno tramite l'operazione DeletePhoneNumber.

Argomenti

Stato e funzionalità del numero di telefono

Questa sezione spiega come verificare lo stato e le funzionalità del tuo numero di telefono.

Stato del numero di telefono

  1. Apri la console Amazon Pinpoint SMS all'indirizzo https://console.aws.amazon.com/sms-voice/.

  2. Nel pannello di navigazione, in Configurazioni, scegli Numeri di telefono.

  3. L'immagine seguente mostra le parti dello stato del numero di telefono.

    Panoramica dello stato del numero di telefono

    • Numero di origine: il numero numerico che i clienti vedono sui loro telefoni.

    • Tipo di origine: il tipo di numero di origine. Può essere un codice lungo, un codice breve o un numero verde.

    • Paese: il paese o la regione da cui viene fornito il numero di origine.

    • Stato del numero: lo stato del numero di origine. Questo può esserePending, Active oAction required.

    • Funzionalità: le funzionalità del numero di origine. Può essere una combinazione di SMSMMS, oVoice.

    • Pool: l'eventuale pool a cui è associato il numero di origine.

    • Data di creazione: l'ora in cui è stato richiesto il numero di origine.

    Quando acquisti un numero di telefono per la prima volta, lo stato del numero di telefono èPENDING. Quando il numero di telefono è pronto per l'uso, lo stato del numero di telefono èACTIVE. Se il numero di telefono richiede la registrazione, questa deve essere completata prima che lo stato del numero di telefono venga modificato inACTIVE.