Dans cet article
dropdown icon
Introduction
    À propos de Cisco Business Rules Engine
dropdown icon
Implémentation du moteur de règles métier
    Créer un ensemble de règles
    Configurer une instance de BRE DataSync
    Création d'un flux avec l'activité de requête BRE
    dropdown icon
    Requête BRE
      Paramètres généraux
      Paramètres de requête
      Paramètres d'analyse
      Variables de sortie

Webex Contact Center Guide de l'utilisateur du moteur de règles métier

list-menuDans cet article
list-menuUn commentaire ?

Le moteur de règles métier (BRE) de Webex Contact Center permet aux clients de téléchargerrntttttdes données spécifiques auxquelles le système peut accéder pendant l'exécution pour prendre des décisions de routage ournttttafficher des informations pour appeler des agents.

Introduction

À propos de Cisco Business Rules Engine

À l'aide du moteur de règles métier Cisco© (BRE), vous pouvez télécharger vos données dans l'environnement Webex Contact Center pour un routage personnalisé et une mise en œuvre générale. Le système récupère les données au moment de l'exécution et les utilise pour prendre des décisions de routage ou afficher des informations à l'agent.

Par exemple, un service partagé souhaite router les appels vers un groupe spécifique d'agents en fonction du numéro d'identification automatique (ANI) composé. Dans ce scénario, le locataire peut simplement télécharger une liste d'ANI. Si l'ANI de l'appel entrant figure dans cette liste, le système achemine l'appel vers le groupe d'agents spécifié. S'il ne figure pas dans la liste, le système achemine l'appel vers la file d'attente générale.

Une mise en œuvre typique de BRE implique ces composants majeurs :

  • L'utilitaire Moteur de règles métier fournit une interface pour créer des domaines et des ensembles de règles. Le BRE nécessite qu'une demande de décision entrante soit associée à un domaine. Le domaine contient un ensemble de règles. Une priorité est affectée à chaque règle. Le BRE tente de faire correspondre la règle de priorité la plus élevée du domaine avec la demande de décision en fonction des conditions des règles.

  • L'utilitaire de configuration BRE DataSync fournit une interface permettant de définir les instances de Data Sync pour importer des données dans la base de données BRE. Une fois que le locataire a défini l'instance Data Sync, il peut télécharger un fichier CSV. Le système convertit les données de valeurs séparées par des virgules téléchargées en enregistrements dans la base de données BRE.

  • Flow Designer est une interface utilisateur glisser-déposer permettant de définir des flux qui orchestrent et automatisent les composants du Webex Contact Center. Vous pouvez créer un flux qui appelle le BRE.

Directives relatives au traitement des données

Pour maintenir l'intégrité et la sécurité du BRE, vous devez vous conformer aux directives de traitement des données suivantes :

  • Types de données autorisés : téléchargez les données essentielles au fonctionnement et à la fonctionnalité du BRE. Cela inclut, de manière non limitative, les règles métier, les configurations et les données opérationnelles non sensibles.

  • Restriction sur les IPI : Ne téléchargez aucune information personnelle identifiable (PII) sur le BRE, à l'exception des données ANI. Les IPI comprennent, sans toutefois s'y limiter :

    • Noms complets
    • Numéros de sécurité sociale
    • Adresses e-mail
    • Adresses physiques
    • Informations financières

Les données ANI font référence au numéro de téléphone associé à l'appelant. Les données ANI sont le seul type de PII dont le téléchargement sur le BRE est autorisé. Cette exception vise à prendre en charge des fonctionnalités métier spécifiques qui reposent sur des données ANI.

Implémentation du moteur de règles métier

Créer un ensemble de règles

Les flux appellent l'utilitaire Moteur de règles métier lorsqu'une nouvelle demande vocale est présentée au ACD. Cette section explique comment vous pouvez définir des règles afin que l'utilitaire BRE puisse aider le ACD à acheminer la demande entrante.
Diagramme de l'utilitaire Business Rule Engine appelé par un flux dans Webex Contact Center. Contrôle de flux dans Webex Contact Center Flow Designer > demande de recherche > cisco BRE > read > BRE Repository.

Le BRE nécessite qu'une demande de décision entrante soit associée à un domaine et à un ensemble de règles. L'ERB tente de faire correspondre la règle de priorité la plus élevée à la demande de décision en fonction des conditions énoncées dans les règles.

Assurez-vous de créer un ensemble de règles pour couvrir tous les cas. Par exemple, vous devez créer des règles pour les conditions Correspondance trouvée et Correspondance introuvable . Vous pouvez également définir des règles pour plusieurs conditions. Par exemple, ANI Match ou ANI No Match, puis Gold ou Silver. Dans ce cas, vous devez créer une règle pour chaque possibilité. Par exemple :

  • ANI Match et Or

  • ANI Match et Argent

  • ANI No Match et Or

  • ANI No Match et Argent

