Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Commencer à utiliser Notify
Ce didacticiel vous explique comment créer une configuration Notify et envoyer votre premier message OTP. Vous pouvez terminer ce didacticiel en 5 minutes environ.
## Conditions préalables
+ Un Compte AWS.
+ Autorisations IAM pour les opérations de messagerie SMS à l'utilisateur AWS final. Pour de plus amples informations, veuillez consulter [Gestion des identités et des accès pour les messages SMS destinés aux utilisateurs AWS finaux](security-iam.md).
La politique IAM suivante accorde des autorisations pour envoyer des messages et parcourir les modèles :
```
{
"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 politique suivante accorde des autorisations complètes de gestion des notifications :
```
{
"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": "*"
}
]
}
```
Pour limiter les autorisations à une configuration Notify spécifique, utilisez l'ARN de configuration pour les actions au niveau des ressources (telles que`SendNotifyTextMessage`,`SendNotifyVoiceMessage`,`DescribeNotifyConfigurations`, `CreateNotifyConfiguration``UpdateNotifyConfiguration`, et`DeleteNotifyConfiguration`). Les actions qui ne prennent pas en charge les autorisations au niveau des ressources (telles que`DescribeNotifyTemplates`,`ListNotifyCountries`, `SetNotifyMessageSpendLimitOverride``DeleteNotifyMessageSpendLimitOverride`, et`PutMessageFeedback`) nécessitent. `"Resource": "*"`
## Étape 1 : Création d'une configuration Notify
------
#### [ Console ]
1. Ouvrez la console SMS de messagerie de l'utilisateur AWS final à l'adresse [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. Dans le volet de navigation, sous **Notifier**, choisissez **Notifier les configurations**.
1. Choisissez **Créer une configuration de notification**.
1. Dans **Nom d'affichage**, entrez le nom de votre marque (par exemple,`AcmeCorp`).
1. Pour le **cas d'utilisation**, la **vérification du code** est automatiquement sélectionnée.
1. Pour les **chaînes**, sélectionnez **SMS**, **VOICE** ou les deux.
1. (Facultatif) Développez **les paramètres avancés** pour sélectionner des pays, un modèle par défaut, un pool associé ou activez la protection contre les suppressions.
1. Choisissez **Créer une configuration de notification**.
Votre configuration est créée dans le statut **En attente** pendant que le système valide votre compte. Une fois validé, le statut passe à **Actif** et vous pouvez commencer à envoyer des messages.
**Note**
La création de configuration inclut la validation automatique des comptes et la vérification du nom de marque. La plupart des configurations sont activées en quelques secondes. Si le nom de votre marque doit être vérifié, le statut sera **Nécessite une vérification**.
------
#### [ AWS CLI ]
```
aws pinpoint-sms-voice-v2 create-notify-configuration \
--display-name "AcmeCorp" \
--use-case CODE_VERIFICATION \
--enabled-channels SMS
```
------
Statuts de configuration :
PENDING
La configuration est en cours de validation.
ACTIF
Prêt à envoyer des messages.
NÉCESSITE UNE VÉRIFICATION
Le nom de marque doit être vérifié avant l'activation.
REFUSÉE
La configuration a été rejetée. Vérifiez `RejectionReason` les détails.
## Étape 2 : Parcourez les modèles disponibles
Avant d'envoyer, vérifiez quels modèles sont disponibles pour votre niveau et votre chaîne :
```
aws pinpoint-sms-voice-v2 describe-notify-templates \
--filters '[{"Name":"channels","Values":["SMS"]},{"Name":"tier-access","Values":["BASIC"]}]'
```
## Étape 3 : Envoyer un message de test
------
#### [ Console ]
1. Dans la liste Notifier les configurations, choisissez votre configuration.
1. Choisissez l’onglet **Test**.
1. Sélectionnez un modèle dans le tableau des modèles.
1. Pour **Numéro de téléphone de destination**, entrez un numéro de téléphone au format E.164 (par exemple,`+12065550100`).
1. Renseignez les variables du modèle (par exemple, entrez `123456` la variable de **code**).
1. Sélectionnez **Send (Envoyer)**.
------
#### [ 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']}")
```
------
## Étape 4 : Vérifiez les pays disponibles
`ListNotifyCountries`À utiliser pour voir quels pays sont disponibles pour votre niveau et votre chaîne :
```
aws pinpoint-sms-voice-v2 list-notify-countries \
--channels SMS \
--tier BASIC
```
## Étapes suivantes
+ [Gestion des configurations Notify](notify-configurations.md)— Découvrez toutes les options de configuration.
+ [Utilisation des modèles Notify](notify-templates.md)— Parcourez et comprenez les modèles disponibles.
+ [Notifier les niveaux](notify-tiers.md)— Découvrez les niveaux et comment passer à la version avancée.
+ [Notifier les limites de dépenses](notify-spend-limits.md)— Gérez vos limites de dépenses Notify.