New user sign up using AWS Builder ID
New user sign up using AWS Builder ID is currently unavailable on re:Post. To sign up, please use the AWS Management Console instead.
Comment puis-je configurer la journalisation des messages vocaux de la messagerie utilisateur AWS final avec Amazon Pinpoint ?
Je souhaite surveiller le statut des messages vocaux que j'envoie via Amazon Pinpoint.
Je souhaite surveiller le statut des messages vocaux que j'envoie via Amazon Pinpoint.
Résolution
Pour enregistrer le statut des messages vocaux Amazon Pinpoint, configurez un jeu de configuration et la destination de l'événement. Puis, mappez la destination de l'événement à votre jeu de configuration. Cette configuration vous permet de recevoir les informations de réponse pour les messages vocaux que vous envoyez via Amazon Pinpoint.
Vous pouvez configurer l'une des 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.
Pour configurer une rubrique Amazon SNS en tant que destination d'événement vocal Amazon Pinpoint, procédez comme suit :
-
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 de votre jeu de configuration.
-
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. Pour utiliser l'AWS CLI afin de créer une nouvelle rubrique Amazon SNS, exécutez la commande create-topic :
aws sns create-topic --name pinpointsmsvoice
-
Ajoutez l'autorisation suivante dans votre stratégie d'accès aux rubriques SNS. Cette stratégie permet au service vocal Messagerie utilisateur AWS final de transmettre 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.
-
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" ]
-
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.
-
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
Pour configurer CloudWatch Logs en tant que destination d'événement vocal Amazon Pinpoint, procédez comme suit :
-
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 VoiceCW par n'importe quel nom pour votre jeu de configuration.
-
Exécutez la commande create-log-group pour créer un nouveau groupe de journaux CloudWatch qui reçoit les journaux de messages vocaux :
aws logs create-log-group --log-group-name /aws/pinpoint/voice
-ou-
Utilisez un groupe de journaux CloudWatch existant et obtenez l'ARN en procédant comme suit :
Ouvrez la console CloudWatch.
Dans le volet de navigation, sélectionnez Journaux. Puis, sélectionnez Groupe de journaux.
Dans la colonne Groupe de journaux, choisissez le nom de votre groupe de journaux.
Dans le volet Détails du groupe de journaux, copiez la valeur ARN. Il s'agit de l'ARN de votre groupe de journaux. -
Créez un nouveau rôle IAM que le service Amazon Pinpoint endossera.
-
Mettez à jour la stratégie d’approbation de rôle IAM avec l’instruction d'autorisations suivante :
{ "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 : Cette stratégie permet au service vocal SMS d'endosser le rôle IAM.
-
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 : 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.
-
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.
-
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" ]
Remarque : Remplacez VoiceCW par le nom de votre jeu de configuration.
-
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
-
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
Pour configurer un flux de diffusion Firehose en tant que destination d'événement vocal Amazon Pinpoint, procédez comme suit :
-
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 de votre jeu de configuration.
-
Créez un flux de diffusion Firehose. Pour le paramètre Destination, sélectionnez Amazon Simple Storage Service (Amazon S3).
-
Créez un nouveau rôle IAM que le service Amazon Pinpoint endossera.
-
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 : Cette stratégie permet au service vocal SMS d'endosser le rôle IAM.
-
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.
-
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 de votre flux de diffusion Firehose et IAM_ROLE par le nom de votre rôle IAM.
-
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.
-
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" ]
-
Exécutez la commande create-event-destination :
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.
-
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 compartiment Amazon S3 que vous avez configuré lors de la création du flux Kinesis Data Firehose au bout de quelques minutes.

Contenus pertinents
- demandé il y a 5 moislg...
- demandé il y a 8 moislg...
- demandé il y a 4 moislg...
- AWS OFFICIELA mis à jour il y a 2 ans
- AWS OFFICIELA mis à jour il y a 4 ans
- AWS OFFICIELA mis à jour il y a 3 ans
- AWS OFFICIELA mis à jour il y a 2 ans