Integrujte Webex Contact Center so službou ServiceNow (verzia 1 – staršia verzia)
Predpoklady
V súčasnosti sa táto funkcia vzťahuje iba na agentov.
Pred integráciou Webex Contact Center s konzolou ServiceNow CRM sa uistite, že máte nasledovné:
-
Prístup k Webex Contact Center.
-
Správcovský prístup k riadiacemu centru na adrese https://admin.webex.com a k portálu Webex Contact Center Management. Adresy URL portálu správy sú špecifické pre váš región.
-
Agent s prístupom k pracovnej ploche. Adresa URL pracovnej plochy je špecifická pre vašu oblasť.
-
Prístup agenta k nasledujúcej doméne, ktorá je pridaná do zoznamu povolených zásad zabezpečenia obsahu:
-
*.service-now.com
Ďalšie informácie o definovaní zoznamu povolených položiek nájdete v článku Nastavenie zabezpečenia pre Webex Contact Center.
-
-
Účet vývojárskeho portálu ServiceNow. Ak si chcete vytvoriť účet, prejdite na portál pre vývojárov služieb ServiceNow na adrese https://developer.servicenow.com/dev.do a kliknite na položku Zaregistrovať sa a začať stavať.
-
Prístup k nasledujúcim súborom na # https://github.com/CiscoDevNet/webex-contact-center-crm-integrations/tree/main/ServiceNow:
-
Sada aktualizácií ServiceNow (XML)
-
Rozloženie pracovnej plochy kontaktného centra ServiceNow (JSON)
-
- Vydania ServiceNow, ktoré Webex Contact Center podporuje, sú Vancouver, Utah, Tokia, Washington a Xanadu. Ďalšie informácie nájdete v časti Webex Contact Center Integrácia so službou ServiceNow.
Postupujte podľa jedného z dvoch nižšie uvedených postupov:
V prípade inštancií vývojárov odporúčame postupovať podľa krokov v sprievodcovi inštanciou vývojára.
Ak vlastníte inštanciu s podnikovou licenciou, postupujte podľa pokynov pre inštancie s podnikovou licenciou.
Neodporúčame miešať aplikáciu s podnikovou licenciou s inštanciami testovacieho prostredia (sandbox) pre vývojárov.
Nasledujúce časti popisujú kroky na inštaláciu konektora ServiceNow pre inštancie vývojárov.
1 |
Prihláste sa do svojho účtu vývojárskeho portálu ServiceNow a otvorte konzolu na správu . |
2 |
V oblasti Moja inštancia v ponuke Konto kliknite na položku Spustiť budovu. |
3 |
V inštancii vývojára prejdite z poľa Navigátor filtra v ľavej hornej časti okna na položku Doplnky. |
4 |
Vyhľadajte doplnok Openframe, ktorý má názov Openframe. Možno budete musieť prechádzať zoznamom. |
5 |
Kliknutím na tlačidlo Inštalovať nainštalujte doplnok Openframe. |
6 |
V dialógovom okne Aktivovať doplnok kliknite na položku Aktivovať. |
7 |
Po dokončení aktivácie doplnku kliknite na tlačidlo Zavrieť > Znovu načítať formulár v dialógovom okne Aktivácia doplnku. |
8 |
Ak chcete overiť aktiváciu pluginu, z poľa Filter navigátora v ľavej hornej časti okna prejdite na OpenFrame. |
9 |
Kliknite na položku Configurations (Konfigurácie ) a uistite sa, že sa doplnok OpenFrame zobrazuje v zozname Konfigurácie formátu OpenFrame. |
1 |
Stiahnite si najnovší súbor System Update Set XML, ktorý je k dispozícii na úložisku Github na tomto mieste : https://github.com/CiscoDevNet/webex-contact-center-crm-integrations/tree/main/ServiceNow. Názov súboru: webexcc-servicenow-update-setV(X).XML |
2 |
V inštancii služby ServiceNow prejdite z poľa Navigátor filtra v ľavej hornej časti okna na . |
3 |
Kliknite na prepojenie Importovať aktualizáciu z XML . |
4 |
Kliknite na položku Vybrať súbor, vyberte súbor XML System Update Set a potom kliknite na položku Nahrať.
Množina aktualizácií sa zobrazí v zozname Načítané súbory aktualizácií a je v stave Načítané .
|
5 |
V zozname Načítané aktualizačné množiny kliknite na názov súboru Aktualizovať množinu (prepojenie), čím otvoríte aktualizáciu množiny. |
6 |
V pravom hornom rohu okna kliknite na položku Ukážka súboru aktualizácií a skontrolujte, či sa v množine aktualizácií vyskytujú problémy. |
7 |
Po dokončení ukážky kliknite na tlačidlo Zavrieť v dialógovom okne Aktualizovať nastavenie ukážky. |
8 |
Kliknite na položku Commit Update Set. |
9 |
Kliknite na tlačidlo Zavrieť v dialógovom okne Aktualizovať potvrdenie, keď sa dokončí potvrdzovanie aktualizácie množiny. |
1 |
Do poľa Filter navigátor v ľavej hornej časti okna zadajte |
2 |
Na stránke Vlastnosti systému zoraďte vlastnosti podľa aktualizovaného dátumu. Uistite sa, že vidíte nasledujúce vlastnosti Webex Contact Center: |
3 |
Kliknutím na agentdesktop_url otvorte stránku agentdesktop_url vlastností systému. |
4 |
Do poľa Hodnota zadajte URL adresu pracovnej plochy Webex Contact Center podľa oblasti činnosti.
|
5 |
Kliknutím na tlačidlo Aktualizovať uložte zmeny. |
6 |
(Voliteľné) Ak chcete zmeniť názov tabuľky Aktivita, upravte vlastnosti tabuľky webexccactivitytable podľa potreby. Na stránke Vlastnosti systému kliknite na položku webexccactivitytable. Podľa potreby zmeňte pole Hodnota . |
7 |
(Voliteľné) Skupiny používateľov pridajte nasledujúcimi spôsobmi:
|
1 |
Z poľa Navigátor filtra prejdite na položku OpenFrame |
2 |
Kliknite na položku Nové. |
3 |
Zadajte nasledujúce vlastnosti URL adresy:
|
4 |
Napravo od poľa URL adresy kliknite na tlačidlo Zamknúť a pridajte |
5 |
(Voliteľné) Vyberte skupiny používateľov / agentov pre priradenie konfigurácie. |
6 |
Kliknite na tlačidlo Odoslať. Adresa URL sa zobrazí ako prepojenie. |
7 |
Pred pokusom o použitie telefónu OpenFrame sa uistite, že ste nahrali vlastný súbor JSON rozloženia pracovnej plochy služby ServiceNow na portál Webex Contact Center Management. Ďalšie informácie nájdete v časti Nastavenie rozloženia pracovnej plochy služby ServiceNow na Webex Contact Center. |
1 |
Rozloženie Pracovná plocha pre službu ServiceNow si môžete stiahnuť z https://github.com/CiscoDevNet/webex-contact-center-crm-integrations/tree/main/ServiceNow. |
2 |
V prípade potreby aktualizujte vlastnosti v súbore Rozloženie pracovnej plochy. |
3 |
Prejdite na portál Webex Contact Center Management. |
4 |
Na navigačnom paneli portálu správy vyberte položku pracovnej plochy. |
5 |
Kliknite na položku Nové rozloženie a zadajte podrobnosti rozloženia pracovnej plochy. |
6 |
Nahrajte súbor JSON rozloženia pracovnej plochy služby ServiceNow. |
7 |
Kliknutím na tlačidlo Uložiť uložte konfiguráciu. Teraz môžete spustiť Webex Contact Center Desktop v konzole ServiceNow. |
8 |
Z poľa Navigátor filtra prejdite na Service Operations. |
Nasledujúce časti popisujú kroky na inštaláciu konektora ServiceNow pre licencované podnikové inštancie.
1 |
Prihláste sa do svojho účtu vývojárskeho portálu ServiceNow a otvorte konzolu na správu . |
2 |
V oblasti Moja inštancia v ponuke Konto kliknite na položku Spustiť budovu. |
3 |
V inštancii vývojára prejdite z poľa Navigátor filtra v ľavej hornej časti okna na položku Doplnky. |
4 |
Vyhľadajte doplnok Openframe, ktorý má názov Openframe. Možno budete musieť prechádzať zoznamom. |
5 |
Kliknutím na tlačidlo Inštalovať nainštalujte doplnok Openframe. |
6 |
V dialógovom okne Aktivovať doplnok kliknite na položku Aktivovať. |
7 |
Po dokončení aktivácie doplnku kliknite na tlačidlo Zavrieť > Znovu načítať formulár v dialógovom okne Aktivácia doplnku. |
8 |
Ak chcete overiť aktiváciu pluginu, z poľa Filter navigátora v ľavej hornej časti okna prejdite na OpenFrame. |
9 |
Kliknite na položku Configurations (Konfigurácie ) a uistite sa, že sa doplnok OpenFrame zobrazuje v zozname Konfigurácie formátu OpenFrame. |
Inštancie, ktoré majú podnikové licencie, môžu nainštalovať aplikáciu Webex Contact Center priamo z obchodu ServiceNow Store.
Prevezmite a nainštalujte balík Webex Contact Center z obchodu ServiceNow: https://store.servicenow.com/sn_appstore_store.do#!/store/application/6c8e2a4edbc73410e1c75e25ca961947. |
1 |
Do poľa Navigátor filtra v ľavej hornej časti okna zadajte sys_properties.list |
2 |
Na stránke Vlastnosti systému zoraďte vlastnosti podľa aktualizovaného dátumu. Uistite sa, že vidíte nasledujúce vlastnosti Webex Contact Center: |
3 |
Kliknutím na agentdesktop_url otvorte stránku agentdesktop_url vlastností systému. |
4 |
Do poľa Hodnota zadajte URL adresu pracovnej plochy Webex Contact Center podľa oblasti činnosti.
|
5 |
Kliknutím na tlačidlo Aktualizovať uložte zmeny. |
6 |
(Voliteľné) Ak chcete zmeniť názov tabuľky aktivít, podľa potreby upravte vlastnosti tabuľky x_caci_webexcc.webexccactivitytable .
|
7 |
(Voliteľné) Skupiny používateľov pridajte nasledujúcimi spôsobmi:
|
1 |
Z poľa Navigátor filtra prejdite na položku OpenFrame |
2 |
Kliknite na položku Nové. |
3 |
Zadajte nasledujúce vlastnosti URL adresy:
|
4 |
Napravo od poľa URL adresy kliknite na tlačidlo uzamknutia a pridajte |
5 |
(Voliteľné) Vyberte skupiny používateľov / agentov pre priradenie konfigurácie. |
6 |
Kliknite na tlačidlo Odoslať. Adresa URL sa zobrazí ako prepojenie. |
7 |
Z poľa Navigátor filtra prejdite na Service Operations. |
8 |
(Voliteľné) V zozname Skupina používateľov presuňte skupiny používateľov, ktorí majú prístup k pracovnej ploche Webex Contact Center, z možnosti Dostupné na Vybraté. |
9 |
Pred pokusom o použitie telefónu OpenFrame nezabudnite nahrať vlastný súbor JSON rozloženia pracovnej plochy služby ServiceNow na portál Webex Contact Center Management Portal. Ďalšie informácie nájdete v časti Nastavenie rozloženia pracovnej plochy služby ServiceNow na Webex Contact Center. |
1 |
Stiahnite si rozloženie pracovnej plochy pre službu ServiceNow z https://github.com/CiscoDevNet/webex-contact-center-crm-integrations/tree/main/ServiceNow. |
2 |
V prípade potreby aktualizujte vlastnosti v súbore Rozloženie pracovnej plochy. |
3 |
Prejdite na portál Webex Contact Center Management. |
4 |
Na navigačnom paneli portálu správy vyberte položku pracovnej plochy. |
5 |
Kliknite na položku Nové rozloženie a zadajte podrobnosti rozloženia pracovnej plochy. |
6 |
Nahrajte súbor JSON rozloženia pracovnej plochy služby ServiceNow. |
7 |
Kliknutím na tlačidlo Uložiť uložte konfiguráciu. Teraz môžete spustiť Webex Contact Center Desktop v konzole ServiceNow. |
8 |
Z poľa Navigátor filtra prejdite na Service Operations. |
1 |
Z navigačného poľa Filter prejdite na položku Incidenty > Otvorený incident. |
2 |
Kliknite pravým tlačidlom myši na pole volajúceho a kliknite na položku Konfigurovať slovník. |
3 |
Pridajte atribúty Teraz môžete začať používať pracovnú plochu Webex Contact Center v konzole ServiceNow. |
4 |
Z poľa Navigátor filtra prejdite na Service Operations. |
Podporujeme prihlásenie do Agent Desktop pomocou WebRTC iba pre konektory Salesforce (SFDC) a Microsoft Dynamics (MS Dynamics).
Agent Desktop v konzole služby ServiceNow
Pred uskutočnením odchádzajúcich hovorov vykonajte nasledujúce kroky:
-
Vytvorte vstupný bod výstupu a nastavte stratégiu vstupného bodu odchádzajúceho.
-
Povoľte vytáčanie ANI pre profil agenta.
-
Nastavte vytáčanie ANI na mapovanie vytáčania čísla k vstupnému bodu.
Ďalšie informácie nájdete v kapitole Provisioning v príručke Cisco Webex Contact Center Setup and Administration Guide.
Z poľa Navigátor filtra prejdite na Service Operations.
Informácie o používaní pracovnej plochy nájdete v časti Agent Tab v pomocníkovi Webex Contact Center.
Prehľad
Tento článok popisuje niekoľko spôsobov, ako prispôsobiť obchodné pravidlá pre konektor CRM služby ServiceNow. Podrobne popisuje, ako môžete prispôsobiť prípady použitia na základe obchodných pravidiel, ktoré sú špecifické pre službu ServiceNow.
Zákazník musí tieto prípady použitia v službe ServiceNow spravovať sám. Konfigurácia je špecifická pre službu ServiceNow a nie pre Webex Contact Center softvér alebo odborné znalosti.
Ide o referenčnú dokumentáciu, ktorá má pomôcť pri zmene obchodných pravidiel. Vývojári služby ServiceNow vytvoria a spravujú obchodné pravidlá a poskytnú podporu.
Cisco poskytuje iba vzorovú dokumentáciu.
Nasledujúce časti poskytujú podrobnosti o tom, ako nastaviť, povoliť a spravovať miniaplikáciu Akcie pre vývojárov a podnikové inštancie.
Potvrdiť miniaplikáciu Aktualizácia nastavená pre akcie
V prípade licencovaných podnikových inštancií nainštalujte najnovšiu aplikáciu Webex Contact Center z obchodu ServiceNow.
Ak chcete nastaviť miniaplikáciu Akcie pre inštancie vývojárov, stiahnite si najnovší súbor System Update Set XML, ktorý je k dispozícii na úložisku Github na tomto mieste: https://github.com/CiscoDevNet/webex-contact-center-crm-integrations/tree/main/ServiceNow/ActionsWidget. Názov súboru je webexcc-servicenow-update-setv7-1-ActionsWidget.XML. Ak chcete vyhovieť množine aktualizácií pre miniaplikáciu Akcie, pozrite si kroky 2 až 9 v časti Potvrdenie množiny aktualizácií.
Widget Povoliť akcie
Pomocou vlastnosti isWidgetDisplayEnabled povoľte miniaplikáciu Akcie. Hodnotu tejto vlastnosti nesmiete upravovať v bezhlavej časti vlastného rozloženia pracovnej plochy. Vlastnosť je vždy nastavená na hodnotu false v bezhlavej časti vlastného rozloženia pracovnej plochy. Hodnotu vlastnosti by ste mali aktualizovať iba v časti panel vlastného rozloženia pracovnej plochy.
Po povolení miniaplikácie Akcie vo vlastnom rozložení pracovnej plochy môžete vykonať nasledujúce akcie:
- Správa záznamov o aktivite – kliknutím na položku Zobraziť/upraviť záznam aktivity zobrazíte zoznam záznamov aktivity priradených k volajúcemu.
- Priradiť objekty CRM - Kliknutím na položku Priradiť k záznamom aktivity pridajte do záznamu aktivity objekty CRM, ako je napríklad typ hovoru (prichádzajúci alebo odchádzajúci), objekt hovoru, poznámky hovoru atď.
- Správa incidentov – kliknite na Vytvoriť incident. Vytvorí sa nový incident s vopred vyplnenými podrobnosťami volajúceho. Môžete vykonať požadované aktualizácie incidentu. Môžete sa rozhodnúť upraviť typ záznamu z incidentu na prípad, HR modul atď. na základe vašich požiadaviek. Ak chcete zmeniť typ záznamu, upravte hodnotu vlastnosti typeOfRecord v konfigurácii miniaplikácie Akcie. Príklad:
{ "comp": "md-tab-panel", "atribúty": { "slot": "panel", "class": "widget-pane" }, "children": [ { "comp": "agentx-custom-desktop", "script": "https://cx-crmconnector.ciscoccservice.com/servicenow/v5/dist/index.js", "properties": { "isWidgetDisplayEnabled": true, "typeOfRecord": "Create Incident" }, "wrapper": { "title": "SNOW Actions!", "maximizeAreaName": "app-maximize-area" } } ] }
- Pridanie poznámok k živému hovoru – v textovej oblasti môžete zaznamenať ďalšie informácie o hovore a hovor zakončiť. Tieto poznámky môžete vidieť pridané ako poznámky k hovoru v zázname aktivity.
Zmena kódu na ServiceNow
Skript Obsahuje zmeny-
Prejdite do navigátora filtrov a vyhľadajte
Skript obsahuje
.V časti Používateľské rozhranie systému vyberte možnosť Skript obsahuje .
-
Filtrujte Názov a vyhľadajte
propUtils
. -
Zmeňte metódu
UserGetSysId
V skripte .Aktuálne:
UserGetSysId: funkcia () { 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(); return sysid; },
Nový vzorový kód pre incident:
UserGetSysId: function () { var opened_for; //Zmeny súvisiace s incidentom 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='telefón'; inc.short_description='Hovor prijatý z '+ this.getParameter('hodnota'); sysidlist.incsysid=inc.Insert(); } } var grInt = new GlideRecordSecure('interakcia'); grInt.initialize(); grInt.assigned_to= gs.getUserID(); grInt.type= 'telefón'; grInt.opened_for= opened_for; var sysid=grInt.Insert(); sysidlist.sysid=sysid; return JSON.stringify(sysidlist); },
-
Prejdite do navigátora filtrov a vyhľadajte
stránku používateľského rozhrania
.Vyberte Stránky používateľského rozhrania v časti Používateľské rozhranie systému.
-
Filtrujte Názov a vyhľadajte
agentdesktop
. -
Zmeňte
Zobrazenie obrazovky
Funkcia v klientskom skripte .Aktuálna funkcia:
// zobrazenie obrazovky 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 });
Ukážkový kód pre incident:
// zobrazenie obrazovky 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(); // Pre zmenu súvisiacu s incidentom 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({ entita: 'incident', dotaz: 'sys_id=-1', 'interaction_sys_id': sysObj.sysid //'a2ba0ba62fd121106446cc96f699b6b8' }); } }
Ak informácie o volajúcom existujú v CRM a s týmto kontaktom je už otvorený nový incident, aplikácia otvorí prebiehajúci incident.
Ak informácie o volajúcom v CRM neexistujú, aplikácia otvorí nový incident.
Ak informácie o volajúcom existujú v CRM, aplikácia otvorí nový incident s predvyplnenými údajmi.
Prehľad
Tento prípad použitia podrobne popisuje proces pridania ďalšieho stĺpca do tabuľky ServiceNow – webexcc_imp_activity a vytvorenia sn_openframe_phone_log po inštalácii CC Webex pre ServiceNow CRM Connector.
Tabuľka štandardne obsahuje určité systémové polia a hodnoty.
V návrhárovi WebexCC Flow môžete vytvoriť ďalšie premenné špecifické pre dané podnikanie (premenné CAD) a pridať premenné CAD do protokolu aktivity volaní ServiceNow POST, ako aj uložiť ich do údajov tabuľky aktivity volaní POST.
Toto je len referenčná dokumentácia – a ukazuje, ako to urobiť pre vzorovú CAD premennú s názvom Názov zákazníka, ktorá ukladá meno zákazníka do IVR a odosiela ho do ServiceNow.
Očakáva sa, že vývojári ServiceNow pre partnerov a zákazníkov budú túto konfiguráciu konfigurovať a spravovať, pretože ide o prispôsobenie existujúceho konektora.
Cisco poskytuje iba techniky, ako prispôsobiť a rozšíriť konektor.
V čase písania tohto článku tím Cisco overil podporu pre pridanie premennej CAD do denníka aktivít a tabuľky aktivít pomocou techniky opísanej nižšie:
Pridať stĺpec do aktivity WebexCC IMP
-
Upravte tabuľku vo vývojárskej verzii ServiceNow.
-
Prejdite do navigátora filtrov a vyhľadajte štúdio.
Vybrať
Webex Contact Center
alebo
-
Vyberte
Aktivita IMP WebexCC
stôl -
Pridajte nový stĺpec, napríklad
Názov zákazníka
Pridať stĺpec do telefonického denníka
-
Upravte tabuľku so záznamami telefonátov.
-
Pridajte nový stĺpec, napríklad
Názov zákazníka
.
Mapa transformácie aktivít WebexCC
Pridajte nový stĺpec, napríklad Názov zákazníka
Mapovanie terénu.
Prispôsobiť stĺpce zoznamu
Ako odporúča Service Now, zmeňte akciu Choice z create (vytvoriť) na ignore (ignorovať).
Konfigurácia zoznamu telefonických záznamov
Prejsť na Zahrnutie skriptu
Pridajte iba jeden riadok webexcc.u_customername=actInfo.NázovZákazníka
Do propUtils.
Pozrite si riadok: webexcc.u_customername=actInfo.CustomerName; s podporným komentárom.
var propUtils = Class.create(); propUtils.prototype = Object.extendsObject(global.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; // inak // vráti null; var grInt = new GlideRecord('interaction'); grInt.initialize(); grInt.assigned_to= gs.getUserID(); grInt.type= 'phone'; grInt.opened_for= opened_for; var sysid=grInt.Insert(); vrátiť sysid; }, 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 =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; // Tento riadok je pridaný - pre jeho zaznamenanie v denníku aktivít webexcc.u_customername=actInfo.CustomerName; sys_id=webexcc.Insert(); //Aktivit v zázname incidentu; 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(); } } } return sys_id; }, type: 'propUtils' });
Vytvorenie CAD premennej v nástroji Flow Designer
Pridajte premennú CAD do rozloženia na pracovnej ploche
Príklad
„CadName1:SnowField1,CadName2:SnowField2“ CadName1 je CustomerName. SnowField1 sa tiež používa ako CustomerName, čo je súčasťou vzorového skriptu zobrazeného vyššie „actInfo.CustomerName“.
Snímky obrazovky z ukážky
Pozrite si novo pridanú premennú CAD v tabuľke Aktivita WebexCC.
Vytvorenie CAD premennej pre Flow Designer
Naliehavosť incidentuDopad incidentu
Aktualizácia skriptu Service Now
Aktualizácie skriptu zahŕňajú
-
Prejdite do navigátora filtrov a vyhľadajte
skript obsahuje
Vyberte Skript obsahuje možnosť pod Používateľské rozhranie systému.
-
Filtrovať Meno s
propUtils
. -
Zmeňte metódu
UserGetSysId
v Skript pole.Aktuálny skript:
UserGetSysId: funkcia () { 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(); return sysid; },
Nový vzorový kód pre incident:
UserGetSysId: funkcia () { 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='telefón'; inc.urgency=this.getParameter('Naliehavosť'); inc.impact=this.getParameter('Dopad'); inc.short_description='Hovor prijatý z '+ this.getParameter('hodnota'); sysidlist.incsysid=inc.Insert(); } } var grInt = new GlideRecordSecure('interakcia'); grInt.initialize(); grInt.assigned_to= gs.getUserID(); grInt.type= 'telefón'; grInt.opened_for=opened_for; var sysid=grInt.Insert(); sysidlist.sysid=sysid; return JSON.stringify(sysidlist);//sysid; },
-
Prejdite do navigátora filtrov a vyhľadajte
Stránky používateľského rozhrania
.Vyberte Stránky používateľského rozhrania možnosť pod Používateľské rozhranie systému.
-
Filtrovať Stránky používateľského rozhrania s Meno a hľadať
desktop agenta
. -
Zmeňte
Zobrazenie obrazovky
Funkciu v poli skriptu.Aktuálna funkcia:
// zobrazenie obrazovky 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 }); }
Ukážkový kód pre incident:
// zobrazenie obrazovky function 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('field', 'phone'); gaout.addParam('value', callerani); gaout.addParam('IncUrgency', IncUrgency); gaout.addParam('Impact', Impact); 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({ entita: 'incident', dotaz: 'sys_id=-1', 'interaction_sys_id': sysObj.sysid }); } window.localStorage.setItem("screenpopinteraction",JSON.stringify(sysObj)); }
Ak informácie o volajúcom existujú v CRM a neexistuje žiadny nový alebo prebiehajúci incident, aplikácia otvorí nový incident.
Zmeňte kód na ServiceNow
Pridajte nové stĺpce do Aktivita IMP WebexCC
stôl
Otvorte Aktivita IMP WebexCCstôl
Kliknite na Aktualizovať.
Pridajte nové stĺpce do Záznam telefónu
stôl
Otvorte Záznam telefónu
stôl
Mapa transformácie aktivít WebexCC
Otvoriť Transformačná mapa
Z navigátora filtrov
Kliknite na TransformMap aktivít WebexCC
Kliknite na položku Aktualizovať.
Zmeny v skripte zahŕňajú
-
Prejdite do navigátora filtrov a vyhľadajte „skript obsahuje“.
V časti Používateľské rozhranie systému vyberte možnosť Skript obsahuje .
-
Filtrovať Názov pomocou
propUtils
. -
Zmeňte metódu
setWebexcctable
.Nový vzorový kód pre Incident:
setWebexcctable: function () { 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()) { //Aktivit v zázname o incidente; //var actInfoString =this.getParameter('actInfo'); var incsysid=actInfo.incident_sys_id; var interactionsysid=actInfo.interaction_sys_id; var incnum=""; var intenum=""; delete actInfo['interaction_sys_id']; delete actInfo['incident_sys_id']; ak (interactionsid!= null && interactionsysid != undefined) { var inte = new GlideRecordSecure('interaction'); //inte.get('sys_id', interactionsysid ); inte.addQuery('sys_id', interactionsysid ); inte.query(); if (inte.next()) { intenum=inte.number; // inte.setValue('state','Uzavreté Dokončené'); inte.work_notes='Aktualizovať stav na zatvorené.'; 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("telefón", 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(); } vrátiť sys_id; },
Zmeny metód na stránkach používateľského rozhrania
-
Prejdite do navigátora filtrov a vyhľadajte
Stránky používateľského rozhrania
Vyberte Stránky používateľského rozhrania možnosť pod Používateľské rozhranie systému.
-
Filtrovať stránky používateľského rozhrania pomocou Meno a hľadať
desktop agenta
. -
Zmeňte
terazAktivity a kontextové okno
Funkcia v skripte.Aktuálna funkcia:
funkcia 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); }
Ukážkový kód pre incident:
funkcia 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); } 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(); var sysObj = JSON.parse(gaout.getAnswer()); ak(sysObj.incsysid){ openFrameAPI.openServiceNowForm({ entita: 'incident', dotaz: 'sys_id='+sysObj.incsysid, 'interaction_sys_id': sysObj.sysid }); }else{ openFrameAPI.openServiceNowForm({ entita: 'incident', dotaz: 'sys_id=-1', 'interaction_sys_id': sysObj.sysid }); } window.localStorage.setItem("screenpopinteraction",JSON.stringify(sysObj)); }
Výsledky po aktualizácii
Nasledujúce úpravy platia pre verzie 1.0.5 a staršie. Pre prispôsobenia pre novšie verzie 1.0.7 a vyššie postupujte podľa vyššie uvedených krokov.
Prispôsobenie č. 1 – Pridanie vlastných obchodných pravidiel pre prípady použitia toku hovorov
Vytvoriť nový záznam incidentu pre každý hovorPre každé nové volanie do konektora WebexCC CRM v ServiceNow vytvorte nový záznam incidentu.
Vyhľadajte obchodné pravidlá v navigátore filtrov
Kliknite na položku Nové.
Ukážkový kód pre referenciu:
funkcia 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("číslo_zamestnanca", eid); } if (userID == null && meno != null && meno != '') { userID = UserGetSysId("meno", meno); } ak (ID používateľa == null && telefón != null && telefón != '') { ID používateľa = UserGetSysId("telefón", telefón); } ak (ID používateľa != null) { ak (fQuery.length > 0) fQuery += "^"; fQuery += "caller_id=" + ID používateľa; } ak (url == null) { url = "incident.do?sys_id=-1"; ak (fQuery != null) url += "&sysparm_query=" + fQuery; } odpoveď = url; vrátiť url; } funkcia UserGetSysId(pole, hodnota) { var používateľ = new GlideRecord("sys_user"); používateľ.addQuery(pole, hodnota); používateľ.query(); ak (používateľ.next()) vrátiť používateľ.sys_id; inak vrátiť null; }
Ukážka konfigurácie obchodného pravidla
Povoliť volanie klienta
Spracovanie incidentu integrácie počítačovej telefónie (CTI) je označené ako True .
Aktualizujte URL adresu kontextového okna pomocou vlastného pravidla CTI „ cti.do?sysparm_cti_rule=createIncident&sysparm_caller_phone=“
Parameter *sysparm_cti_rule=name*, kde ' name*, je názov funkcie*, ktorá sa má vyvolať pre spracovanie CTI*, namiesto použitia predvoleného skriptu.
Funkciu definujte v položke sys_script označenej ako volateľná klientom.
Ak musíte Insert aktualizovať alebo odstrániť akékoľvek záznamy GlideRecords vo funkcii, zavolajte samostatnú volateľnú funkciu, ktorá nie je klientom a vykoná aktualizácie.
Ak chcete, aby bol skript volateľný klientom, musíte začiarknuť políčko „volateľné klientom“ vo formulári, ktorý sa zobrazí pri zobrazení položky sys_script.
Začiarkavacie políčko volateľné klientom sa predvolene nezobrazuje. Pre zobrazenie musíte upraviť polia, ktoré sa zobrazujú vo formulári, pomocou ikony ozubeného kolieska a mechanizmu vedra.
Prispôsobenie č. 2 – Pridanie premennej CAD do tabuľky aktivít Webex Contact Center
PrehľadTento článok podrobne popisuje proces pridania ďalšieho stĺpca do tabuľky ServiceNow – webexcc_activity, ktorý sa vytvorí pri inštalácii CC Webex pre ServiceNow CRM Connector.
Tabuľka štandardne obsahuje systémové polia a hodnoty pripravené na použitie.
V návrhárovi WebexCC Flow môžete potenciálne vytvoriť viac premenných špecifických pre dané podnikanie (premenné CAD) a pridať tieto premenné CAD do denníka aktivít volaní ServiceNow POST a uložiť ich do údajov tabuľky aktivít volaní POST .
-
Toto je len referenčná dokumentácia – a ukazuje, ako to urobiť pre vzorovú CAD premennú s názvom Názov zákazníka, ktorá ukladá meno zákazníka do IVR a odosiela ho do ServiceNow.
-
Vývojári služby ServiceNow pre partnerov a zákazníkov budú túto konfiguráciu konfigurovať a spravovať, pretože ide o prispôsobenie existujúceho konektora.
-
Cisco poskytne iba techniky, ako prispôsobiť a rozšíriť konektor.
-
V čase vydania tohto článku tím Cisco overil podporu pre pridanie premennej CAD do denníka aktivít a tabuľky aktivít pomocou techniky opísanej nižšie.
Upravte tabuľku vo vývojárskej verzii ServiceNow.
Prejdite do
.Vyberte tabuľku Aktivita WebexCC .
Napríklad Meno zákazníka.
Vyberte Rozloženie zoznamu pre Aktivitu WebexCC.
Tento krok nie je potrebný, ak používate aktualizačnú sadu XML – do súboru propUtils je potrebné pridať iba jeden riadok „webexcc.u_customername=actInfo.CustomerName“.

Ukážkový skript
Pozrite si riadok s:webexcc.u_customername=actInfo.CustomerName; s podporným komentárom.
var propUtils2 = Class.create(); propUtils2.prototype = Object.extendsObject(global.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("callobject", 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; // Tento riadok je pridaný - pre jeho zaznamenanie v denníku aktivít webexcc.u_customername=actInfo.CustomerName; sys_id=webexcc.Insert(); // Aktivity v zázname incidentu; var actInfoString =this.getParameter('actInfo'); var suser = new GlideRecordSecure("sys_user"); suser.addQuery("telefón", 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(acting string),null,2); inc.comments =jsonPretty; inc.update(); } } } return sys_id; }, type: 'propUtils2' });
Upravte stránku používateľského rozhrania s novým názvom skriptu
Vytvorenie CAD premennej v nástroji Flow Designer
Pridajte premennú CAD do rozloženia na pracovnej ploche
Snímky obrazovky z ukážky
Pozrite si novo pridanú premennú CAD v tabuľke Aktivita WebexCC.
