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.

# Activation de l’intégration d’Amazon Connect Contact Lens
<a name="enable-contactlens-integration"></a>

Après avoir créé un connecteur Contact Lens, vous devez activer l’intégration en attribuant aux utilisateurs des autorisations de profil de sécurité afin qu’ils puissent y accéder sur le site Web d’administration Amazon Connect .

1. Connectez-vous au site Web d' Amazon Connect administration à l'adresse https ://*nom de l'instance* .my.connect.aws/ à l'aide d'un compte administrateur.

1. Dans la barre de navigation, choisissez **Profils de sécurité**. Sur la page **Gérer les profils de sécurité**, choisissez **Administrateur**, **Modifier**. 

1. Sur la page **Modifier le profil de sécurité**, choisissez **Canaux et flux **AnalyticsConnectors****- - **Afficher** et **modifier** les autorisations, puis sélectionnez **Enregistrer**. 
**Important**  
Si vous ne voyez pas l’autorisation du connecteur Contact Lens sous **Canaux et flux**, demandez une augmentation des quotas de service suivants sur votre compte Amazon Connect :  
Connecteurs Contact Lens par compte
Nombre maximum de sessions d’enregistrement actives à partir de systèmes vocaux externes par instance

1. Attribuez cette autorisation aux profils de sécurité des utilisateurs qui doivent pouvoir accéder aux connecteurs Contact Lens. 
**Note**  
Vous ne pouvez supprimer le dernier connecteur Contact Lens de votre instance Amazon Connect que lorsque l’accès au connecteur Contact Lens est retiré aux utilisateurs de cette instance.  
Si vous tentez de supprimer le dernier connecteur Contact Lens sans avoir d’abord supprimé l’accès aux connecteurs Contact Lens pour les utilisateurs de cette instance, le message d’erreur suivant s’affiche : **error - Failed to delete connector \$1connector-name\$1 with error: An analytics connector permissions is being used in a security profile**.

