Comment intégrer Amazon Connect à Amazon Kinesis ?

Brève description

L'activation du flux de données dans votre instance Amazon Connect vous permet de diffuser les événements des agents et les CTR vers Amazon Kinesis Data Firehose ou Amazon Kinesis Data Streams. Les événements des agents fournissent des rapports en temps quasi réel sur l'activité des agents au sein de votre instance. Les CTR fournissent des données en temps quasi réel sur les événements de contact tels que les appels vocaux, les discussions et les tâches de votre instance.

Pour intégrer Amazon Connect à Kinesis Data Firehose ou Kinesis Data Streams, procédez comme suit :

1. Créez un flux de diffusion Kinesis Data Firehose (français non garanti) ou un flux de données Kinesis (français non garanti).
2. Activez le flux de données pour votre instance (français non garanti).
3. Testez votre configuration.

Résolution

Créer un flux de diffusion Kinesis Data Firehose

Pour intégrer Amazon Connect à Kinesis Data Firehose, procédez comme suit :

1. Configurez la source, la destination et le nom (français non garanti) de votre flux de diffusion Kinesis Data Firehose.
   Remarque : Direct PUT vous permet de créer un Kinesis Data Firehose capable de diffuser des données depuis Amazon Connect sans avoir à créer de flux de données Kinesis. Kinesis Stream nécessite que vous créiez un flux de données Kinesis pour vos données Amazon Connect.
2. (Facultatif) Configurez le Kinesis Data Firehose pourtransformer et convertir vos données d'enregistrement (français non garanti).
3. (Facultatif) Configurez la sauvegarde et les paramètres avancés (français non garanti)de votre flux de diffusion Kinesis Data Firehose.
4. Activez le flux de données pour votre instance (français non garanti).
5. Testez votre flux de diffusion à l'aide d'échantillons de données (français non garanti).

Créer un flux de données Kinesis

Pour intégrer Amazon Connect à Kinesis Data Streams, procédez comme suit :

1. Créez un flux à l'aide de la console de gestion AWS (français non garanti).
2. Activez le flux de données pour votre instance (français non garanti).
3. Pour tester votre configuration, suivez l'une des procédures suivantes en fonction de votre cas d'utilisation :

Vous avez activé le flux de données pour les événements de contact :

1. Passez ou recevez un appel pour créer un enregistrement de contact dans votre instance.
2. Vérifiez que l'enregistrement du contact est généré dans l'interface utilisateur de recherche de contacts (français non garanti).
3. Vérifiez la destination configurée dans votre flux de diffusion pour l'événement d'enregistrement du contact. Les événements de contact sont diffusés en masse. Il est possible que plusieurs ID de contact soient envoyés à la destination en même temps. Pour voir un exemple, consultez Exemple d'événement de contact lorsqu'un appel vocal est connecté à un agent (français non garanti).

-ou-

Vous avez activé le flux de données pour les événements des agents (français non garanti) :

1. Demandez à un agent de modifier son statut ou de se mettre en relation avec un contact pour créer un événement d'agent.
2. Vérifiez la destination configurée pour le flux de données Kinesis pour l'événement de l'agent. L'ARN de l'agent est la clé de partition utilisée lorsque des données sont envoyées au flux de données. Tous les événements d'un seul agent sont envoyés à la même partition et tous les événements de repartage du flux sont ignorés. Pour voir un exemple, veuillez consulter Exemple de flux d'événements d'agent (français non garanti).

Identification et résolution des erreurs

Je ne vois pas de données publiées dans la destination de mon flux de diffusion Kinesis.

Pour résoudre le problème de non-affichage des données publiées, effectuez une ou plusieurs des actions suivantes :

