Integration Hub

Le contenu de cette page concerne un produit ou une fonctionnalité en version contrôlée (CR). Si vous ne faites pas partie du groupe CR et souhaitez plus d'informations, contactez votreReprésentant de compte CXone.

Integration Hub permet d’automatiser les processus en fournissant une source centralisée pour la construction, la gestion et l’exécution des intégrations de CXone vers des plates-formes tierces. Vous pouvez créer des modèles connectés qui peuvent servir pour de multiples intégrations avec la même application. Vous pouvez récupérer des connecteurs dans la Bibliothèque de connexions et les personnaliser en fonction de vos besoins. Vous pouvez créer vos propres modèles, ou utiliser un modèle de la Bibliothèque de connexions et l’ajouter à Mes connexions. Si vous l’ajoutez à Mes connexions, vous pouvez configurer l’intégration en fonction de vos besoins précis.

Lancement de Integration Hub dans CXone

  1. Dans CXone, cliquez sur le sélecteur d'application et sélectionnez Automatisation & IA.

  2. Cliquez sur Integration Hub pour l’ouvrir.

Lancement de Integration Hub dans Desktop Studio

  1. Lancer Desktop Studio

  2. Dans l’onglet Tools, cliquez sur Automation & AI.

  3. Cliquez sur l’action Connect Auth et faites-la glisser dans un script.

  4. Double-cliquez sur Connect Auth dans le script pour ouvrir Integration Hub.

Lancement de Integration Hub dans CXone Studio

  1. Dans CXone, cliquez sur le sélecteur d’application  et allez dans Routage Omnicanal > Studio.

  2. Cliquez sur Nouveau script et sélectionnez Générique.

  3. Cliquez sur Actions Icône en haut à gauce de CXOne Studio pour ouvrir le panneau Actions.

  4. Dans la barre de recherche, entrez Connect Auth.

  5. Cliquez sur l’action Connect Auth et faites-la glisser dans le script.

  6. Cliquez sur Ouvrir l’éditeur.

Création d’un modèle connecté

Un modèle connecté définit les grandes lignes d’une intégration ; il contient les descriptions et les exigences de l’intégration d’applications tierces.

Capture d’écran de la page Ajouter un modèle dans Integration Hub.

  1. Lancez Integration Hub et cliquez sur + Ajouter un modèle.

  2. Dans l’onglet Détails, remplissez Nom, Application, Méthode d’intégration, Type d’authentification et Description.

    champs Détails
    Nom Le nom donné au modèle. Ce nom figurera dans la Bibliothèque de connexions.

    Application

    Le nom de l’application avec laquelle ce modèle permet de créer une intégration.
    Méthode d’intégration REST est la seule méthode d’intégration prise en charge actuellement.
    Type d’authentification OAuth 2.0 et Pas d’authentification sont les seuls types d’authentification pris en charge pour le moment. Si vous sélectionnez Pas d’authentification, vous allez créer une intégration sans authentification.
    Description Vous pouvez entrer une description. Elle sera présentée aux autres utilisateurs s’ils sélectionnent ce modèle dans la Bibliothèque de connexions.
  3. Joignez-lui une icône en faisant glisser une image ou en cliquant sur Parcourir des fichiers. Cette icône sera utilisée pour représenter le modèle dans la Bibliothèque de connexions.
  4. Dans l’onglet Configuration, sélectionnez les méthodes prises en charge pour l’application que vous voulez intégrer. Les verbes REST répertoriés dépendent de l’application tierce pour laquelle vous créez une intégration.

  5. Cliquez sur + Ajouter un en-tête personnalisé pour définir des en-têtes.

    Vous pouvez rendre l’en-tête obligatoire en activant l’option Obligatoire ?. Vous pouvez cliquez sur le X pour supprimer l’en-tête si vous le souhaitez. Laissez ce champ vide si vous ne voulez pas ajouter d’en-têtes.

  6. Cliquez sur Enregistrer pour ajouter le modèle à la Bibliothèque de connexions. Cliquez sur Enregistrer + Mes connexions pour ajouter le modèle à la Bibliothèque de connexions et à Mes connexions.