1. Après avoir appliqué l'autorisation, les utilisateurs qui en disposent pourront voir l'option **Contact Lensconnecteurs** dans le menu de navigation de gauche du site Web d' Amazon Connect administration, comme indiqué dans l'image suivante.  
![\[Le menu de gauche sur le site Amazon Connect d'administration, l'Contact Lensoption.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/contact-lens-connector-menuitem.png)

1. L’activation du connecteur Contact Lens est maintenant terminée. Passez à l’étape suivante : [Association d’un connecteur Contact Lens à un flux](associate-contactlens-integration.md).

# Association d’un connecteur Contact Lens à un flux
<a name="associate-contactlens-integration"></a>

Une fois que vous avez [configuré](configure-external-voice-system.md) votre SBC externe pour qu’il pointe vers l’hôte du connecteur d’intégration Contact Lens, vous devez configurer la manière dont l’audio sera traité lorsqu’il atteint Amazon Connect Contact Lens. Pour ce faire, vous devez définir les étapes de traitement audio dans un flux Amazon Connect. Celui-ci indiquera les étapes que doit suivre l’appel audio, y compris l’invocation de l’analytique conversationnelle de Contact Lens.

Procédez comme suit pour créer un flux qui active Contact Lens, puis associez-le au connecteur Contact Lens. Ce flux sera invoqué lorsque le connecteur Contact Lens recevra un appel audio.

1. Sur le site Web Amazon Connect d'administration, créez un flux utilisant le[Définir le comportement d’enregistrement et d’analytique](set-recording-behavior.md). Configurez le bloc pour activer **Enregistrement de la voix de l’agent et du client**, **Analytique vocale de Contact Lens** et **Enregistrement automatisé des appels d’interaction**. Terminez le flux avec le bloc [Mettre fin/Reprendre le flux](end-flow-resume.md). L'image suivante illustre cette configuration. 

   Pour obtenir la liste des blocs que vous pouvez utiliser dans une intégration Contact Lens, consultez [Blocs de flux pris en charge pour l’intégration Contact Lens](contactlens-integration-supportedflowblocks.md).   
![\[Page des propriétés du bloc Définir le comportement d’enregistrement et d’analytique.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/contactlens-connector-setblock.png)

   Pour obtenir des instructions complètes, consultez [Activation de l’analytique conversationnelle](enable-analytics.md).

1. Dans le menu de navigation, choisissez **Canaux**, **Connecteurs Contact Lens**. Choisissez le connecteur d’intégration Contact Lens que vous souhaitez associer au flux. Dans le champ **Nom du flux**, commencez à saisir le nom de votre flux pour afficher une liste, puis choisissez le flux.   
![\[Page Connecteurs, liste des flux disponibles.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/contactlens-connector-flow.png)

# Métadonnées d’appel pour l’intégration de Contact Lens
<a name="callmetadata-contactlens-integration"></a>

Dans Amazon Connect, chaque interaction avec un client constitue un contact Amazon Connect. Chaque session vocale qui passe par le connecteur Contact Lens crée un contact Amazon Connect. Le connecteur crée un contact Amazon Connect à l’aide des champs fournis dans les métadonnées d’appel. Les métadonnées d’appel incluent l’ID utilisateur de l’agent et l’ID de file d’attente de l’agent pour l’appel diffusé dans les métadonnées d’appel. 

Vous pouvez fournir l’ID utilisateur de l’agent et d’autres métadonnées d’appel au connecteur Contact Lens en utilisant les paramètres de métadonnées SIPREC pris en charge dans l’invitation SIP de la session de flux audio. Le connecteur analyse les champs de métadonnées d’appel suivants et ajoute ces informations au contact Amazon Connect.


| Champ d’état des appels | Métadonnées SIPREC | Value | Si elle n’est pas fournie | 
| --- | --- | --- | --- | 
| Nom d’utilisateur de l’agent | AmznConnectAgentUserId | ID utilisateur de l’agent Amazon Connect | Obligatoire | 
| ID de file d’attente | AmznConnectQueueId | ID de file d’attente Amazon Connect | Facultatif. Si elle n’est pas fournie, la file d’attente par défaut de l’instance Amazon Connect est utilisée. | 
| Ordre des participants | AmznConnectParticipantOrder | Valeurs valides : asc, desc | Facultatif. Si cette valeur n’est pas fournie, l’ordre croissant est utilisé. Amazon Connect trie les flux SIPREC à l’aide d’étiquettes. Le premier flux dans l’ordre des étiquettes est celui de l’agent et le second est celui de l’appelant. | 

Un contact doit disposer d’un ID utilisateur d’agent Amazon Connect. Contact Lens commence à capturer l’audio diffusé et à générer l’enregistrement et l’analyse des appels uniquement lorsque l’agentId est fourni. 

Dans le cas contraire, la session du connecteur Amazon Connect Contact Lens est arrêtée. Si vos métadonnées SIPREC n’ont pas été analysées automatiquement par le connecteur Amazon Connect Contact Lens et que l’ID utilisateur de l’agent n’est pas défini, vous pouvez créer une fonction Lambda de flux et accéder à toutes les métadonnées SIP et SIPREC en utilisant les champs suivants :


| Attribut | Description | JSONPath Référence | 
| --- | --- | --- | 
| Métadonnées SIPREC | Métadonnées SIPREC issues de l’événement SIP | \$1.Media.Sip. SiprecMetadata | 
| En-tête SIP | En-tête SIP issu de l’événement SIP. \$1SIP header name\$1 est le nom de l’en-tête SIP fourni dans l’événement SIP. Par exemple, « À », « De », etc. | \$1.Media.Sip.Headers.\$1SIP header name\$1 | 

Pour plus d’informations, consultez [Attributs de métadonnées d'appels téléphoniques (attributs d'appel)](connect-attrib-list.md#telephony-call-metadata-attributes).

## Comment utiliser les métadonnées d’événements
<a name="howto-correlate-eventscalls"></a>

Amazon Connect publie des événements SIP, des événements de streaming et des événements de contact. Ces événements incluent les métadonnées collectées à partir de l’invitation SIP SIPREC des appels. Les métadonnées incluent les métadonnées SIPREC, les en-têtes SIP, fromNumber, toNumber, etc. Voici quelques exemples de ce que vous pouvez faire avec les métadonnées de ces événements :

1. Vous pouvez traiter les métadonnées de ces événements afin de déterminer votre propre identifiant unique pour les appels et de corréler les appels avec votre propre système.

1.  Vous pouvez ensuite ajouter votre identifiant unique pour l’appel dans les attributs de contact de l’appel en utilisant le bloc [Définir des attributs de contact](set-contact-attributes.md).

1.  Vous pouvez effectuer une recherche par attributs de contact personnalisés sur le site Web d' Amazon Connect administration afin de trouver le contact pour l'appel tiers dans les deux instances Amazon Connect.

Pour en savoir plus sur la création de fonctions Lambda pour les flux Amazon Connect, consultez [Accordez à Amazon Connect l'accès à vos AWS Lambda fonctions](connect-lambda-functions.md). Pour obtenir la liste de tous les attributs de contact pris en charge auxquels vous pouvez accéder dans la fonction Lambda de vos flux, consultez [Liste des attributs de contact disponibles dans Amazon Connect et leurs JSONPath références](connect-attrib-list.md).

# Blocs de flux pris en charge pour l’intégration Contact Lens
<a name="contactlens-integration-supportedflowblocks"></a>

Les tableaux suivants répertorient les blocs de flux que vous pouvez utiliser pour spécifier la manière dont Amazon Connect traite les sessions de flux audio. 

**Blocs Définir**


| Bloc de flux | Effet | Description | 
| --- | --- | --- | 
| Définir la file d'attente active | Aucun effet | Définit la file d’attente active | 
| Définir des attributs de contact | Pris en charge | Stocke les paires clé-valeur en tant qu'attributs de contact. Vous définissez une valeur qui sera référencée ultérieurement dans un flux. | 
| Obtenir les métriques de file d'attente | Aucun effet | Obtient les métriques de file d’attente | 
| Modifier la priorité/l'âge du routage | Aucun effet | modifier la priorité de routage du contact | 
| Définir le flux de mise en attente | Aucun effet | Spécifie le flux à appeler lorsqu'un client ou un agent est mis en attente. | 
| Définir le flux de message discret | Aucun effet | Spécifie le flux à invoquer lorsqu’un client ou un agent a rejoint une conversation vocale ou par chat. | 
| Définir le numéro de rappel | Aucun effet | Spécifiez l'attribut pour définir le numéro de rappel. | 
| Définir la voix | Aucun effet | Définit la langue text-to-speech (TTS) et la voix à utiliser pour le flux de contacts. | 
| Définir le flux de file d’attente des clients | Aucun effet | Définit la file d’attente des clients pour le flux de file d’attente des clients | 
| Définir le flux de déconnexion | Aucun effet | Définit le flux de déconnexion pour le flux de file d’attente de déconnexion | 
| Définir le flux d'événements | Aucun effet | Spécifie le flux à exécuter lors d'un événement de contact. | 
| Définition des critères de routage | Aucun effet | Définit les critères de routage pour le contact. | 

**Blocs Analyser**


| Bloc de flux | Effet | Description | 
| --- | --- | --- | 
| Définir le comportement d’enregistrement et d’analytique | Pris en charge | Définit les options d’enregistrement et active les fonctionnalités dans Contact Lens. | 
| Définir le comportement de journalisation | Pris en charge | Activer ou désactiver les journaux de flux | 

**Blocs de logique**


| Bloc de flux | Effet | Description | 
| --- | --- | --- | 
| Distribuer par pourcentage | Pris en charge | Achemine les contacts de manière aléatoire en fonction d’un pourcentage. | 
| Loop | Pris en charge | Exécute une branche en boucle pendant un nombre de fois spécifié | 

**Blocs de branche**


| Bloc de flux | Effet | Description | 
| --- | --- | --- | 
| Vérifier l'état de la file d'attente | Aucun effet | Vérifie l’état de la file d’attente | 
| Vérifier les effectifs | Aucun effet | Vérifie les effectifs dans les files d’attente | 
| Vérifier les heures de fonctionnement | Pris en charge | Branches basées sur des heures de fonctionnement spécifiées. | 
| Vérifier les attributs de contact | Pris en charge | Branches basées sur une comparaison avec la valeur d'un attribut de contact. | 

**Bloc Intégrer**


| Bloc de flux | Effet | Description | 
| --- | --- | --- | 
| Créer une tâche | Pris en charge | Crée une nouvelle tâche manuellement ou en utilisant un modèle de tâche. | 
| Profils des clients | Pris en charge | Vous permet de récupérer, de créer et de mettre à jour un profil de client. | 
| Invoquer AWS Lambda | Pris en charge | Appelle AWS Lambda et renvoie éventuellement des paires clé-valeur. | 
| Appeler le module | Pris en charge | Appelle un module publié, qui vous permet de créer des sections réutilisables d'un flux de contacts. | 

**Blocs Terminer/Transférer**


| Bloc de flux | Effet | Description | 
| --- | --- | --- | 
| Déconnecter/Raccrocher | Pris en charge | Déconnecte le contact et met fin à la session de diffusion audio. | 
| Mettre fin au flux | Pris en charge | Permet d'arrêter le flux actuel sans déconnecter le contact. | 

# Configuration de la redondance multi-régions pour l’intégration de Contact Lens
<a name="contactlens-integration-multiregion"></a>

La redondance multi-régions vous permet de mettre à l’échelle votre système vocal externe pour une fiabilité, des performances et une efficacité optimales. Vous pouvez prendre en charge la redondance multi-régions à l’aide de l’instance de réplica Amazon Connect. 

## Configuration de la redondance active/passive
<a name="contactlens-multiregion-ap"></a>

Vous pouvez créer une instance Amazon Connect dans une région (par exemple, USA Est (Virginie du Nord)) et une instance de réplica dans une autre région (par exemple, USA Ouest (Oregon)). Vous pouvez ensuite configurer votre système vocal externe pour envoyer l’invitation SIP SIPREC à la région principale. Lorsque l’instance Amazon Connect de la région principale tombe en panne, vous pouvez mettre à jour votre système vocal externe pour qu’il bascule vers l’instance Amazon Connect de réplica dans la région passive.

## Configuration de la redondance active/active
<a name="contactlens-multiregion-aa"></a>

Vous pouvez mettre en œuvre la stratégie de redondance active-active en diffusant simultanément l’audio sur les deux instances Amazon Connect. Pour mettre en œuvre cette stratégie, configurez votre système vocal externe pour diffuser simultanément l’audio dans les deux régions distinctes. Dans chaque région, l’intégration de Contact Lens agira de la sorte :

1. Elle créera son propre contact Amazon Connect.

1. Elle capturera le flux audio pour créer des enregistrements d’appels.

1. Elle réalisera une analyse Contact Lens.

Cette approche vous oblige à répliquer manuellement toutes les configurations du centre de contact Amazon Connect. Cependant, vous pouvez utiliser Amazon Connect Global Resiliency, qui réplique automatiquement tous les paramètres de l’instance Amazon Connect dans toutes les régions. Pour plus d’informations, consultez [Configuration d’Amazon Connect Global Resiliency](setup-connect-global-resiliency.md).