• Vérifiez que le flux de données Kinesis que vous avez sélectionné est activé pour le chiffrement côté serveur. Si le chiffrement côté serveur est activé car vous ne disposez pas de l'autorisation d'appeler kms:GenerateDataKey, Amazon Connect ne peut pas publier de données dans le flux. Pour résoudre ce problème, suivez les étapes décrites dans la section Utilisation du chiffrement côté serveur pour le flux Kinesis (français non garanti).
• Testez votre flux de diffusion (français non garanti) à l'aide de l'option Tester les données de démonstration de Kinesis Data Firehose pour vérifier que votre flux de diffusion est configuré comme prévu.
• Vérifiez la fréquence de diffusion des données (français non garanti) pour Kinesis Data Firehose. La fréquence de diffusion des données peut varier en fonction de la destination sélectionnée. Si les données ne sont pas transmises après cinq minutes, consultez les métriques du flux de diffusion pour les enregistrements entrants. Vous pouvez configurer la journalisation des erreurs pour votre Kinesis Data Firehose afin de capturer les erreurs de diffusion de données (français non garanti).

Je n'arrive pas à sélectionner le Kinesis Data Firehose ou le Kinesis Data Stream que j'ai créé lorsque j'ai activé le flux de données pour Amazon Connect.

Tout d'abord, vérifiez que Kinesis Data Firehose ou Kinesis Data Stream est présent dans la même région AWS que l'instance Amazon Connect. Si les services se trouvent dans la même région, il se peut qu'il manque une autorisation vous permettant de répertorier le flux. Vérifiez que les autorisations suivantes sont accordées : ListDeliveryStreams (français non garanti) pour Kinesis Data Firehose ou ListStreams (français non garanti) pour Kinesis Data Streams.

Vous pouvez également utiliser la commande associate-instance-storage-config (français non garanti) de l'interface de la ligne de commande AWS (AWS CLI) pour activer le flux de données.

Remarque : en cas d'erreurs lors de l'exécution de commandes depuis l'interface de la ligne de commande AWS (AWS CLI), vérifiez que vous utilisez la version la plus récente d'AWS CLI (français non garanti).

Où puis-je accéder aux événements des agents ou aux enregistrements de suivi des contacts (CTR) ?

Si les événements des agents et les CTR sont envoyés à Kinesis Data Streams, utilisez le visualiseur de données de la console Kinesis pour consulter les données (français non garanti). Vous pouvez également configurer un consommateur pour qu'il traite les données du flux de données Kinesis. Par exemple, vous pouvez créer un Kinesis Data Firehose pour utiliser les données du flux de données Kinesis pour les événements des agents.

Si les CTR sont envoyés à Kinesis Data Firehose, ils sont accessibles dans la destination configurée pour le flux de diffusion. Par exemple, si la destination est un compartiment Amazon Simple Storage Service (Amazon S3), vous pouvez accéder aux CTR du compartiment S3 choisi. Vous choisissez le compartiment de destination Amazon S3 lorsque vous créez le Kinesis Data Firehose.

Puis-je configurer plusieurs flux de diffusion Kinesis pour les enregistrements de suivi des contacts (CTR) ?

Par défaut, un seul flux de diffusion est pris en charge pour les CTR. Mais vous pouvez utiliser plusieurs consommateurs pour avoir plusieurs flux de diffusion de CTR vers un flux de données Kinesis. Pour utiliser cette configuration, le flux de données Kinesis doit agir en tant que producteur pour les données CTR. Vous pouvez ensuite configurer plusieurs consommateurs pour qu'ils ingèrent les données. Pour en savoir plus sur les consommateurs de Kinesis Data Streams, consultez Lecture de données d'Amazon Kinesis Data Streams (français non garanti).

Je vois des données dupliquées provenant d'Amazon Connect publiées dans mon application Kinesis Data Streams.

Il peut y avoir des données dupliquées en raison des nouvelles tentatives des producteurs et de celles des consommateurs. Il est recommandé de faire en sorte que la destination des données finales gère les doublons afin de résister aux nouvelles tentatives (français non garanti).

---

Informations connexes

Flux d'événements des agents Amazon Connect (français non garanti)

Événements de contact d'Amazon Connect (français non garanti)

Qu'est-ce qu'Amazon Kinesis Data Streams ? (français non garanti)

Qu'est-ce qu'Amazon Kinesis Data Firehose ? (français non garanti)