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 :
Accédez à User > New (Utilisateur > Nouveau).
Saisissez les informations appropriées, puis sélectionnez "Web service access only" (Accès au service Web uniquement).
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.
Dans le menu, sélectionnez Configure > Form Design (Configurer > Conception de formulaire) pour ouvrir le concepteur de formulaires.
Dans la colonne de gauche, sélectionnez l'onglet Field Types (Types de champs).
Faites glisser le type de champ personnalisé que vous souhaitez ajouter.
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.
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.
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
Accédez à All > System Applications > All Available Applications > All (Tous > Applications système > Toutes les applications disponibles > Tous).
Recherchez "OpenFrame".
Installez OpenFrame.
Après l'installation, accédez à All > OpenFrame > Configurations (Tout > OpenFrame > Configurations).
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.
Saisissez
sys_properties.listdans la barre de recherche.Modifier
glide.ui.concourse.onmessage_enforce_same_origin_whitelist.Ajoutez la nouvelle URL à la liste des valeurs.
Modifier
sn_openframe.cross.origin.access.Ajoutez
autoplayà la liste des valeurs.
Activer l'expérience Next UI pour les utilisateurs
Saisissez
sys_properties.listdans la barre de navigation, puis appuyez sur Entrée.Définissez la propriété système
glide.ui.polaris.experiencesur true.Définissez la préférence utilisateur
glide.ui.polaris.usesur false pour le système.Définissez la préférence utilisateur
glide.ui.polaris.usesur true pour un utilisateur. (Vous pouvez créer une ligne de préférences utilisateur.)
Mettre à jour les propriétés système
Saisissez
sys_properties.listdans la barre de navigation, puis appuyez sur Entrée.Modifier
glide.ui.concourse.onmessage_enforce_same_origin_whitelist.Ajoutez l'URL à la liste des valeurs. Les valeurs multiples doivent être séparées par une virgule.
Modifier
sn_openframe.cross.origin.access.Ajoutez "autoplay" à la liste des valeurs.
Modifier
glide.ui.polaris.experience.Remplacez par false, car certaines fonctionnalités ne fonctionnent pas si elles sont activées.
Ajouter un bouton d'appel en haut du formulaire
Accédez à System UI > UI Actions (UI système > Actions de l'UI).
Sélectionnez Créer une action.
Dans le formulaire, sélectionnez le tableau auquel ce bouton d'appel sera ajouté.

Pour les formulaires faisant référence à un contact ou à un utilisateur, utilisez l'API
g_form.getReferencepour 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); }); }Pour les formulaires contenant un numéro à appeler, utilisez l'API
g_form.getValuepour 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
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_phoneoushow_phone_customer_serviceà la valeurref_contributions.Dans "UI Macros" (Macros d'interface utilisateur), modifiez
show_phoneetshow_phone_customer_service.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.
Dans le portail CCAI Platform, accédez à Settings > Developer Settings > CRM (Paramètres > Paramètres du développeur > CRM).
Dans la section "Agent Platform", sélectionnez ServiceNow.
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.Dans le champ ServiceNow Cloud Selection (Sélection du cloud ServiceNow), sélectionnez
Incidentpour un type de ticket de base. Si vous sélectionnezCustom, 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.Dans les champs Identifiants d'authentification, saisissez votre nom d'utilisateur et votre mot de passe.
Si vous avez sélectionné
Incidentpour 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 fieldsetPhone number primary field.
- Lookup account object (Rechercher un objet de compte) inclut trois champs déroulants :
Si vous avez sélectionné
Custompour 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
taskouincident.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 fieldsetPhone number primary field.
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).
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.
Fichier de métadonnées de session : cochez cette case pour joindre les métadonnées de session aux enregistrements CRM.
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
Dans votre compte ServiceNow, accédez à All > System OAuth > Application Registry (Tous > OAuth système > Registre des applications).
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).
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_callbackAppliquer 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.
Cliquez sur Envoyer.
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
Accédez à Developer Settings > CRM (Paramètres du développeur > CRM).
Assurez-vous que les paramètres sont saisis et configurés conformément aux étapes précédentes.
Sous "Méthode d'authentification", cliquez sur OAuth.
Saisissez l'ID client OAuth et le code secret du client OAuth. (voir l'étape 5 ci-dessus).
Cliquez sur Enregistrer.
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
Accédez à Settings > Operation Management (Paramètres > Gestion des opérations).
Accédez à la section Mappage des champs personnalisés CRM, puis cliquez sur Tout afficher.
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,
devicepour les charges utiles du SDK ouorderIdpour 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 AppsSend custom data in a chat. La clé doit correspondre exactement (y compris la casse).
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.