Pour créer un ensemble de règles :

1

Connectez-vous au portail de gestion Cisco Webex Contact Center.

2

Cliquez sur le chemin d'accès Cisco Webex Contact Center Management Portal > business Rules pour ouvrir l'utilitaire Business Rules Engine.

BRE utilise un service de vérification d'identité et une interaction de connexion unique. Si les locataires se sont déjà connectés à Cisco Webex Contact Center Management Portal, ils peuvent automatiquement accéder à l'utilitaire BRE pour leur organisation.

3

Créez un attribut à associer à votre organisation :

  1. Sélectionnez Attributs et cliquez sur Ajouter dans la page Attributs .

  2. Sur la page Attributs, entrez le contexte dans le champ Nom .

  3. Sélectionnez le type de données sous forme de texte dans la liste déroulante.

    Le type de données doit être Texte dans l'utilitaire BRE.

  4. Cliquez sur Enregistrer.

4

Sélectionnez Contextes pour afficher la page Contextes . Cliquez sur + Ajouter du contexte.

  1. Saisissez un nom et une description (facultative).

  2. Si plusieurs attributs sont créés, sélectionnez l'attribut que vous souhaitez associer à ce contexte dans la liste déroulante Attribut .

  3. Cliquez sur Enregistrer.

5

Pour créer des règles, sélectionnez la page Contextes .

  1. Cliquez sur + Ajouter une règle de la page, spécifiez les paramètres décrits dans le tableau suivant :

    Champ

    Description

    Nom

    Nom de la règle.

    Description

    Une description facultative de la règle.

    Actif

    Cochez la case pour spécifier que la règle est active.

    Étiquette

    Choisissez l'étiquette appropriée dans la liste déroulante.

    Priorité

    Faites glisser le curseur pour affecter une priorité à la règle. Le système exécute les règles en fonction de la priorité affectée, de la plus élevée (100) à la plus basse.

    Il est recommandé de commencer à affecter des priorités à partir de 100 dans l'ordre décroissant.

    Conditions

    Spécifiez les conditions dans la liste déroulante, puis sélectionnez les attributs et les valeurs.

  2. Cliquez sur la section Ajouter une règle (Éditeur) de la page, spécifiez les paramètres décrits dans le tableau suivant :

    Champ

    Description

    Nom

    Nom de la règle.

    Description

    Une description facultative de la règle.

    Actif

    Cochez la case pour spécifier que la règle est active.

    Étiquette

    Choisissez l'étiquette appropriée dans la liste déroulante.

    Priorité

    Faites glisser le curseur pour affecter une priorité à la règle. Les règles seront exécutées en fonction de la priorité affectée, de la plus élevée (100) à la plus basse.

    Conditions

    Sélectionnez les conditions dans la liste déroulante et spécifiez les attributs et les valeurs.

    Éditeur de règles

    Entrez le code de la règle.

  3. Cliquez sur Enregistrer.

L'exemple de code suivant retourne la valeur d'un attribut nommé routeInfo. Ceci se produit si le numéro à partir duquel l'appelant a composé (ANI) correspond à l'ANI de la liste des services partagés téléchargés dans la base de données BRE. Copiez et collez la règle suivante dans l'éditeur derègles :
when c : Contact() eval(c.getGlobalValuesManager().getAsString( c.getTenantId(), c.getAttribute("context")+ ». » + c.getAttribute("ani")) != null) then c.putAttribute("routeInfo", c.getGlobalValuesManager().getAsString(c.getTenantId(), c.getAttribute("context")+ ». » + c.getAttribute("ani"))) ; fin
BRE Contexts page with an example code returns value for ANIFound for attribute routeinfo.

L'exemple de code suivant renvoie la valeur NotFound pour l'attribut routeInfo. Cela se produit si un numéro à partir duquel l'appelant a composé (ANI) ne correspond pas à un ANI de la liste des locataires téléchargés dans la base de données BRE. Copiez et collez la règle suivante dans l'éditeur derègles :

