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 criteri di immissione, ad esempio se sono necessarie funzionalità SMS e/o 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.

• Codici brevi:Richiesta di codici brevi per la messaggistica SMS con Amazon Pinpoint SMS.

• Codici lunghi —Richiesta di codici lunghi dedicati per la messaggistica SMS con Amazon Pinpoint SMS.

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

Request a phone number (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 a cui verranno inviati i messaggi dal menu a discesa. Seleziona Avanti.

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

   • In Funzionalità del numero scegli SMS, Voce o entrambi a seconda delle tue esigenze.

     Importante

     Le funzionalità per SMS e voce non possono essere modificate una volta acquistato il numero di telefono.

     • SMS: scegli se hai bisogno di funzionalità SMS.

     • Voce (da testo ad audio): scegli se hai bisogno di funzionalità vocali.

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

   • Alla voce 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 resusciteranno i messaggi SMS.

   • Alla voce messaggistica bidirezionale scegli Sì se desideri la messaggistica bidirezionale.

5. Seleziona Avanti.

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.

   Se scegli 10 DLC e hai già una campagna registrata, puoi scegliere la campagna dalla campagna Associata alla campagna registrata per aggiungere il numero di telefono dei 10 DLC alla campagna da 10 DLC.

   Se il tipo di numero che desideri non è disponibile, puoi scegliere Indietro per tornare indietro e modificare il tuo caso d'uso. Controlla anche che Regioni e paesi supportati (canale SMS) il tipo di mittente che desideri sia supportato nel paese di destinazione.

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

7. Seleziona Avanti.

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

9. A seconda del tipo di numero di telefono richiesto, potrebbe apparire una finestra Registrazione obbligatoria. 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, vedereRegistrazioni.

   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, vedere. Registrazioni

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 anche richiedere un numero di telefono da utilizzare per inviare sia SMS che messaggi vocali specificando SMS 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. Processo 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": "[phone]",
    "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, consultaRegioni e paesi supportati (canale 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 del 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 i numeri in base al paese del numero di telefono o in base alle sue funzionalità, ovvero se supporta SMS o messaggi vocali oppure entrambi.

Per visualizzare un elenco filtrato di numeri di telefono utilizzando il 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 e VOICE.

• number-type: tipo di numero di telefono, ad esempio LONG_CODE, SHORT_CODE o TOLL_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 del numero di telefono
• Richiesta di codici brevi per la messaggistica SMS con Amazon Pinpoint SMS
• Richiesta di codici lunghi dedicati per la messaggistica SMS con Amazon Pinpoint SMS

Stato del numero di telefono

Quando acquisti per la prima volta un numero di telefono, 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.

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. Nei numeri di telefono lo stato del numero di telefono è elencato nella colonna Stato del numero.

   • PENDING— Il numero di telefono non è pronto per l'uso. Potrebbe essere necessario registrare il numero di telefono. Per ulteriori informazioni, consulta Registrazioni.

   • ACTIVE— Il numero di telefono è pronto per l'uso.