ServiceNow

Contact Center AI Platform (CCAI Platform) s'intègre à ServiceNow CRM.

Paramètres du développeur ServiceNow

Configuration minimale requise pour ServiceNow : Tokyo patch 1

Configurer un utilisateur d'authentification de base

Il est probable que la validation en deux étapes soit activée pour le compte administrateur ServiceNow et associée à cet utilisateur. Par conséquent, il ne peut pas être utilisé pour obtenir un accès administrateur dans CCAI Platform. Pour ce faire, vous devez créer un compte utilisateur dans ServiceNow.

Créez un utilisateur de base avec des identifiants :

  1. Accédez à User > New (Utilisateur > Nouveau).

  2. Saisissez les informations appropriées, puis sélectionnez "Web service access only" (Accès au service Web uniquement).

  3. Notez l'ID utilisateur et le mot de passe.

Rôles requis dans ServiceNow

Les rôles par défaut dans ServiceNow sont préconfigurés pour fournir des accès et des autorisations spécifiques au sein de la plate-forme. Les administrateurs peuvent créer et configurer des rôles qui accordent des autorisations spécifiques, lesquelles régissent ce que les utilisateurs et les groupes disposant de ce rôle peuvent faire.

Pour effectuer cette intégration, vous devez disposer des rôles suivants dans ServiceNow :

  • user_admin : ce rôle est conçu pour les administrateurs qui doivent gérer les utilisateurs, les groupes, les emplacements et les entreprises dans l'instance ServiceNow.

  • sn_incident_read : ce rôle fournit un accès en lecture seule à l'application de gestion des incidents et à ses fonctions associées. Il permet aux utilisateurs de consulter les enregistrements d'incidents.

  • sn_incident_write : ce rôle accorde un accès en écriture à l'application de gestion des incidents et à ses fonctions associées, ce qui permet aux utilisateurs de créer et de modifier des enregistrements d'incidents.

  • personalize_dictionary : ce rôle permet de personnaliser les entrées et les libellés du dictionnaire pour répondre à des exigences métier spécifiques.

  • function_field_admin : ce rôle est destiné aux utilisateurs qui doivent créer, modifier et afficher des champs de fonction spécifiquement dans le concepteur de rapports. Il ne permet pas de créer ni de supprimer des champs de fonction à partir de la liste ou du formulaire de la plate-forme.

Configurer les vues d'instance

Les sections suivantes décrivent les modifications de configuration nécessaires pour instancier des vues.

(Facultatif) Ajouter des favoris

Les favoris vous permettent de trouver rapidement les liens que vous utilisez le plus souvent dans l'instance ServiceNow. Pour ajouter un favori, sélectionnez l'icône en forme d'étoile à côté d'un champ dans le panneau "Navigateur". Si vous souhaitez filtrer ultérieurement le panneau de navigation pour ne voir que vos favoris, vous pouvez sélectionner l'icône en forme d'étoile située juste en dessous du champ de navigation du filtre dans le panneau de navigation.

Exemples de favoris utiles :

  • Incidents : associations à des enregistrements pour un CRM personnalisé.

  • Utilisateurs : associations à des comptes pour un CRM personnalisé.

  • Explorateur d'API REST : un bon moyen de tester l'API.

Ajouter des champs personnalisés manuellement

Sélectionnez l'icône de développement (trois lignes horizontales) en haut à gauche de la vue de l'objet que vous souhaitez modifier. Vous pouvez le faire dans la vue Self-service ou la vue par défaut.

  1. Dans le menu, sélectionnez Configure > Form Design (Configurer > Conception de formulaire) pour ouvrir le concepteur de formulaires.

  2. Dans la colonne de gauche, sélectionnez l'onglet Field Types (Types de champs).

  3. Faites glisser le type de champ personnalisé que vous souhaitez ajouter.

  4. Après avoir déposé le type de champ dans la section de votre choix, sélectionnez l'icône en forme de roue dentée pour afficher les paramètres.

  5. Dans la fenêtre, modifiez l'étiquette et notez le nom. Le nom est celui que vous utilisez dans les paramètres de l'application CCAI Platform.

  6. Sélectionnez Enregistrer en haut à droite de l'écran.

Mapper les données de session au CRM

Vous devez mapper les données de session appropriées de CCAIP à l'aide de Dialogflow et utiliser les paramètres suivants :

Données de l'agent virtuel

{
  "ujet": {
    "session_variable": {
      "capture_target": "payload",
      "payload": {
        "value_one": "$session.params.payload_value_one"
      };
      "capture_type": [ "comment", "field" ] // optional, default of ["comment"]
    }
  }
}

