Une autre petite expérience avec l'API Connect

Dans mon billet précédent, Une brève expérience avec l'API utilisateur Amazon Connect j'ai créé une application Web Express à explorer à l'aide de l'API utilisateur Amazon Connect. Depuis lors, Amazon a publié de nouvelles méthodes API pour mettre à jour les attributs de contact et afficher les métriques de la file d'attente. Dans cet article, je mets à jour l’application Express pour tester ces nouvelles méthodes.

Commençons par le produit final. Outre la liste existante des utilisateurs Connect et une vue détaillée Connecter l'utilisateur, l'application dispose désormais d'un formulaire que vous pouvez utiliser pour marquer un appel de suivi précédent et une page de mise à jour automatique pour afficher les mesures actuelles de vos files d'attente.

Ces nouveaux écrans sont présentés ci-dessous.

** Le code d'application est disponible sur GitHub à l'adresse suivante: https://github.com/phmiller/connect-api-express ** *

Fermez les yeux sur le style et discutons de ce qui se passe avec chacun écran.

Attributs de contact de mise à jour

Cette page utilise la méthode updateContactAttributes pour ajouter un nouvel attribut de contact à un appel Connect. Dans ce cas, un indicateur pour indiquer que l'appel doit être suivi.

La méthode updateContactAttributes se bloque de l'objet connectClient du kit AWS SDK et je transmets l'ID de contact, l'ID d'instance et le ou les nouveaux attributs. Vous pouvez voir ci-dessous un enregistrement de trace de contact de l'appel ci-dessous avec l'identifiant du contact, puis le nouvel attribut surligné.

19659002] L'utilisation de cette API était simple, bien qu'il soit plus facile d'écrire des applications utiles s'il existait une API Connect pour récupérer les contacts actuels et passés, plutôt que de rechercher l'identifiant de contact du site Admin ou appel dans une application API Streams.

Métriques de la file d'attente actuelle

Cette page obtient toutes les métriques de file d'attente actuelles pour chaque file d'attente de l'instance Connect. Il se recharge automatiquement toutes les deux secondes pour obtenir les dernières métriques (le code se trouvant dans les fichiers currentMetrics.pug et currentMetrics.js sur GitHub)

La syntaxe de cette commande m'a un peu fait trébucher. Il est assez bien décrit dans la documentation mais je n’ai pas tout d’abord compris que je devais spécifier chaque métrique souhaitée (variable metricsList) ainsi que les ARN de chaque file (variable qArns). C'était un peu frustrant de parcourir le site Admin pour obtenir la file d'attente ARN à partir de l'URL.

Une fois ces problèmes dépassés, l'API s'est comportée comme prévu, à une exception près. Les files d'attente sans activité, c'est-à-dire aucun agent connecté et aucun appel, ne sont pas renvoyées du tout dans les résultats.

Mon exemple simple ne vous donne pas tout, mais je pouvais voir d'autres utilisations comme créer un petit tableau de bord qui s'allume quand certains les seuils sont transmis comme trop d'appels dans la file d'attente ou pas assez d'agents connectés.

Autorisations

Lorsque j'exécute cette application à partir de ma machine, elle utilise mes informations d'identification AWS CLI, qui ont accès à tout. Si vous exécutiez ce code dans un Lambda sous un rôle IAM avec des privilèges moindres, vous devez attribuer manuellement des autorisations à l’API Connect. Par exemple, «connect: UpdateContactAttributes», ciblant l'ID d'instance Connect dans une stratégie personnalisée.

Essayer vous-même

Veuillez vérifier le code sur GitHub à l'adresse suivante: https://github.com/phmiller/connect-api-express

Références

Merci d'avoir lu. Toutes les questions, commentaires ou corrections sont grandement appréciés.

Pour en savoir plus sur ce que nous pouvons faire avec Amazon Connect, consultez Fonction d'aide pour tirer le meilleur parti d'Amazon Connect