Gestion des connecteurs

Un connecteur est un modèle enregistré qui peut être configuré en fonction de vos besoins particuliers.

  1. Lancez Integration Hub et sélectionnez le modèle que vous souhaitez utiliser dans la Bibliothèque de connexions sur la gauche, puis cliquez sur + Mes connexions.

  2. Dans le champ Entrer le nom du connecteur, attribuez un nom au connecteur. Le connecetur s’affichera sous ce nom dans la fenêtre Mes connexions.

  3. Cliquez sur Sauvegarder.

  4. Accédez au connecteur dans Mes connexions.

  5. Dans l’onglet Authentification, saisissez l’URL, la Méthode et les En-têtes. Si vous avez sélectionné Pas d’authentification comme Type d’authentification, vous n’avez pas d’onglet Authentification.

    champs Détails
    URL L’URL utilisée pour la demande d’authentification.
    Méthode La méthode REST spécifique utilisée pour la demande d’authentification.
    Entêtes Référence les en-têtes définis lors de la création du modèle. Si un en-tête n’a pas été défini lorsque le modèle a été créé, il n’est pas censé s’authentifier avec l’application. Des champs supplémentaires seront visibles si d’autres en-têtes sont définis.

  6. Dans l’onglet Corps et paramètres, cliquez sur +Ajouter un paramètre de requête et entrez le Nom du paramètre de requête et la Valeur du paramètre de requête. Il s’agit d’un ensemble de paires clé/valeur qui sont envoyées avec la demande d’authentification. Si vous avez sélectionné Pas d’authentification comme Type d’authentification, vous n’avez pas d’onglet Corps et paramètres.

  7. Lorsque vous entrez le contenu Corps, choisissez un Type de média dans la liste déroulante.

    champs Détails

    ApplicationJson

    Dans la liste déroulante, sélectionnez ApplicationJson et entrez le Corps du texte. Le corps de texte est envoyé avec la demande d’authentification.
    ApplicationJsonPatch Dans la liste déroulante, sélectionnez ApplicationJsonPatch et entrez le Corps du texte. Le corps de texte est envoyé avec la demande d’authentification.
    FormURLEncoded Dans la liste déroulante, sélectionnez FormURLEncoded et cliquez sur + Ajouter un paramètre de formulaire. Entrez le Nom du paramètre de formulaire et la Valeur du paramètre de formulaire. Il s’agit des paires clé/valeur qui sont envoyées avec la demande d’authentification. Ce type de média envoie les demandes en utilisant les notations URL courantes.
    TextHtml Dans la liste déroulante, sélectionnez TextHtml et entrez le Corps du texte. Le corps de texte est envoyé avec la demande d’authentification.
    TextPlain Dans la liste déroulante, sélectionnez TextPlain et entrez le Corps du texte. Le corps de texte est envoyé avec la demande d’authentification.
    TextXml Dans la liste déroulante, sélectionnez TextXml et entrez le Corps du texte. Le corps de texte est envoyé avec la demande d’authentification.

  8. Dans l’onglet Configuration, remplissez le champ Dépassement de délai (ms)*. Ce champ représente le délai observé par le produit avant de renvoyer un message de dépassement de délai. Le délai est calculé en millisecondes.

  9. Dans l’onglet Secrets, cliquez sur +Ajouter un secret et entrez le Nom du secret et la Valeur du secret. Il s’agit d’un ensemble de paires clé/valeur qui sont chiffrées et peuvent être référencées dans d’autres parties du connecteur, comme les paramètres de requête, les en-têtes ou le corps. Référencez les secrets avec des doubles crochets.

  10. Dans l’onglet Demandes, vous pouvez rechercher des demandes existantes à l’aide du champ Rechercher des demandes. Sélectionnez la case à cocher à côté de la demande pour l’utiliser avec le connecteur. Cliquez surOK. Une fois la demande sélectionnée, elle s’ajoute automatiquement dans les propriétés de cette action Studio CONNECTREQUEST. Si vous n’avez aucune demande existante, vous devez en créer.

  11. Cliquez sur Sauvegarder.

  12. Vous pouvez cliquer sur Test pour tester l’authentification d’un connecteur avec une application tierce.

