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
+ Un Account AWS.
+ Autorizzazioni IAM per le operazioni SMS di messaggistica con l'utente AWS finale. Per ulteriori informazioni, consulta [Gestione delle identità e degli accessi per AWS gli SMS di messaggistica con l'utente finale](security-iam.md).
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 (`SendNotifyTextMessage`come`SendNotifyVoiceMessage`,,,, `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/](https://console.aws.amazon.com/sms-voice/).
1. Nel riquadro di navigazione, in **Notifica**, scegli **Notifica configurazioni.**
1. Scegli **Crea configurazione di notifica**.
1. Per **Display name**, inserisci il nome del tuo marchio (ad esempio,`AcmeCorp`).
1. Per **Use case**, **la verifica del codice** viene selezionata automaticamente.
1. Per **Canali**, seleziona **SMS**, **VOICE** o entrambi.
1. (Facoltativo) Espandi **le impostazioni avanzate** per selezionare i paesi, un modello predefinito, un pool associato o abilitare la protezione dall'eliminazione.
1. 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:
IN ATTESA
La configurazione è in fase di convalida.
ACTIVE
Pronto per inviare messaggi.
RICHIEDI\$1VERIFICA
Il nome del marchio richiede la verifica prima dell'attivazione.
REJECTED
La configurazione è stata rifiutata. Controlla `RejectionReason` i dettagli.
## 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.
1. Seleziona la scheda **Test**.
1. Seleziona un modello dalla tabella dei modelli.
1. Per **Numero di telefono di destinazione**, inserisci un numero di telefono in formato E.164 (ad esempio,`+12065550100`).
1. Inserisci le variabili del modello (ad esempio, inserisci `123456` la variabile di **codice**).
1. 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
+ [Gestione delle configurazioni di notifica](notify-configurations.md)— Scopri tutte le opzioni di configurazione.
+ [Utilizzo dei modelli di notifica](notify-templates.md)— Esplora e comprendi i modelli disponibili.
+ [Notifica i livelli](notify-tiers.md)— Scopri di più sui livelli e su come passare alla versione Advanced.
+ [Notifica i limiti di spesa](notify-spend-limits.md)— Gestisci i limiti di spesa di Notify.