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

Guida introduttiva a Notify

Questo tutorial ti guida nella creazione di una configurazione di notifica e nell'invio del tuo primo messaggio OTP. Puoi completare questo tutorial in circa 5 minuti.

Prerequisiti

La seguente policy IAM concede le autorizzazioni per inviare messaggi e sfogliare i modelli:

{
    "Version": "2012-10-17", 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "sms-voice:SendNotifyTextMessage",
                "sms-voice:SendNotifyVoiceMessage",
                "sms-voice:DescribeNotifyTemplates",
                "sms-voice:DescribeNotifyConfigurations",
                "sms-voice:ListNotifyCountries",
                "sms-voice:PutMessageFeedback"
            ],
            "Resource": "*"
        }
    ]
}

La seguente politica concede le autorizzazioni complete per la gestione delle notifiche:

{
    "Version": "2012-10-17", 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "sms-voice:CreateNotifyConfiguration",
                "sms-voice:UpdateNotifyConfiguration",
                "sms-voice:DeleteNotifyConfiguration",
                "sms-voice:DescribeNotifyConfigurations",
                "sms-voice:DescribeNotifyTemplates",
                "sms-voice:ListNotifyCountries",
                "sms-voice:SendNotifyTextMessage",
                "sms-voice:SendNotifyVoiceMessage",
                "sms-voice:SetNotifyMessageSpendLimitOverride",
                "sms-voice:DeleteNotifyMessageSpendLimitOverride",
                "sms-voice:PutMessageFeedback"
            ],
            "Resource": "*"
        }
    ]
}

Per limitare le autorizzazioni a una configurazione Notify specifica, utilizza l'ARN di configurazione per azioni a livello di risorsa (SendNotifyTextMessagecomeSendNotifyVoiceMessage,,,, DescribeNotifyConfigurations e). CreateNotifyConfiguration UpdateNotifyConfiguration DeleteNotifyConfiguration Le azioni che non supportano le autorizzazioni a livello di risorsa (come,,, e) richiedono. DescribeNotifyTemplates ListNotifyCountries SetNotifyMessageSpendLimitOverride DeleteNotifyMessageSpendLimitOverride PutMessageFeedback "Resource": "*"

Passaggio 1: creare una configurazione di notifica

Console

1. Apri la console SMS di messaggistica con l'utente AWS finale all'indirizzo https://console.aws.amazon.com/sms-voice/.

2. Nel riquadro di navigazione, in Notifica, scegli Notifica configurazioni.

3. Scegli Crea configurazione di notifica.

4. Per Display name, inserisci il nome del tuo marchio (ad esempio,AcmeCorp).

5. Per Use case, la verifica del codice viene selezionata automaticamente.

6. Per Canali, seleziona SMS, VOICE o entrambi.

7. (Facoltativo) Espandi le impostazioni avanzate per selezionare i paesi, un modello predefinito, un pool associato o abilitare la protezione dall'eliminazione.

8. Scegli Crea configurazione Notifica.

La configurazione viene creata con lo stato In sospeso mentre il sistema convalida l'account. Una volta convalidata, lo stato diventa Attivo e puoi iniziare a inviare messaggi.

Nota

La creazione della configurazione include la convalida automatica dell'account e il controllo del nome del marchio. La maggior parte delle configurazioni viene attivata in pochi secondi. Se il nome del marchio richiede una verifica, lo stato sarà Richiede verifica.

AWS CLI

aws pinpoint-sms-voice-v2 create-notify-configuration \
    --display-name "AcmeCorp" \
    --use-case CODE_VERIFICATION \
    --enabled-channels SMS

Stati di configurazione:

Passaggio 2: sfoglia i modelli disponibili

Prima di inviarli, controlla quali modelli sono disponibili per il tuo livello e canale:

aws pinpoint-sms-voice-v2 describe-notify-templates \
    --filters '[{"Name":"channels","Values":["SMS"]},{"Name":"tier-access","Values":["BASIC"]}]'

Passaggio 3: invia un messaggio di prova

Console

1. Nell'elenco Notifica le configurazioni, scegli la tua configurazione.

2. Seleziona la scheda Test.

3. Seleziona un modello dalla tabella dei modelli.

4. Per Numero di telefono di destinazione, inserisci un numero di telefono in formato E.164 (ad esempio,+12065550100).

5. Inserisci le variabili del modello (ad esempio, inserisci 123456 la variabile di codice).

6. Scegli Invia.

AWS CLI

aws pinpoint-sms-voice-v2 send-notify-text-message \
    --notify-configuration-id "nc-1234567890abcdef0" \
    --destination-phone-number "+12065550100" \
    --template-id "notify-code-verification-english-001" \
    --template-variables '{"code":"123456"}'

Python (boto3)

import boto3

client = boto3.client('pinpoint-sms-voice-v2')

response = client.send_notify_text_message(
    NotifyConfigurationId='nc-1234567890abcdef0',
    DestinationPhoneNumber='+12065550100',
    TemplateId='notify-code-verification-english-001',
    TemplateVariables={
        'code': '123456'
    }
)

print(f"Message ID: {response['MessageId']}")
print(f"Resolved body: {response['ResolvedMessageBody']}")

Fase 4: Controlla i paesi disponibili

Usa ListNotifyCountries per vedere quali paesi sono disponibili per il tuo livello e canale:

aws pinpoint-sms-voice-v2 list-notify-countries \
    --channels SMS \
    --tier BASIC

Fasi successive