when c : Contact() eval(c.getGlobalValuesManager().getAsString( c.getTenantId(), c.getAttribute("context")+ ». » + c.getAttribute("ani")) == null) then c.putAttribute("routeInfo", "NotFound « ) ; fin

BRE Contexts page with an example code returns value for ANINotFound for attribute routeinfo.

Configurer une instance de BRE DataSync

Le composant BRE DataSync accède à une base de données pour prendre des décisions de routage. Assurez-vous de mettre à jour régulièrement la base de données avec les informations appropriées. Cette section explique comment configurer l'utilitaire BRE DataSync pour mettre à jour le référentiel BRE.

Diagram for how the BRE DataySync utility is configured to update the BRE repository. BRE DataSync > CRUD > BRE Repository.
Utilitaire BRE DataSync

L'administrateur du locataire doit créer une instance de DataSync BRE pour chaque ensemble de données consulté par les moteurs de règles au cours de son processus décisionnel. L'administrateur peut créer l'ensemble de données ou télécharger un fichier CSV. Les données sont converties en enregistrements dans le référentiel BRE.

Avant de commencer

Contactez Cisco Customer Service Account Manager pour accéder au compte BRE DataSync.

BRE DataSync n'est actuellement activé que pour le rôle d'administrateur complet. Les locataires dotés du rôle Administrateur complet peuvent télécharger des données à l'aide du téléchargement de fichier CSV ou des paires clé-valeur. Les utilisateurs dotés de ce rôle peuvent télécharger uniquement les données spécifiques à leur organisation.

L'administrateur partenaire, l'administrateur externe, les agents et les superviseurs n'ont pas accès à l'utilitaire BRE DataSync.

1

En tant qu'administrateur, connectez-vous à l'utilitaire BRE DataSync.

Conformément aux récentes améliorations apportées à l'hébergement et à l'évolutivité BRE, les URL de l'utilitaire DataSync ont changé. Assurez-vous d'utiliser les URL mises à jour pour télécharger des données dans BRE.

2

Sélectionnez Liste de données BRE pour afficher toutes les informations relatives à l'organisation du locataire.

3

(Facultatif) Sélectionnez Ajouter des données BRE pour ajouter des données au référentiel BRE.

  1. Sélectionnez le nom de l'organisation dans la liste déroulante NomLocataire .

  2. Sélectionnez le type de recherche BRE dans la liste déroulante.

    Contact Cisco Customer Success Manager ou Solution Assurance Contact pour ajouter de nouveaux types de recherche.

  3. Cliquez sur Ajouter des données pour entrer la clé et la valeur.

  4. (Facultatif) Cliquez sur Supprimer pour supprimer une clé et une valeur existantes .

  5. Cliquez sur Soumettre.

4

Sélectionnez Télécharger les données BRE CSV pour télécharger le fichier CSV.

  1. Sélectionnez le nom de l'organisation dans la liste déroulante NomLocataire .

  2. Sélectionnez le type de recherche BRE dans la liste déroulante.

  3. Sélectionnez Télécharger pour parcourir et télécharger le fichier CSV.

  4. Cliquez sur Soumettre.

    Sample CSV file for the BRE CSV data upload. Column headers are 'ANI', 'Extension', and 'Action'.
    Exemple de fichier CSV avec données
    Les actions Supprimer, Mettre à jour et Ajouter ne respectent pas la casse. Vous pouvez également utiliser la syntaxe 725160001,,Delete pour supprimer les données.

Création d'un flux avec l'activité de requête BRE

Vous pouvez créer des flux à l'aide de l'interface Flow Designer disponible dans le portail de gestion Webex Contact Center. Créez un flux avec l'activité Demande BRE dans le Concepteur de flux Webex Contact Center.

Pour plus d'informations sur la configuration du flux, consultez la requête BRE.

Requête BRE

Utilisez l'activité Demande BRE pour récupérer les données du moteur de règles métier (BRE) de votre organisation afin de les utiliser dans le flux. L'activité de requête BRE utilise les protocoles HTTP standard pour récupérer les données du BRE.

Les sections suivantes vous permettent de configurer l'activité de requête BRE :

Paramètres généraux

Paramètre

Description

Étiquette d'activité

Saisissez le nom de l'activité.

Description de l'activité

(Facultatif) Saisissez une description de l'activité.

Paramètres de requête

Dans le cadre de la requête BRE, vous pouvez passer les paramètres qui sont fournis dans l'appel API au BRE. Dans les colonnes Valeur‐clé, vous pouvez entrer la clé de la requête et la valeur associée à envoyer avec la requête. Vous pouvez également utiliser la syntaxe entre doubles accolades pour transmettre des valeurs de variable.

L'activité BRE a un paramètre de requête prédéfini : le contexte. Ce paramètre de requête est transmis dans l'appel API au BRE.

L'ID du locataire est automatiquement injecté en tant que paramètre et n'a pas besoin d'être configuré.

Tableau 1. Paramètres de requête

Paramètre

Description

Contexte

Contient la raison de la demande. Ce paramètre obligatoire ne peut être ni modifié, ni supprimé.

Ce paramètre doit contenir la même valeur que la valeur spécifiée dans le contexte Attribut dans BRE. Pour plus d'informations, consultez la . Créer un ensemble de règles du Cisco Webex Contact Center Guide de l'utilisateur du moteur de règles métier.

ANI

Contient le numéro de téléphone d'origine de l'appel. Il s'agit d'un paramètre par défaut que vous pouvez modifier ou supprimer, en fonction de la configuration des règles dans le BRE.

Un exemple de valeur pour ANI est {{NewPhoneContact.ANI}}

Délai de réponse expiré

Spécifie le délai d'expiration de la connexion pour la requête BRE. La valeur par défaut est 2000 millisecondes.

Nombre de nouvelles tentatives

Spécifie le nombre de tentatives de requête BRE après un échec.

Ce paramètre est utilisé si le code d'état est 5xx ; par exemple, 500 ou 501.

Pour ajouter un paramètre de requête, cliquez sur Ajouter nouveau. Cette action ajoute une ligne dans laquelle vous pouvez entrer les paires clé-valeur. Vous pouvez ajouter autant de paramètres de requête que nécessaire dans le cadre de la requête BRE.

Paramètres d'analyse

Cette section vous permet d'analyser la réponse de la requête BRE en différentes variables :

Paramètre

Description

Variable de réponse

Choisissez une variable vers laquelle vous souhaitez extraire une section particulière de l'objet de réponse BRE Request. Vous pouvez choisir uniquement des variables de flux personnalisées dans la liste déroulante.

Expression de chemin d'accès

Définissez l'expression de chemin d'accès pour l'analyse de l'objet de réponse. Selon le type de structure de données de l'objet de réponse et les cas d'utilisation pour extraire un sous-ensemble de ces informations, l'expression de chemin d'accès varie.

Les données sont normalisées dans une hiérarchie d'objets avant l'exécution de l'expression de chemin, de sorte que JSONPath est utilisé dans l'objet de réponse quel que soit le type de contenu configuré.

Variables de sortie

La requête BRE renvoie deux variables de sortie :

  • BRERequest1.httpResponseBody : renvoie le corps de la réponse pour la requête BRE.

  • BRERequest1.httpStatusCode : renvoie le code d'état de la requête BRE.

    Ces codes de réponse sont classés dans les catégories suivantes :

    • Réponses informatives (100–199)

    • Réponses réussies (200–299)

    • Redirections (300–399)

    • Erreurs client (400–499)

    • Erreurs serveur (500–599)

Formats de type de contenu

Les exemples suivants décrivent des exemples de formats de type de contenu d'entrée et la réponse JSON.

Type de contenu XML

Utilisez cet outil pour convertir XML au format JSON https://codeshack.io/xml-to-json-converter/.

XML Format d'entrée :

<remarque> <à>Tove</à> <partir de>Jani</de> <titre>Rappel</en-tête> <corps>Application test</corps> </note> 

Réponse normalisée aux données/JSON

{ "note" : { "to" : "Tove", "from" : "Jani", "heading" : "Reminder", "body" : "Test application" } } 

Exemple d'expression de chemin d'accès JSON : Use $.note.from pour obtenir la valeur Jani .

Type de contenu TOML

Utilisez cet outil pour convertir TOML au format JSON https://www.convertjson.com/toml-to-json.htm.

Format d'entrée TOML :

title = "TOML Example" [owner] name = "Tom Preston-Werner" dob = 1979-05-27T07:32:00-08:00 

Réponse normalisée aux données/JSON

{ "title" : "TOML Example", "owner" : { "name" : "Tom Preston-Werner", "dob" : "1979-05-27T15:32:00.000Z" } } 

Exemple d'expression de chemin JSON : Use $.owner.name pour obtenir la valeur ' Tom Preston-Werner'.

Type de contenu YAML

Utilisez cet outil pour convertir YAML au format JSON https://www.convertjson.com/yaml-to-json.htm.

Format d'entrée YAML :

# Un enregistrement d'employé martin : nom : Martin D’vloper emploi : Compétence développeur : Elite 

Réponse normalisée aux données/JSON

{ "martin" : { "name" : "Martin D’vloper", "job" : "Développeur", "skill" : "Elite" } } 

Exemple d'expression de chemin d'accès JSON : Use $.martin.job pour obtenir la valeur Developer.

Type de contenu JSON

Utilisez JSON Expression Evaluator https://jsonpath.com/.

Format d'entrée JSON :

{ "martin" : { "name" : "Martin D’vloper", "job" : "Développeur", "skill" : "Elite" } } 

Réponse normalisée aux données/JSON

{ "martin" : { "name" : "Martin D’vloper", "job" : "Développeur", "skill" : "Elite" } } 

Exemple d'expression de chemin d'accès JSON : Use $.martin.job pour obtenir la valeur Developer.

Cet article était-il utile ?
Cet article était-il utile ?