Comment puis-je configurer la journalisation des messages vocaux de la messagerie utilisateur AWS final avec Amazon Pinpoint ?

Résolution

Pour enregistrer le statut des messages vocaux Amazon Pinpoint, créez un jeu de configuration et la destination de l'événement. Puis, mappez la destination de l'événement à votre jeu de configuration. Utilisez la configuration pour recevoir les informations de réponse pour les messages vocaux que vous envoyez via Amazon Pinpoint.

Vous pouvez configurer les ressources AWS suivantes en tant que destinations d'événements vocaux Amazon Pinpoint :

• Rubriques Amazon Simple Notification Service (Amazon SNS)
• Amazon CloudWatch Logs
• Flux de diffusion Amazon Data Firehose

Pour configurer la destination d'un événement, utilisez les API de messagerie utilisateur AWS final ou l'un des kits SDK AWS.

Remarque : la configuration de journalisation des messages vocaux suivante s'applique uniquement à la messagerie utilisateur AWS final. Pour SMS and Voice v1, consultez la section Comment puis-je configurer la journalisation des messages vocaux Amazon Pinpoint pour l'API Amazon Pinpoint SMS and Voice v1 ?

Configurer une rubrique Amazon SNS en tant que destination d'événement vocal Amazon Pinpoint

Remarque : si des erreurs surviennent lorsque vous exécutez des commandes de l'interface de la ligne de commande AWS (AWS CLI), consultez la section Résoudre des erreurs liées à l’AWS CLI. Vérifiez également que vous utilisez bien la version la plus récente de l’AWS CLI.

Procédez comme suit :

1. Pour créer un jeu de configuration, exécutez la commande create-configuration-set :

   aws pinpoint-sms-voice-v2 create-configuration-set --configuration-set-name VoiceSNS

   Remarque : remplacez VoiceSNS par le nom du jeu de configuration.

2. Abonnez le point de terminaison pour lequel vous souhaitez journaliser des messages vocaux à une rubrique Amazon SNS. La rubrique SNS peut être une nouvelle rubrique ou une rubrique existante.

3. Ajoutez les autorisations suivantes à votre politique d'accès aux rubriques SNS pour permettre au service vocal de messagerie SMS pour utilisateurs finaux AWS de diffuser des journaux :

   {
     "Effect": "Allow",
     "Principal": {
       "Service": "sms-voice.amazonaws.com"
     },
     "Action": "sns:Publish",
     "Resource": "arn:aws:sns:us-east-1:ACCOUNT_ID:pinpointsmsvoice",
     "Condition": {
       "StringEquals": {
         "aws:SourceAccount": "ACCOUNT_ID"
       },
       "ArnLike": {
         "aws:SourceArn": "arn:aws:sms-voice:us-east-1:ACCOUNT_ID:configuration-set/VoiceSNS"
       }
     }
   }

   Remarque : remplacez us-east-1 par votre région AWS, pinpointsmsvoice par le nom de votre rubrique SNS et ACCOUNT_ID par votre ID de compte AWS.

4. Dans un éditeur de texte, créez un fichier de requête d'entrée nommé matching.json pour MatchingEventTypes. Spécifiez les événements que vous souhaitez recevoir, ou spécifiez « TOUT » pour recevoir tous les événements :

   [
   "ALL"
   ]

5. Pour mapper la destination de l'événement à configuration-set-name, exécutez la commande create-event-destination :

   aws pinpoint-sms-voice-v2 create-event-destination --configuration-set-name VoiceSNS --event-destination-name VoiceSNS --matching-event-types file://matching.json --sns-destination TopicArn=arn:aws:sns:us-east-1:ACCOUNT_ID:pinpointsmsvoice

   Remarque : remplacez us-east-1 par votre région, ACCOUNT_ID par votre ID de compte et pinpointsmsvoice par le nom de votre rubrique SNS.

6. Pour tester la configuration, utilisez l'opération d'API V2 SendVoiceMessage pour envoyer un message vocal Amazon Pinpoint. L'événement apparaît dans le point de terminaison abonné à la rubrique SNS au bout de quelques minutes.

