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

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 queSendNotifyTextMessage,SendNotifyVoiceMessage,DescribeNotifyConfigurations, CreateNotifyConfigurationUpdateNotifyConfiguration, etDeleteNotifyConfiguration). Les actions qui ne prennent pas en charge les autorisations au niveau des ressources (telles queDescribeNotifyTemplates,ListNotifyCountries, SetNotifyMessageSpendLimitOverrideDeleteNotifyMessageSpendLimitOverride, etPutMessageFeedback) 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/.

2. Dans le volet de navigation, sous Notifier, choisissez Notifier les configurations.

3. Choisissez Créer une configuration de notification.

4. Dans Nom d'affichage, entrez le nom de votre marque (par exemple,AcmeCorp).

5. Pour le cas d'utilisation, la vérification du code est automatiquement sélectionnée.

6. Pour les chaînes, sélectionnez SMS, VOICE ou les deux.

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

8. 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 :

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

2. Choisissez l’onglet Test.

3. Sélectionnez un modèle dans le tableau des modèles.

4. Pour Numéro de téléphone de destination, entrez un numéro de téléphone au format E.164 (par exemple,+12065550100).

5. Renseignez les variables du modèle (par exemple, entrez 123456 la variable de code).

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