Métadonnées

https://INSTANCE.service-now.com/api/now/table/sys_dictionary?sysparm_query=name%3Dsys_user https://INSTANCE.service-now.com/api/now/table/sys_dictionary?sysparm_query=name%3Dincident

Libellé : column_label

Clé API : element

Les champs personnalisés se trouvent au même niveau que les champs standards dans la réponse de sys_user ou incident.

Importer un fichier depuis CCAI Platform vers le CRM

https://INSTANCE_URL.service-now.com/api/now/attachment/upload

Méthode : POST

Format des données de la requête : property

Emplacement des données de réponse : data.result

Type : Multi-part form

Type de pièce jointe : Attachment Url

URL de la pièce jointe : download_link

Paramètres : table below

Exemple de requête :

{
    file: FILE_DATA,
    table_name: incident,
    table_sys_id: RECORD_ID
}

Intégrer des adaptateurs d'agent (formulaires personnalisés)

Les étapes suivantes vous guident tout au long du processus d'activation des adaptateurs d'agent et de la fonction de clic pour appeler dans l'instance ServiceNow.

Installer et configurer OpenFrame

  1. Accédez à All > System Applications > All Available Applications > All (Tous > Applications système > Toutes les applications disponibles > Tous).

  2. Recherchez "OpenFrame".

  3. Installez OpenFrame.

  4. Après l'installation, accédez à All > OpenFrame > Configurations (Tout > OpenFrame > Configurations).

  5. Créez une configuration avec une URL. Si vous disposez de plusieurs configurations dans une instance ServiceNow, il est possible que votre utilisateur n'ait pas accès à une configuration nouvellement créée. Vérifiez vos groupes et la liste des ordres de configuration OpenFrame pour déterminer la configuration utilisée par votre utilisateur.

  6. Saisissez sys_properties.list dans la barre de recherche.

  7. Modifier glide.ui.concourse.onmessage_enforce_same_origin_whitelist.

  8. Ajoutez la nouvelle URL à la liste des valeurs.

  9. Modifier sn_openframe.cross.origin.access.

  10. Ajoutez autoplay à la liste des valeurs.

Activer l'expérience Next UI pour les utilisateurs

  1. Saisissez sys_properties.list dans la barre de navigation, puis appuyez sur Entrée.

  2. Définissez la propriété système glide.ui.polaris.experience sur true.

  3. Définissez la préférence utilisateur glide.ui.polaris.use sur false pour le système.

  4. Définissez la préférence utilisateur glide.ui.polaris.use sur true pour un utilisateur. (Vous pouvez créer une ligne de préférences utilisateur.)

Mettre à jour les propriétés système

  1. Saisissez sys_properties.list dans la barre de navigation, puis appuyez sur Entrée.

  2. Modifier glide.ui.concourse.onmessage_enforce_same_origin_whitelist.

  3. Ajoutez l'URL à la liste des valeurs. Les valeurs multiples doivent être séparées par une virgule.

  4. Modifier sn_openframe.cross.origin.access.

  5. Ajoutez "autoplay" à la liste des valeurs.

  6. Modifier glide.ui.polaris.experience.

  7. Remplacez par false, car certaines fonctionnalités ne fonctionnent pas si elles sont activées.

