Інтеграція Webex контакт-центру з ServiceNow

У наведених нижче розділах описано кроки для інсталяції конектора ServiceNow для екземплярів розробників.

Зміна коду на ServiceNow

1. Перейдіть до навігатора фільтрів і знайдіть Сценарій включає в себе.

   Виберіть Включення сценарію в розділі Системний інтерфейс користувача.

2. Відфільтруйте Ім'я та виконайте пошук за запитом propUtils.

3. Змініть метод UserGetSysId у Сценарії.

   Курент:

   UserGetSysId: function () { var opened_for; var user = new GlideRecord("sys_user"); user.addQuery(this.getParameter('field'),this.getParameter('value')); user.query(); if (user.next()) opened_for=user.sys_id; var grInt = new GlideRecord('interaction'); grInt.initialize(); grInt.assigned_to= gs.getUserID(); grInt.type= 'phone'; grInt.opened_for= opened_for; var sysid=grInt.insert(); повернути sysid; },

   Новий зразок коду для інциденту:

   UserGetSysId: function () { var opened_for; //Зміни пов'язані з інцидентами var sysidlist = {}; var user = new GlideRecordSecure("sys_user"); user.addQuery(this.getParameter('field'),this.getParameter('value')); user.query(); if(user.next()) { opened_for=user.sys_id;//return user.sys_id; var inc = new GlideRecordSecure('incident'); inc.addQuery('caller_id', opened_for); inc.addQuery('state', 'IN','1,2'); inc.orderByDesc('sys_created_on'); inc.query(); if (inc.next()) { sysidlist.incsysid=inc.getUniqueValue(); }else{ inc.initialize(); inc.caller_id=opened_for; inc.contact_type='телефон'; inc.short_description='дзвінок отримано від '+ this.getParameter('value'); sysidlist.incsysid=inc.insert(); } } var grInt = новий GlideRecordSecure('взаємодія'); grInt.initialize(); grInt.assigned_to= gs.getUserID(); grInt.type= 'телефон'; grInt.opened_for= opened_for; var sysid=grInt.insert(); sysidlist.sysid=sysid; повертає JSON.stringify(sysidlist); },

1. Перейдіть до навігатора фільтрів і знайдіть сторінку інтерфейсу користувача.

   Виберіть сторінки інтерфейсу користувача в розділі Системний інтерфейс.

2. Відфільтруйте Ім'я та виконайте пошук за запитом Робочий стіл агента.

3. Змініть Скрінпоп у скрипті клієнта.

   Поточна функція:

   screen pop function screenpop(callerani,callSessionInfo) { if(callerani===callSessionInfo.phoneNumber){ callerani=stripPrefixes(callerani); } var gaout = new GlideAjax('propUtils'); gaout.addParam('sysparm_name', 'UserGetSysId'); gaout.addParam('field', 'phone'); gaout.addParam('value', callerani); gaout.getXMLWait(); var sysid = gaout.getAnswer(); openFrameAPI.openServiceNowForm({ entity: 'interaction', query: 'sys_id='+sysid });

   Приблизний код для інциденту:

   screen pop function screenpop(callerani,callSessionInfo) { if(callerani===callSessionInfo.phoneNumber){ callerani=stripPrefixes(callerani); } var gaout = new GlideAjax('propUtils'); gaout.addParam('sysparm_name', 'UserGetSysId'); gaout.addParam('field', 'phone'); gaout.addParam('value', callerani); gaout.getXMLWait(); // Для змін, пов'язаних з інцидентом, var sysObj = JSON.parse(gaout.getAnswer()); if(sysObj.incsysid){ openFrameAPI.openServiceNowForm({ entity: 'incident', query: 'sys_ id='+sysObj.incsysid, 'interaction_sys_id': sysObj.sysid }); }else{ openFrameAPI.openServiceNowForm({ entity: 'incident', query: 'sys_id=-1', 'interaction_sys_id': sysObj.sysid //'a2ba62fd121106446cc96f699b6b8' }); } }

Якщо інформація про абонента існує в CRM, а з цим контактом вже відкрито новий інцидент, додаток відкриває інцидент незавершеного виконання

Якщо інформації про абонента в CRM немає, додаток відкриває новий інцидент

Якщо інформація про абонента існує в CRM, додаток відкриває новий інцидент із заздалегідь заповненими даними

Огляд

У цьому випадку використання детально описано процес додавання додаткового стовпця до таблиці ServiceNow - webexcc_imp_activity та створення sn_openframe_phone_log після встановлення Webex CC для ServiceNow CRM Connector.

За замовчуванням таблиця містить певні готові системні поля та значення.

Ви можете створювати більше змінних для конкретного бізнесу (CAD Variables) у конструкторі WebexCC Flow і додавати змінні CAD у журнал активності після дзвінків ServiceNow, а також зберігати їх у даних таблиці активності після дзвінка.

Додавання стовпця до активності WebexCC IMP

1. Відредагуйте таблицю у версії для розробників ServiceNow.

   

2. Перейдіть до навігатора фільтрів і знайдіть студію.

   

   Виберіть Webex Contact Center

   

   або

   

   

   

3. Натисніть кнопку Активність WebexCC у IMP стіл

   

4. Додайте новий стовпець, наприклад, Ім'я клієнта

   

   

Додати стовпець до журналу телефону

1. Відредагуйте таблицю журналу телефону.

   

   

2. Додайте новий стовпець, наприклад, Ім'я клієнта.

   

   

Карта трансформації активності WebexCC

Додайте новий стовпець, наприклад, Ім'я клієнта картографування полів.

Персоналізація стовпців списку

Як рекомендує Service Now, змініть дію «Вибір» з «створити» на «ігнорувати».

Налаштування списку журналів телефонних дзвінків

Перейти до включення сценарію

Дивись рядок: webexcc.u_customername=actInfo.CustomerName; з підтримуючим коментарем.

var propUtils = Class.create(); propUtils.prototype = Об'єкт.extendsObject(глобальний. AbstractAjaxProcessor,{ getWebexccProp: function () { var webexccprop = {}; webexccprop.instanceurl= 'https://'+gs.getProperty('instance_name')+'.service-now.com/'; webexccprop.url=gs.getProperty('x_caci_webexcc.agentdesktop_url'); // webexccprop.popupurl=gs.getProperty('x_caci_webexcc.screenpop_url'); return JSON.stringify(webexccprop); }, UserGetSysId: function () { var opened_for; var user = new GlideRecord("sys_user); user.addQuery(this.getParameter('field'),this.getParameter('value')); user.query(); if (user.next()) opened_for=user.sys_id;//return user.sys_id; else // повернути null; var grInt = new GlideRecord('interaction'); grInt.initialize(); grInt.assigned_to= gs.getUserID(); grInt.type= 'телефон'; grInt.opened_for= opened_for; var sysid=grInt.insert(); зворотний сисид; }, setWebexcctable: function () { var sys_id=0; var actInfo = JSON.parse(this.getParameter('actInfo')); var webexcc = new GlideRecordSecure(gs.getProperty('x_caci_webexcc.webexccactivitytable')); webexcc.addQuery("callobject", actInfo.CallObject); webexcc.query(); if(!webexcc.next()) { webexcc.ani = actInfo.ani; webexcc.dnis =actInfo.dnis; webexcc.queuename =actInfo.queuename; webexcc.wrapuptime; webexcc.callduration =actInfo.CallDurationInSeconds; webexcc.ringingtime =actInfo.ringingtime; webexcc.activitydate =actInfo.ActivityDate; webexcc.callobject =actInfo.CallObject; webexcc.calltype =actInfo.CallType; webexcc.calldisposition=actInfo.CallDisposition; Цей рядок додано - щоб зафіксувати його в Журналі активності webexcc.u_customername=actInfo.CustomerName; sys_id=webexcc.insert(); Діяльність з обліку інцидентів; var actInfoString =this.getParameter('actInfo'); var suser = new GlideRecordSecure("sys_user"); suser.addQuery("phone", this.getParameter('ani')); suser.query(); if(suser.next()) { var inc = new GlideRecordSecure('incident'); inc.addQuery('caller_id', suser.sys_id); inc.orderByDesc('sys_created_on'); inc.query(); if (inc.next()) { var jsonPretty = JSON.stringify(JSON.parse(actInfoString),null,2); inc.comments =jsonPretty; inc.update(); } } } повернути sys_id; }, тип: 'propUtils' });

Створення змінної CAD у Flow designer

Додавання змінної CAD до макета робочого столу

Приклад

"CadName1:SnowField1,CadName2:SnowField2" CadName1 - це CustomerName, SnowField1 також використовується як CustomerName, що є частиною зразка scirpt, показаного вище "actInfo.CustomerName".

Демо скріншоти

Перегляньте нещодавно додану змінну CAD у таблиці активності WebexCC.

Створення змінної CAD для Flow Designer

Вплив інциденту

Оновлення сценарію Service Now

Оновлення сценарію включають

1. Перейдіть до навігатора фільтрів і знайдіть скрипт включення

   Виберіть опцію «Сценарій включає» в розділі «Системний інтерфейс ».

   

2. Відфільтруйте ім'я за допомогою propUtils.

   

3. Змініть метод UserGetSysId у полі Сценарій .

   

   Поточний сценарій:

   UserGetSysId: function () { var opened_for; var user = new GlideRecord("sys_user"); user.addQuery(this.getParameter('field'),this.getParameter('value')); user.query(); if (user.next()) opened_for=user.sys_id; var grInt = new GlideRecord('interaction'); grInt.initialize(); grInt.assigned_to= gs.getUserID(); grInt.type= 'phone'; grInt.opened_for= opened_for; var sysid=grInt.insert(); повернути sysid; },

   Новий зразок коду для інциденту:

   UserGetSysId: function () { var opened_for; var sysidlist = {}; var user = new GlideRecordSecure("sys_user"); user.addQuery(this.getParameter('field'),this.getParameter('value')); user.query(); if(user.next()) { opened_for=user.sys_id;//return user.sys_id; var inc = new GlideRecordSecure('incident'); inc.addQuery('caller_id', opened_for); inc.addQuery('state','IN','1,2'); inc.orderByDesc('sys_created_on); inc.query(); if (inc.next()) { sysidlist.incsysid=inc.getUniqueValue(); } else{ inc.initialize(); inc.caller_id=opened_for; inc.contact_type='phone'; inc.urgency=this.getParameter('IncUrgency'); inc.impact=this.getParameter('Вплив'); inc.short_description='Виклик отримано від '+ this.getParameter('value'); sysidlist.incsysid=inc.insert(); } } var grInt = новий GlideRecordSecure('взаємодія'); grInt.initialize(); grInt.assigned_to= gs.getUserID(); grInt.type= 'телефон'; grInt.opened_for= opened_for; var sysid=grInt.insert(); sysidlist.sysid=sysid; повернути JSON.stringify(sysidlist);//sysid; },

1. Перейдіть до навігатора фільтрів і знайдіть сторінки інтерфейсу користувача.

   Виберіть параметр Сторінки інтерфейсу користувача в розділі Інтерфейс користувача системи.

   

2. Відфільтруйте сторінки інтерфейсу користувача за допомогою назви та знайдіть agentdesktop.

   

3. Змінити скрінпоп функцію в полі сценарію.

   

   Поточна функція:

   // функція появи екрана screenpop(callerani,callSessionInfo) { if(callerani===callSessionInfo.phoneNumber){ callerani=stripPrefixes(callerani); } var gaout = new GlideAjax('propUtils'); gaout.addParam('sysparm_name', 'UserGetSysId'); gaout.addParam('поле', 'телефон'); gaout.addParam('value', callerani); gaout.getXMLWait(); var sysid = gaout.getAnswer(); openFrameAPI.openServiceNowForm({ entity: 'interaction', query: 'sys_id='+sysid }); }

   Зразок коду інциденту:

   // функція появи екрану screenpop(callerani,callSessionInfo) { var Impact=3; if(callSessionInfo.callAssociatedData.Impact != null && callSessionInfo.callAssociatedData.Impact != undefined) { Impact=callSessionInfo.callAssociatedData.Impact.value; } var IncUrgency=3; if(callSessionInfo.callAssociatedData.Urgency != null && callSessionInfo.callAssociatedData.Urgency != undefined) { IncUrgency=callSessionInfo.callAssociatedData.Urgency.value; } if(callerani===callSessionInfo.phoneNumber){ callerani=stripPrefixes(callerani); } var gaout = new GlideAjax('propUtils'); gaout.addParam('sysparm_name', 'UserGetSysId'); gaout.addParam('поле', 'телефон'); gaout.addParam('value', callerani); gaout.addParam('IncUrgency', IncUrgency); gaout.addParam('Вплив', Вплив); gaout.getXMLWait(); // var sysid = gaout.getAnswer(); var sysObj = JSON.parse(gaout.getAnswer()); if(sysObj.incsysid){ openFrameAPI.openServiceNowForm({ entity: 'incident', query: 'sys_id='+sysObj.incsysid, 'interaction_sys_id': sysObj.sysid }); }else{ openFrameAPI.openServiceNowForm({ entity: 'інцидент', запит: 'sys_id=-1', 'interaction_sys_id': sysObj.sysid }); } window.localStorage.setItem("screenpopinteraction",JSON.stringify(sysObj)); }

Якщо інформація про абонента існує в CRM і немає нового інциденту або інциденту, що триває, програма відкриває новий інцидент

Змініть код на ServiceNow

Додайте нові стовпці до WebexCC IMP Діяльність стіл

Натисніть Оновити.

Додайте нові стовпці до Телефонний журнал стіл

Відкрийте Телефонний журнал стіл

Карта перетворення активності WebexCC

ВІДЧИНЕНО трансформувати карту з навігатора фільтрів

Натисніть на WebexCC Activity TransformMap

Натисніть Update (Оновити).

Включає зміни до сценарію

1. Перейдіть до навігатора фільтрів і знайдіть «скрипт включає».

   Виберіть Script Includes у розділі System UI.

   

2. Відфільтрувати Ім'я за допомогою propUtils.

   

3. Змініть метод setWebexcctable.

   

   Новий зразок коду для інциденту:

   setWebexcctable: функція () { var sys_id=0; var actInfo = JSON.parse(this.getParameter('actInfo')); var webexcc = new GlideRecordSecure(gs.getProperty('webexccactivitytable')); webexcc.addQuery("u_callobject", actInfo.CallObject); webexcc.query(); if(!webexcc.next()) { //Дії щодо запису інцидентів; //var actInfoString =this.getParameter('actInfo'); var incsysid=actInfo.incident_sys_id; var взаємодіїsysid=actInfo.interaction_sys_id; var incnum=""; var intenum=""; видалити actInfo['interaction_sys_id']; видалити actInfo['incident_sys_id']; if(interactionsysid!= null && interakcijsysid != undefined){ var inte = new GlideRecordSecure('interaction'); //inte.get('sys_id', взаємодіїsysid); inte.addQuery('sys_id', взаємодіїsysid); inte.query(); if (inte.next()) { intenum=inte.number; // inte.setValue('state','Closed Complete'); inte.work_notes='Оновити стан до закритого.'; inte.update(); } } if( incsysid!= null && incsysid != undefined){ var inci = new GlideRecordSecure('incident'); inci.addQuery('sys_id', incsysid); inci.query(); if (inci.next()) { incnum=inci.number; var jsonPretty = JSON.stringify(actInfo,null,2); //JSON.stringify(JSON.parse(actInfoString),null,2); inci.comments =jsonPretty; inci.update(); } }else{ var suser = new GlideRecordSecure("sys_user"); suser.addQuery("телефон", this.getParameter('ani')); suser.query(); if(suser.next()) { var inc = new GlideRecordSecure('incident'); inc.addQuery('caller_id', suser.sys_id); inc.addQuery('state','IN','1,2'); inc.orderByDesc('sys_created_on'); inc.query(); if (inc.next()) { var jsonPretty = JSON.stringify(actInfo,null,2); inc.comments =jsonPretty; inc.update(); } } } webexcc.u_ani = actInfo.ani; webexcc.u_dnis =actInfo.dnis; webexcc.u_queuename =actInfo.queuename; webexcc.u_wrapuptime =actInfo.wrapuptime; webexcc.u_callduration =actInfo.CallDurationInSeconds; webexcc.u_ringingtime =actInfo.ringingtime; webexcc.u_activitydate =actInfo.ActivityDate; webexcc.u_callobject =actInfo.CallObject; webexcc.u_calltype =actInfo.CallType; webexcc.u_calldisposition=actInfo.CallDisposition; webexcc.u_incidentnumber=incnum; webexcc.u_interactionsnumber=intenum; sys_id=webexcc.insert(); } повертає sys_id; },

Зміни методів на сторінках інтерфейсу користувача

1. Перейдіть до навігатора фільтрів і знайдіть Сторінки інтерфейсу користувача

   Виберіть Сторінки інтерфейсу користувача варіант під Інтерфейс системи.

   

2. Фільтрувати сторінки інтерфейсу користувача за допомогою Ім'я і шукати agentdesktop.

   

3. Змінити nowActivities і вікно функцію в сценарії.

   

   Поточна функція:

   function nowActivities(actInfo, ani) { var gaout = new GlideAjax('propUtils'); gaout.addParam('sysparm_name', 'setWebexcctable'); gaout.addParam('actInfo', JSON.stringify(actInfo)); gaout.addParam('ani', stripPrefixes(ani)); gaout.getXML(SetCCsysId); }

   Зразок коду інциденту:

   function nowActivities(actInfo, ani) { var sysObjstr = window.localStorage.getItem("screenpopinteraction"); if(sysObjstr != null && sysObjstr != undefined) { var sysObjjson=JSON.parse(sysObjstr); actInfo.interaction_sys_id=sysObjjson.sysid; actInfo.incident_sys_id=sysObjjson.incsysid; } var gaout = new GlideAjax('propUtils'); gaout.addParam('sysparm_name', 'setWebexcctable'); gaout.addParam('actInfo', JSON.stringify(actInfo)); gaout.addParam('ani', stripPrefixes(ani)); gaout.getXML(SetCCsysId); } функція screenpop(callerani,callSessionInfo) { if(callerani===callSessionInfo.phoneNumber){ callerani=stripPrefixes(callerani); } var gaout = new GlideAjax('propUtils'); gaout.addParam('sysparm_name', 'UserGetSysId'); gaout.addParam('поле', 'телефон'); gaout.addParam('value', callerani); gaout.getXMLWait(); // var sysid = gaout.getAnswer(); var sysObj = JSON.parse(gaout.getAnswer()); if(sysObj.incsysid){ openFrameAPI.openServiceNowForm({ entity: 'incident', query: 'sys_id='+sysObj.incsysid, 'interaction_sys_id': sysObj.sysid }); }else{ openFrameAPI.openServiceNowForm({ entity: 'інцидент', запит: 'sys_id=-1', 'interaction_sys_id': sysObj.sysid }); } window.localStorage.setItem("screenpopinteraction",JSON.stringify(sysObj)); } 

Результати після оновлення

Налаштування № 1. Додайте власні бізнес-правила для випадків використання потоку викликів

Для кожного нового виклику конектора WebexCC CRM у ServiceNow створюйте новий запис про інцидент.

1. Знайдіть бізнес-правила в навігаторі фільтрів

   

2. Натисніть кнопку Створити.

   

   Зразок коду для довідки:

   function customcti() { var url = null; var name = sysparm_caller_name; eid = sysparm_caller_id; var phone = sysparm_caller_phone; var taskID = sysparm_task_id; var fQuery = sysparm_query; if (fQuery == null) fQuery = ''; var view = sysparm_view; if (view == null || view == '') view = "itil"; var userID = null; if (eid != null && eid != '') { userID = UserGetSysId("employee_number",eid); } if (userID == null && name != null && name != '') { userID = UserGetSysId("name", ім'я); } if (userID == null && phone != null && phone != '') { userID = UserGetSysId("phone", phone); } if (userID != null) { if (fQuery.length > 0) fQuery += "ˆ"; fQuery += "caller_id=" + userID; } if (url == null) { url = "incident.do?sys_id=-1"; if (fQuery != null) url += "&sysparm_query=" + fQuery; } відповідь = url; URL-адреса повернення; } function UserGetSysId(поле, значення) { var user = new GlideRecord("sys_user"); user.addQuery(поле, значення); user.query(); if (user.next()) повертає user.sys_id; else повертає null; }

   Приблизна конфігурація бізнес-правила

   

3. Увімкнути функцію виклику клієнта

   

   Обробка даних про інцидент інтеграції комп'ютерної телефонії (CTI) позначається як True.

   

4. Оновіть URL-адресу screenpop за допомогою спеціального правила CTI"cti.do?sysparm_cti_rule=createIncident&sysparm_caller_phone="

   

sysparm_cti_rule =name , де 'name' - це ім'я функції , для якої слід викликати CTI Обробка , а не використання стандартного скрипту.

Визначте функцію в sys_script записі з позначкою client callable .

Якщо вам потрібно вставити, оновити або видалити будь-які GlideRecords у функції, викличте окрему неклієнтську функцію для виконання оновлень.

• https://docs.servicenow.com/en-US/bundle/tokyo-application-development/page/script/business-rules/concept/c_BusinessRules.html

• https://docs.servicenow.com/bundle/tokyo-platform-administration/page/integrate/incident/reference/r_ComputerTelephonyIntegration.html

Налаштування # 2 - Додайте змінну CAD в таблицю активності контакт-центру Webex

У цій статті докладно описано процес додавання додаткового стовпця до таблиці ServiceNow - webexcc_activity, який створюється під час інсталяції Webex CC для ServiceNow CRM Connector.

За замовчуванням таблиця містить готові системні поля та значення.

Потенційно ви можете створювати більше змінних для конкретного бізнесу (змінні CAD) у конструкторі WebexCC Flow і додавати ці змінні CAD у журнал активності після дзвінків ServiceNow, а потім зберігати їх у даних таблиці активності після дзвінка.

1. Відредагуйте таблицю у версії для розробників ServiceNow.

   

2. Перейдіть до контакт-центру Studio >Webex.

   

   

   

3. Виберіть таблицю активності WebexCC.

   

4. Наприклад, CustomerName.

   

   

5. Виберіть Макет списку для активності WebexCC.

   

Приклад сценарію

Дивіться рядок з:webexcc.u_customername=actInfo.CustomerName; з підтримуючим коментарем.

var propUtils2 = Class.create(); propUtils2.prototype = Об'єкт.extendsObject(глобально. AbstractAjaxProcessor,{ getWebexccProp: function () { var webexccprop = {}; webexccprop.instanceurl= 'https://'+gs.getProperty('instance_name')+'.service-now.com/'; webexccprop.url=gs.getProperty('x_caci_webexcc.agentdesktop_url'); webexccprop.popupurl=gs.getProperty('x_caci_webexcc.screenpop_url'); return JSON.stringify(webexccprop); }, setWebexcctable: function () { var sys_id=0; var actInfo = JSON.parse(this.getParameter('actInfo')); var webexcc = new GlideRecordSecure(gs.getProperty('x_caci_ webexcc.webexccactivitytable')); webexcc.addQuery("об'єкт виклику", actInfo.CallObject); webexcc.query(); if(!webexcc.next()) { webexcc.ani = actInfo.ani; webexcc.dnis =actInfo.dnis; webexcc.queuename =actInfo.queuename; webexcc.wrapuptime =actInfo.wrapuptime; webexcc.callduration =actInfo.CallDurationInSeconds; webexcc.ringingtime =actInfo.ringingtime; webexcc.activitydate =actInfo.ActivityDate; webexcc.callobject =actInfo.CallObject; webexcc.calltype =actInfo.CallType; webexcc.calldisposition=actInfo.CallDisposition; // Цей рядок додано - щоб зафіксувати його в Журналі активності webexcc. u_customername=actInfo.CustomerName; sys_id=webexcc.insert(); Діяльність з обліку інцидентів; var actInfoString =this.getParameter('actInfo'); var suser = new GlideRecordSecure("sys_user"); suser.addQuery("phone", this.getParameter('ani')); suser.query(); if(suser.next()) { var inc = new GlideRecordSecure('incident'); inc.addQuery('caller_id', suser.sys_id); inc.orderByDesc('sys_created_on'); inc.query(); if (inc.next()) { var jsonPretty = JSON.stringify(JSON.parse(діючий рядок),null,2); inc.comments =jsonPretty; inc.update(); } } } повернути sys_id; }, тип: 'propUtils2' });

Створення змінної CAD у Flow designer

Додавання змінної CAD до макета робочого столу

Демо скріншоти

Перегляньте нещодавно додану змінну CAD у таблиці активності WebexCC.