Configurer CloudWatch Logs en tant que destination d'événement vocal Amazon Pinpoint

Procédez comme suit :

1. Pour créer un jeu de configuration, exécutez la commande create-configuration-set :

   aws pinpoint-sms-voice-v2 create-configuration-set --configuration-set-name VoiceCW

   Remarque : remplacez VoiceKinesis par le nom de votre jeu de configuration.

2. Pour créer un groupe de journaux, exécutez la commande create-log-group :

   aws logs create-log-group --log-group-name /aws/pinpoint/voice

   Remarque : remplacez log-group-name par le nom du groupe de journaux. Dans la sortie de la commande, notez l’Amazon Resource Name (ARN) du groupe de journaux à utiliser ultérieurement. Si vous utilisez un groupe de journaux existant, appelez l'opération d'API LogGroup pour obtenir l'ARN.

3. Créez un nouveau rôle Gestion des identités et des accès AWS (AWS IAM) que le service Amazon Pinpoint devra assumer.

4. Mettez à jour la politique d’approbation des rôles IAM à l'aide de l’instruction suivante pour permettre au service vocal SMS d'assumer le rôle IAM :

   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Effect": "Allow",
         "Principal": {
           "Service": "sms-voice.amazonaws.com"
         },
         "Action": "sts:AssumeRole",
         "Condition": {
           "StringEquals": {
             "aws:SourceAccount": "ACCOUNT_ID"
           },
           "ArnLike": {
             "aws:SourceArn": "arn:aws:sms-voice:us-east-1:ACCOUNT_ID:configuration-set/VoiceCW"
           }
         }
       }
     ]
   }

   Remarque : remplacez us-east-1 par votre région, ACCOUNT_ID par votre identifiant de compte et VoiceCW par votre configuration définie.

5. Mettez à jour la stratégie d'autorisations de rôle IAM avec l’instruction suivante :

   {    "Version": "2012-10-17",
       "Statement": [
           {
               "Effect": "Allow",
               "Action": [
                   "logs:CreateLogStream",
                   "logs:DescribeLogStreams",
                   "logs:PutLogEvents"
               ],
               "Resource": [
                   "arn:aws:logs:us-east-1:ACCOUNT_ID:log-group:/aws/pinpoint/voice:*"
               ]
           }
       ]
   }

   Remarque : remplacez us-east-1 par votre région, ACCOUNT_ID par votre identifiant de compte. Cette instruction d'autorisations accorde des autorisations pour appeler des opérations spécifiques de l'API CloudWatch Logs. Pour plus d'informations, consultez la référence sur les autorisations de CloudWatch Logs.

6. Dans un éditeur de texte, créez un fichier de requête d'entrée nommé CloudWatchDestination.json. Puis, saisissez les paramètres de destination suivants dans le fichier :

   `{   "IamRoleArn": "arn:aws:iam::ACCOUNT_ID:role/IAM_ROLE",   "LogGroupArn": "arn:aws:logs:us-east-1:ACCOUNT_ID:log-group:/aws/pinpoint/voice" }`

   Remarque : remplacez la valeur de IamRoleArn par l'ARN de votre rôle IAM. Remplacez la valeur de LogGroupArn par l'ARN du groupe de journaux CloudWatch auquel vous souhaitez envoyer des événements.

7. Dans un éditeur de texte, créez un fichier de requête d'entrée nommé matching.json pour MatchingEventTypes. Spécifiez les événements que vous souhaitez recevoir, ou spécifiez « TOUT » pour recevoir tous les événements :

   [
   "ALL"
   ]

8. Exécutez la commande create-event-destination pour mapper la destination de l’événement à configuration-set-name :

   aws pinpoint-sms-voice-v2 create-event-destination --configuration-set-name VoiceCW --event-destination-name CloudWatch_Destination --matching-event-types file://matching.json --cloud-watch-logs-destination file://CloudWatchDestination.json

   Remarque : Remplacez VoiceCW par n'importe quel nom pour votre jeu de configuration.