Ajouter un bouton d'appel en haut du formulaire

  1. Accédez à System UI > UI Actions (UI système > Actions de l'UI).

  2. Sélectionnez Créer une action.

  3. Dans le formulaire, sélectionnez le tableau auquel ce bouton d'appel sera ajouté.

  4. Pour les formulaires faisant référence à un contact ou à un utilisateur, utilisez l'API g_form.getReference pour accéder au numéro de téléphone de l'utilisateur. Pour les tables personnalisées, l'ID de référence et les attributs obtenus peuvent différer. La communication avec CCAI Platform sera la même. Par conséquent, la charge utile et la structure des données doivent rester identiques à ce qui suit :

    function clickToDial() {
      var user = g_form.getReference('caller_id',function(res) {
        var phone = res.phone || res.mobile_phone;
        var payload = {"name": "clicktodial", "number": phone};
        var data = {"payload": payload, "method": "openframe_communication" };
        CustomEvent.fireAll("openframe_request", data);
      });
    }
    
  5. Pour les formulaires contenant un numéro à appeler, utilisez l'API g_form.getValue pour récupérer les valeurs pertinentes. Voici un exemple d'action d'UI pour la table "Users". Pour les tables personnalisées, les noms des champs de formulaire peuvent être différents. La communication avec la plate-forme CCAI sera la même. Par conséquent, la charge utile et la structure des données doivent rester identiques à ce qui suit :

    function clickToDial() {
      var phone = g_form.getValue('phone') || g_form.getValue('mobile_phone');
      var payload = {"name": "clicktodial", "number": phone};
      var context = {"payload": payload, "method" : "openframe_communication" };
      CustomEvent.fireAll("openframe_request", context);
    }
    

Ajouter l'appel direct à côté des références

  1. Le bouton d'appel à côté des références aux contacts doit être modifié dans le formulaire. Effectuez un clic droit sur le champ, puis accédez à Configure Dictionary (Configurer le dictionnaire). Pour les attributs, ajoutez la valeur show_phone ou show_phone_customer_service à la valeur ref_contributions.

  2. Dans "UI Macros" (Macros d'interface utilisateur), modifiez show_phone et show_phone_customer_service.

  3. Remplacez les éléments suivants :

Précédent :

var task =    {"entity": p.attr('data-task-table'), "query" :"sys_id="+p.attr('data-task-id')+"$[AMP]sysparm_view="+p.attr('data-task-view'),"value":p.attr('data-task-value'),"label":p.attr('data-task-label')};
                                        var company = {"entity": p.attr('data-company-table'),"query":"sys_id="+p.attr('data-company-id')+"$[AMP]sysparm_view="+p.attr('data-task-view'),"value":p.attr('data-company-value'),"label":p.attr('data-company-label')};
                                        var caller = {"entity": p.attr('data-caller-table'),"query": "sys_id="+p.attr('data-caller-id')+"$[AMP]sysparm_view="+p.attr('data-task-view'),"value":p.attr('data-caller-value'),"label":p.attr('data-caller-label')};

                                        var callContext = [];
                                        callContext.push(task);
                                        callContext.push(company);
                                        callContext.push(caller);

                                        var metaData = {"phoneNumber":p.attr('data-caller-phone'),"taskId":p.attr('data-task-id')};

                                        var data =    {"metaData":metaData , "data": callContext};
                                        var payload = {"type": "OUTGOING_CALL", "data" : data};
                                        var createInteractionData ={};
                                        createInteractionData.interactionSysId = -1;
                                        createInteractionData.direction = 'outbound';
                                        createInteractionData.context_document = p.attr('data-task-id');
                                        createInteractionData.context_table = p.attr('data-task-table');
                                        createInteractionData.account = p.attr('data-company-id');
                                        if(p.attr('data-caller-table') === 'customer_contact')
                                                createInteractionData.contact = p.attr('data-caller-id');
                                        createInteractionData.opened_for = p.attr('data-caller-id');

                                        var ga = new GlideAjax('sn_openframe.OpenFrameAjaxUtility');
                                        ga.addParam('sysparm_name', 'createInteractionWithPropertyCheck');
                                        ga.addParam('context', JSON.stringify(createInteractionData));
                                        ga.getXML(function(serverResponse) {
                                                var result = serverResponse.responseXML.getElementsByTagName("result");
                                                var output = JSON.parse(result[0].getAttribute("data"));
                                                if(output.status == "success"){
                                                        var interaction = {"entity": "interaction", "query" :"sys_id="+output.fields.interactionSysId, "value":output.fields.number, "label":"Interaction", "display":false};
                                                        payload.data.data.push(interaction);
                                                }
                                                var context = {"payload": payload, "method" : "openframe_communication" };
                                                jslog("context with interaction : "+ JSON.stringify(context));
                                                CustomEvent.fireAll("openframe_request", context);
                                        });

Nouveau :

var phone = p.attr('data-caller-phone')
                   var payload = {"name": "clicktodial", "number": phone};
                   var data = {"payload": payload, "method": "openframe_communication" };
                   CustomEvent.fireAll("openframe_request", data);

Paramètres CRM

Les étapes suivantes expliquent comment connecter l'API à ServiceNow à l'aide du portail CCAI Platform.

  1. Dans le portail CCAI Platform, accédez à Settings > Developer Settings > CRM (Paramètres > Paramètres du développeur > CRM).

  2. Dans la section "Agent Platform", sélectionnez ServiceNow.

  3. Saisissez les informations de votre domaine ServiceNow dans le champ Domaine ServiceNow. Il peut s'agir d'une instance de développeur ou d'une instance de fournisseur, selon les besoins. Elle est directement liée à l'instance et constitue la première partie de l'URL dans l'adresse Web du portail ServiceNow : https://{your instance}.servicenow.com.

  4. Dans le champ ServiceNow Cloud Selection (Sélection du cloud ServiceNow), sélectionnez Incident pour un type de ticket de base. Si vous sélectionnez Custom, des options supplémentaires s'affichent. Les incidents sont des extensions de la table des tâches. Les objets personnalisés doivent être des extensions d'incidents.

  5. Dans les champs Identifiants d'authentification, saisissez votre nom d'utilisateur et votre mot de passe.

  6. Si vous avez sélectionné Incident pour le type de champ de sélection du cloud, les champs suivants s'affichent :

    • Lookup account object (Rechercher un objet de compte) inclut trois champs déroulants : Object Type, Phone Number lookup fields et Phone number primary field.
  7. Si vous avez sélectionné Custom pour le type de champ de sélection du cloud, les champs suivants s'affichent :

    • Objet d'enregistrement de recherche :

      • Type d'objet d'enregistrement de base : sélectionnez un type de table task ou incident.

      • Type d'objet d'enregistrement : ce champ est renseigné avec des données si une table d'incidents a été étendue. Vous pouvez le sélectionner si nécessaire.

      • Lookup account object (Rechercher un objet de compte) inclut trois champs déroulants : Object Type, Phone Number lookup fields et Phone number primary field.

  8. Champs d'ID utilisateur personnalisés : cochez cette case si vous souhaitez activer les champs de recherche d'utilisateurs personnalisés pour les sessions du SDK mobile ou Web, ou de l'API Apps (Chat).

  9. Format du numéro de téléphone : permet de sélectionner le format que vous souhaitez utiliser pour afficher les numéros de téléphone.

  10. Fichier de métadonnées de session : cochez cette case pour joindre les métadonnées de session aux enregistrements CRM.

  11. Cliquez sur Enregistrer pour enregistrer vos sélections.

Champs personnalisés pour les enregistrements

Il s'agit des champs personnalisés qui ont déjà été créés pour l'instance ServiceNow dans le concepteur de formulaires et qui peuvent être utilisés dans CCAI Platform. Vous pouvez également créer d'autres champs personnalisés en sélectionnant Créer dans la section "Champs personnalisés pour les enregistrements" du menu.

Champ Type Définition
u_ujet_custom_field_after_call_work Chaîne Durée du travail après l'appel
u_ujet_custom_field_call_duration Chaîne Durée de l'appel
u_ujet_custom_field_comm_id Integer ID d'appel ou de chat en fonction du type de contact
u_ujet_custom_field_rating Integer Score CSAT
u_ujet_custom_field_email_via_web Chaîne E-mail envoyé depuis le Web
u_ujet_custom_field_feedback Chaîne Commentaires
u_ujet_custom_field_from_phone_number Chaîne Numéro de téléphone de l'appelant
u_ujet_custom_field_hold_duration Chaîne Temps d'attente total
u_ujet_custom_field_menu_path Chaîne Sélection du menu
u_ujet_custom_field_queue_name Chaîne Nom de la file
u_ujet_custom_field_session_type Chaîne Type de session
u_ujet_custom_field_verification Vrai/Faux Confirmer que la validation est terminée
u_ujet_custom_field_wait_time Chaîne Temps d'attente total

Configurer OAuth

Pour configurer OAuth, suivez les étapes de création d'une application OAuth dans ServiceNow. Ensuite, saisissez les identifiants (ID client OAuth et code secret du client OAuth) sous Developer Settings > CRM > Authentication Method (Paramètres du développeur > CRM > Méthode d'authentification).

Créer une application OAuth dans ServiceNow

  1. Dans votre compte ServiceNow, accédez à All > System OAuth > Application Registry (Tous > OAuth système > Registre des applications).

  2. Créez une application OAuth et sélectionnez Create an OAuth API endpoint for external clients (Créer un point de terminaison d'API OAuth pour les clients externes).

  3. Configurez les champs suivants :

    • Nom : saisissez un nom unique.

    • ID client : l'ID client est généré automatiquement par le serveur OAuth ServiceNow.

    • Code secret du client : code secret du client pour l'application OAuth. Laissez ce champ vide pour une génération automatique.

    • Durée de vie du jeton d'actualisation : durée de validité du jeton d'actualisation, en secondes.

    • Durée de vie du jeton d'accès : durée de validité du jeton d'accès, en secondes.

    • URL de redirection : saisissez l'URL de votre environnement, suivie du sous-répertoire. Exemple : https://servicenow.yourcompany.co/v1/servicenow/oauth_callback

    • Appliquer la restriction de jeton : limite l'utilisation du jeton d'accès aux API définies dans les règles d'accès de l'API REST, disponibles dans la documentation ServiceNow. Si vous désélectionnez cette option, le jeton d'accès pourra être utilisé sur d'autres API REST.

  4. Cliquez sur Envoyer.

  5. Après avoir créé l'application, revenez à l'enregistrement et récupérez l'ID client et le code secret du client que vous venez de créer.

Mettre à jour les paramètres dans les paramètres du développeur

  1. Accédez à Developer Settings > CRM (Paramètres du développeur > CRM).

  2. Assurez-vous que les paramètres sont saisis et configurés conformément aux étapes précédentes.

  3. Sous "Méthode d'authentification", cliquez sur OAuth.

  4. Saisissez l'ID client OAuth et le code secret du client OAuth. (voir l'étape 5 ci-dessus).

  5. Cliquez sur Enregistrer.

  6. Cliquez sur Associer les identifiants.

Mappage de champs personnalisés pour l'agent virtuel

Si vous utilisez l'agent virtuel, configurez ce champ sur l'écran Mappages de champs personnalisés. Cela permet de transférer les variables de l'agent virtuel de la charge utile de la session de l'agent virtuel vers ServiceNow. Les noms de variables peuvent être n'importe quelle chaîne. Les libellés de champ listés ici sont fournis à titre d'exemple.

Sur l'écran Mappages de champs personnalisés, configurez la connexion entre les variables créées par les définitions de charge utile que vous avez utilisées dans la configuration initiale de l'agent virtuel et la variable correspondante dans ServiceNow.

Titre du mappage de champs Libellé du champ CRM Libellé du champ de données personnalisé
Commentaires sur l'agent virtuel ccaip_custom_field_incident_feedback va_feedback

Ajouter un mappage de champ CRM

  1. Accédez à Settings > Operation Management (Paramètres > Gestion des opérations).

  2. Accédez à la section Mappage des champs personnalisés CRM, puis cliquez sur Tout afficher.

  3. Cliquez sur le lien + Ajouter un mappage de champ CRM.

    • Titre du mappage de champs : nom CCAI Platform de ce mappage de champs personnalisés utilisé dans le portail CCAI Platform.

    • Libellé du champ CRM : libellé du champ CRM auquel vous effectuez le mappage dans votre CRM.

    • Libellé du champ de données personnalisé (clé de données personnalisée) : nom de la clé de premier niveau dans la charge utile de données personnalisées de la plate-forme CCAI à partir de laquelle vous souhaitez effectuer le mappage (par exemple, device pour les charges utiles du SDK ou orderId pour les charges utiles de chat de l'API Apps). Cette clé doit être envoyée par les SDK Web ou Mobile de CCAI Platform ou (pour les interactions par chat) à l'aide du point de terminaison de l'API Apps Send custom data in a chat. La clé doit correspondre exactement (y compris la casse).

  4. Cliquez sur Enregistrer.

Configurer d'autres paramètres

Vous trouverez les autres paramètres qui vous permettront d'intégrer correctement la plate-forme CCAI à votre instance ServiceNow dans le menu déroulant Paramètres. Consultez les liens de la liste suivante pour en savoir plus sur la configuration de chaque section.

Résultats des tests

Vous pouvez maintenant vérifier le fonctionnement de vos flux d'appels et de chat en cliquant sur les boutons correspondants en haut de l'écran du portail CCAI Platform. Il est important de vous assurer que votre bloqueur de pop-ups est désactivé lorsque vous effectuez ce test.

Un incident doit être créé dans ServiceNow, avec le contact de l'appel ou du chat listé dans la section Activités de l'incident. Il doit s'afficher sous la forme d'une note de travail plutôt que d'un commentaire d'incident, afin que cette activité de backend ne soit pas visible par les clients.

La description de la demande sera automatiquement renseignée avec "Appel via CCAI Platform" ou "Chat via CCAI Platform". Les agents devront peut-être la modifier.

Une fois que vous êtes satisfait des résultats de votre appel ou de votre chat, vous pouvez saisir un code de résolution et une note (si les champs de code de résolution et de notes de ServiceNow ont été configurés), puis fermer la demande.

Pour vérifier que la demande a bien été clôturée, vous devrez peut-être cliquer sur le bouton de navigation back de votre navigateur. Dans l'instance ServiceNow, il est normal qu'une fois la demande résolue, elle se ferme automatiquement et que vous soyez redirigé vers une page d'enregistrement client.