Création de demandes

Les demandes sont des ensembles d’appels de service web configurés à des fins particulières. Elles sont créées au sein du connecteur. Un connecteur peut contenir 20 demandes au total, 10 actives et 10 inactives. Si vous avez déjà créées des demandes et n’avez plus besoin d’en créer, vous pouvez ignorer ces étapes.

  1. Lancez Integration Hub et sélectionnez une connexion dans Mes connexions sur la gauche.

  2. Accédez à l’onglet Demandes, puis cliquez sur + Ajouter une demande.

  3. Entrez le Nom de la demande.

  4. Sélectionnez le type de Déclencheur :

  5. Configurez la demande en fonction du type de Déclencheur que vous sélectionnez.

    • Pour Manuel, indiquez l’URL, la Méthode, les En-têtes, les Paramètres de requête et le Type de média.

      champs Détails
      URL L’URL utilisée pour la demande d’authentification.
      Méthode La méthode REST spécifique utilisée pour la demande d’authentification.
      Entêtes Cliquez sur + Ajouter un en-tête et entrez le Nom de l’en-tête et la Valeur de l’en-tête.
      Paramètres de requête Cliquez sur +Ajouter un paramètre de requête et entrez le Nom du paramètre de requête et la Valeur du paramètre de requête. Il s’agit d’un ensemble de paires clé/valeur qui sont envoyées avec la demande d’authentification.

      Type de Média

      ApplicationJson : dans la liste déroulante, sélectionnez ApplicationJson et entrez le Corps du texte. Le corps de texte est envoyé avec la demande d’authentification.

      ApplicationJsonPatch : dans la liste déroulante, sélectionnez ApplicationJsonPatch et entrez le Corps du texte. Le corps de texte est envoyé avec la demande d’authentification.

      FormURLEncoded : dans la liste déroulante, sélectionnez FormURLEncoded et cliquez sur + Ajouter un paramètre de formulaire. Entrez le Nom du paramètre de formulaire et la Valeur du paramètre de formulaire. Il s’agit d’un ensemble de paires clé/valeur qui sont envoyées avec la demande d’authentification. Ce type de média envoie les demandes en utilisant les notations URL courantes. Il vous permet également de référencer des secrets et est disponible dans les demandes manuelles et les demandes déclenchées dans Studio.

      TextHtml : dans la liste déroulante, sélectionnez TextHtml et entrez le Corps du texte. Le corps de texte est envoyé avec la demande d’authentification.

      TextPlain : dans la liste déroulante, sélectionnez TextPlain et entrez le Corps du texte. Le corps de texte est envoyé avec la demande d’authentification.

      TextXml : dans la liste déroulante, sélectionnez TextXml et entrez le Corps du texte. Le corps de texte est envoyé avec la demande d’authentification.

    • Pour Studio, un paquet JSON doit être créé pour définir les données à fournir avec la demande.

      {

      "URL": "[[INSTANCEURI]]/INCONTACTAPI/SERBICES/V26.0/AGENTS",

      "HTTPMETHOD": "POST",

      "HEADERS": [

      {

      "CONTENT-TYPE": "APPLICATION/X-WWW-FORM-URL-ENCODED",

      "AUTHORIZATION": "BEARER[[BEARERTOKEN]]"

      }

      ],

      "QUERYPARAMETERS": [

      {

      "ANI": "[[ANI]]",

      "ACCOUNTID": "123456"

      }

      ],

      "BODY": [

      {

      "ANI": "[[ANI]]",

      "ACCOUNTID": "123456",

      "ACCOUNTNAME": "TESTACCOUNT"

      }

      ]

      }

  6. Dans le coin supérieur droit, sélectionnez si la demande est Active ou Inactive.

  7. Cliquez sur Confirmer.

Une fois que vous avez configuré l’intégration, cliquez sur la coche Icône en forme de coche. située à côté dans la liste Mes connexions. Ensuite, sélectionnez Non ou Oui pour l’utiliser avec l’action Studio.