9. Pour tester la configuration, utilisez l'opération d'API V2 SendVoiceMessage pour envoyer un message vocal Amazon Pinpoint. L'événement apparaît dans le groupe de journaux CloudWatch au bout de quelques minutes.

Configurer un flux de diffusion Firehose en tant que destination d'événement vocal Amazon Pinpoint

Procédez comme suit :

1. Pour créer un jeu de configuration, exécutez la commande create-configuration-set :

   aws pinpoint-sms-voice-v2 create-configuration-set --configuration-set-name VoiceKinesis

   Remarque : remplacez VoiceKinesis par le nom du jeu de configuration.

2. Créez un flux de diffusion Firehose et notez l'ARN du flux de diffusion. Pour Paramètre Destination, sélectionnez Amazon Simple Storage Service (Amazon S3).

3. Créez un nouveau rôle IAM que le service Amazon Pinpoint endossera.

4. Mettez à jour la stratégie d’approbation de rôle IAM avec l’instruction d’autorisations suivante dans la section principale de la stratégie :

   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Effect": "Allow",
         "Principal": {
           "Service": "sms-voice.amazonaws.com"
         },
         "Action": "sts:AssumeRole",
         "Condition": {
           "StringEquals": {
             "aws:SourceAccount": "ACCOUNT_ID"
           },
           "ArnLike": {
             "aws:SourceArn": "arn:aws:sms-voice:us-east-1:ACCOUNT_ID:configuration-set/VoiceKinesis"
           }
         }
       }
     ]
   }

   Remarque : remplacez us-east-1 par votre région, ACCOUNT_ID par votre identifiant de compte. Cette stratégie permet au service vocal SMS d'endosser le rôle IAM.

5. Mettez à jour la stratégie d'autorisations de rôle IAM pour inclure l'ARN du flux de diffusion Firehose :

   {    "Version": "2012-10-17",
       "Statement": [
           {
               "Effect": "Allow",
               "Action": "firehose:PutRecord",
               "Resource": "arn:aws:firehose:us-east-1:ACCOUNT_ID:deliverystream/KINESIS_FIREHOSE_NAME"
           }
       ]
   }

   Remarque : remplacez ACCOUNT_ID par votre ID de compte et KINESIS_FIREHOSE_NAME par le nom de l'ARN de votre flux de diffusion Firehose.

6. Dans un éditeur de texte, créez un fichier de requête d'entrée nommé KinesisFirehoseDestination.json. Puis, copiez et collez les paramètres de destination suivants dans le fichier :

   {    "IamRoleArn": "arn:aws:iam::ACCOUNT_ID:role/IAM_ROLE",
       "DeliveryStreamArn": "arn:aws:firehose:us-east-1:ACCOUNT_ID:deliverystream/KINESIS_FIREHOSE_NAME"
   }

   Remarque : remplacez us-east-1 par votre région AWS, ACCOUNT_ID par votre ID de compte, KINESIS_FIREHOSE_NAME par le nom du flux de diffusion Firehose et IAM_ROLE par le nom du rôle IAM.

7. Dans un éditeur de texte, créez un fichier de requête d'entrée nommé matching.json pour MatchingEventTypes. Spécifiez les événements que vous souhaitez recevoir, ou spécifiez « TOUT » pour recevoir tous les événements :

   [
   "ALL"
   ]

8. Pour mapper la destination de l'événement à configuration-set-name, exécutez la commande create-event-destination avec un fichier de requête d'entrée.

   aws pinpoint-sms-voice-v2 create-event-destination --configuration-set-name VoiceKinesis --event-destination-name KinesisFirehose_Destination --matching-event-types file://matching.json --kinesis-firehose-destination file://KinesisFirehoseDestination.json

   Remarque : remplacez VoiceKinesis par le nom de votre jeu de configuration.

9. Pour tester la configuration, utilisez l'opération d'API V2 SendVoiceMessage pour envoyer un message vocal Amazon Pinpoint. Au bout de quelques minutes, l’événement apparaît dans le compartiment Amazon S3 que vous avez configuré lors de la création du flux Kinesis Data Firehose.