Une courte expérience avec l'API utilisateur Amazon Connect

À la fin du mois de juillet, Amazon a présenté l'API de gestion des utilisateurs à Amazon Connect. L'API utilisateur permet aux clients et aux partenaires de démarrer le scripting des opérations de configuration et de maintenance des utilisateurs, de créer des applications de gestion des utilisateurs personnalisées et de modifier les données utilisateur à partir des fonctions Lambda. Pour ce post, j'ai pris quelques heures pour coder une application web simple qui affiche une liste d'utilisateurs et de détails pour chaque utilisateur. Ce n'est pas trop beau et cela ne fait pas beaucoup, mais si cela vous donne une idée de ce qui est possible et de la facilité d'utilisation de l'API, je serai satisfait.

Commençons par le produit final . Cette application a deux écrans, une liste d'utilisateurs Connect et une vue détaillée Connecter l'utilisateur. Chaque utilisateur de la liste Connectable est cliquable et vous amène à la page des détails.

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

Rien de compliqué, non? Cependant, si vous souhaitez rendre les détails de l'utilisateur modifiables ou ajouter un bouton pour créer un nouvel utilisateur, la structure est là pour vous.

Entrons dans la partie amusante, du code!

Du code…

J'ai utilisé le framework d'application Web Express avec Node. J'ai gardé tout le code dans un fichier, index.js et utilisé le langage de modèles Pug pour afficher chacune des vues. Pour rendre le code plus lisible, j'ai utilisé des méthodes asynchrones avec le mot-clé wait. Cela évite les chaînes de rappel massivement indentées et rend la logique plus facile à suivre en analysant simplement le fichier. Plus de détails sur la pile technologique se trouvent dans la section Helpful Resources à la fin de ce post.

J'ai inclus le code des deux vues à titre de référence, mais la partie importante de ce post est de regardez le code de l'API utilisateur, qui se trouve dans le fichier index.js.

La première étape de l'utilisation de l'API Connect User consiste à charger le kit AWS SDK et à créer un objet client Connect, comme indiqué aux lignes 8 à 11. Nous indiquons à l'objet client la version de l'API Connect à utiliser et la région dans laquelle se trouve votre instance Connect.

De là, nous pouvons appeler des méthodes API individuelles dans les méthodes de routage. Pour la méthode de vue d'index app.get (“/”)… nous appelons la méthode listUsers qui prend votre ID d'instance Connect et renvoie une liste d'objets info de base utilisateur. Nous passons les objets à la vue pour effectuer le rendu et nous partons.

Pour la méthode de la vue détaillée app.get (“/ user /: userId”) … nous appelons describeUser ] méthode qui prend à nouveau cette instance de l'instance Connect, ainsi que l'ID utilisateur de l'utilisateur pour lequel vous souhaitez des détails. Cette méthode renvoie un objet utilisateur détaillé. Encore une fois, nous transmettons cet objet à la vue à rendre.

Au cas où vous vous poseriez la question, car je ne spécifie pas d'alternative, cette application de noeud utilisera simplement les informations d'identification de profil par défaut de l'outil Amazon Command Line Interface installé sur machine. Voir la section Ressources utiles pour un lien avec des détails sur la façon de spécifier des informations d'identification alternatives.

Et c'est vraiment ça. Aucune incantation secrète particulière nécessaire ici. Amazon a fait du bon travail en fournissant une API facile à utiliser et parfaitement documentée. J'adorerais voir d'autres ajouts à l'API, par exemple pour extraire les files d'attente associées à un profil de routage, mais c'est une base solide pour commencer. Encore une fois, le code de vue est reproduit ci-dessous pour votre curiosité.

Ressources utiles

Merci d'avoir lu. Toutes les questions, commentaires ou corrections sont grandement appréciés. Restez à l'écoute la semaine prochaine pour un autre article sur l'API Connect.

Pour en savoir plus sur ce que nous pouvons faire avec Amazon Connect, consultez Fonction d'aide (f, b , e, v, n, t, s) {if (f.fbq) return; n = f.fbq = function () {n.callMethod?
n.callMethod.apply (n, arguments): n.queue.push (arguments)}; if (! f._fbq) f._fbq = n;
n.push = n; n.loaded =! 0; n.version = '2.0'; n.queue = []; t = b.createElement (e); t.async =! 0;
t.src = v; s = b.getElementsByTagName (e) [0]; s.parentNode.insertBefore (t, s)} (fenêtre,
document 'script', // connect.facebook.net/en_US/fbevents.js ');

fbq ('init', '911436665572720');
fbq ('track', "PageView");

Source link