Integrácia Webex Contact Center s ServiceNow (verzia 1 - Legacy)
Predpoklady
Minimálna podporovaná veľkosť rozhrania softphone je 500px. Akákoľvek hodnota nižšia ako 500px môže mať za následok problémy so zobrazením alebo funkčnosťou.
Pred integráciou Webex Contact Center s konzolou ServiceNow CRM sa uistite, že máte nasledovné:
-
Prístup do kontaktného centra Webex.
-
Prístup správcu do Control Hub na adrese https://admin.webex.com a do kontaktného centra Webex. Management Portal Adresy URL Management Portal sú špecifické pre váš región.
-
Agent s prístupom na pracovnú plochu. Adresa URL pre pracovnú plochu je špecifická pre váš región.
-
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 tom, ako definovať povolený zoznam, nájdete v článku Nastavenia zabezpečenia pre Webex Contact Center.
-
-
Účet portálu pre vývojárov ServiceNow. Ak si chcete vytvoriť účet, prejdite na portál vývojárov ServiceNow na adrese https://developer.servicenow.com/dev.do a kliknite na položku Registrovať sa a Začať budovať.
-
Prístup k nasledujúcim súborom na adrese 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, Tokya, Washington a Xanadu. Ďalšie informácie nájdete v téme Integrácia kontaktného centra Webex s ServiceNow.
Postupujte podľa jednej z dvoch nižšie uvedených metód:
- V prípade vývojárov odporúčame postupovať podľa pokynov v sprievodcovi inštanciou vývojára.
- Ak vlastníte inštanciu s licenciou podniku, postupujte podľa pokynov pre inštancie s licenciou podniku.
Neodporúčame miešať aplikáciu s licenciou podniku s inštanciami pre vývojárov.
Digitálne kanály, ako je chat a e-mail, nie sú podporované pomocou konektorov CRM. To platí pre všetky integrácie CRM využívajúce tieto konektory. Naplánujte si svoje pracovné postupy nasadenia a zapojenia zákazníkov zodpovedajúcim spôsobom.
Nasledujúce časti popisujú kroky na inštaláciu konektora ServiceNow pre inštancie vývojárov.
| 1 |
Prihláste sa do svojho účtu portálu pre vývojárov ServiceNow a otvorte správcovskú konz olu. |
| 2 |
V oblasti Moja inštancia v ponuke Kon to kliknite na položku Spus tiť budovanie.
|
| 3 |
V inštancii vývojára prejdite z poľa Navigátor filtro v v ľavom hornom rohu okna na položku Plugins.
|
| 4 |
Vyhľadajte doplnok Openframe, ktorý má názov Open frame. Možno budete musieť prechádzať zoznamom.
|
| 5 |
Kliknutím na tlačidlo Inštal ovať nainštalujete doplnok Openframe. |
| 6 |
V dialógovom ok ne Aktivovať doplnok kliknite na položku Aktivovať.
|
| 7 |
Po dokončení aktivácie pluginu kliknite na tlačidlo Zavrieť a znova načítať formulár v dialógovom ok ne Aktivácia doplnku.
|
| 8 |
Ak chcete overiť aktiváciu pluginu, z po ľa Navigátor filtro v v ľavom hornom rohu okna prejdite na OpenFrame. |
| 9 |
Kliknite na polož ku Konfigurácie a uistite sa, že sa doplnok OpenFrame zobrazí v zozn ame OpenFrame Configurations.
|
| 1 |
Názov súboru: WebExcc-ServiceNow-Update-Setv (X) .xml
|
| 2 |
V inštancii ServiceNow prejdite v poli Navigátor filtro v v ľavom hornom rohu okna na položku Súpravy mit.
|
| 3 |
Kliknite na prepojen ie Importovať sadu aktualizácií z XML.
|
| 4 |
Kliknite na položku Vybrať súbor, vyberte súbor XML pre nastavenie aktualizácie systému a potom kliknite na položku Nah rať.
Sada aktualizácií sa zobrazí v zozname načítaných súprav aktualiz ácií a je v stave Nač í tané.
|
| 5 |
V zozn ame načítaných súprav aktualizácií kliknite na položku Aktualizovať názov súboru (odkaz) a otvorte súbor aktualizácií.
|
| 6 |
V pravom hornom rohu okna kliknite na položku Ukážka súpravy aktualizácií a skontrolujte, či nie sú v súprave aktualizácií problémy.
|
| 7 |
Po dokon čení ukážky kliknite na tlačidlo Zavrieť v dialógovom okne Aktualizovať náhľad.
|
| 8 |
Kliknite na polož ku Povoliť sadu aktualiz ácií.
|
| 9 |
Po dokon čení vykon ania súpravy aktualizácií kliknite na tlači dlo Zavrieť v dialógovom okne Zavrieť súpravu aktualizácií.
|
| 1 |
Do poľa Navigátor filtro v v ľavom hornom rohu okna zadajte
|
| 2 |
Na stránke V lastnosti systému zoraďte vlastnosti podľa dátumu aktualizácie. Uistite sa, že sú zobrazené nasledujúce vlastnosti Webex Contact Center:
|
| 3 |
Klik agentdesktop_urlnutím otvoríte stránku Vlastnosti agentdesktop_url systému. |
| 4 |
Do po ľa Hodnota zadajte adresu URL pracovnej plochy Webex Cont act Center podľa oblasti prevádzky.
|
| 5 |
Kliknutím na položku Aktualiz ovať uložíte zmeny. |
| 6 |
(Voliteľné) Ak chcete zmeniť názov tabuľky Aktivity, upravte vlastnosti webexccactivity table podľa potreby. Na stránke V lastnosti systému kliknite na webex ccactivitytable. Zmeňte pole Hodnota podľa potreby.
|
| 7 |
(Voliteľné) Pridajte skupiny používateľov nasledujúcimi spôsobmi:
|
| 1 |
V poli Navigátor filtrov prejdite na položku .
|
| 2 |
Kliknite na polož ku Nov ý.
|
| 3 |
Zadajte nasledujúce vlastnosti adresy URL:
|
| 4 |
Vpravo od poľa URL kliknite na tlačidlo Zam k núť a pridajte
|
| 5 |
(Voliteľné) Vyberte skupinu používateľov/agentov na priradenie konfigurácie.
|
| 6 |
Kliknite na položku Odosla ť. Adresa URL sa zobrazí ako odkaz.
|
| 7 |
Predtým, ako sa pokúsite použiť telefón OpenFrame, uistite sa, že ste nahrali vlastný súbor ServiceNow Desktop Layout JSON do kontaktného centra Webex. Management Portal Ďalšie informácie nájdete v téme Nastav enie rozloženia pracovnej plochy ServiceNow v kontaktnom centre Webex. |
| 1 |
|
| 2 |
Ak je to potrebné, aktualizujte vlastnosti v súbore Rozloženie pracovnej plochy. |
| 3 |
Prejdite do kontaktného centra Webex. Management Portal |
| 4 |
Na Management Portal navigačnom paneli vyberte položky Poskytovanie chy.
|
| 5 |
Kliknite na položku Nové rozloženie a zadajte podrobnosti o rozložení pracovnej plochy. |
| 6 |
Nahrajte súbor ServiceNow Desktop Layout JSON. |
| 7 |
Kliknutím na položku Ulo žiť uložíte konfiguráciu. Pracovnú plochu Webex Contact Center môžete spustiť v konzole ServiceNow. |
| 8 |
V poli Navigátor filtrov prejdite do pracovného priestoru .
|
Nasledujúce časti popisujú kroky na inštaláciu konektora ServiceNow pre licencované podnikové inštancie.
| 1 |
Prihláste sa do svojho účtu portálu pre vývojárov ServiceNow a otvorte správcovskú konz olu. |
| 2 |
V oblasti Moja inštancia v ponuke Kon to kliknite na položku Spus tiť budovanie.
|
| 3 |
V inštancii vývojára prejdite z poľa Navigátor filtro v v ľavom hornom rohu okna na položku Plugins.
|
| 4 |
Vyhľadajte doplnok Openframe, ktorý má názov Open frame. Možno budete musieť prechádzať zoznamom.
|
| 5 |
Kliknutím na tlačidlo Inštal ovať nainštalujete doplnok Openframe. |
| 6 |
V dialógovom ok ne Aktivovať doplnok kliknite na položku Aktivovať.
|
| 7 |
Po dokončení aktivácie pluginu kliknite na tlačidlo Zavrieť a znova načítať formulár v dialógovom ok ne Aktivácia doplnku.
|
| 8 |
Ak chcete overiť aktiváciu pluginu, z po ľa Navigátor filtro v v ľavom hornom rohu okna prejdite na OpenFrame. |
| 9 |
Kliknite na polož ku Konfigurácie a uistite sa, že sa doplnok OpenFrame zobrazí v zozn ame OpenFrame Configurations.
|
Inštancie, ktoré majú podnikové licencie, môžu nainštalovať aplikáciu Webex Contact Center priamo z obchodu ServiceNow Store.
|
|
| 1 |
Do poľa Navigátor filtro v v ľavom hornom rohu okna zadajte
|
| 2 |
Na stránke V lastnosti systému zoraďte vlastnosti podľa dátumu aktualizácie. Uistite sa, že sú zobrazené nasledujúce vlastnosti Webex Contact Center:
|
| 3 |
Klik agentdesktop_urlnutím otvoríte stránku Vlastnosti agentdesktop_url systému. |
| 4 |
Do po ľa Hodnota zadajte adresu URL pracovnej plochy Webex Cont act Center podľa oblasti prevádzky.
|
| 5 |
Kliknutím na položku Aktualiz ovať uložíte zmeny. |
| 6 |
(Voliteľné) Ak chcete zmeniť názov tabuľky Aktivity, upravte vlastnosti x_caci_webexcc.webexccactiv itytable podľa potreby.
|
| 7 |
(Voliteľné) Pridajte skupiny používateľov nasledujúcimi spôsobmi:
|
| 1 |
V poli Navigátor filtrov prejdite na položku .
|
| 2 |
Kliknite na polož ku Nov ý.
|
| 3 |
Zadajte nasledujúce vlastnosti adresy URL:
|
| 4 |
Vpravo od poľa URL kliknite na tlačidlo Zam k núť a pridajte
|
| 5 |
(Voliteľné) Vyberte skupinu používateľov/agentov na priradenie konfigurácie.
|
| 6 |
Kliknite na položku Odosla ť. Adresa URL sa zobrazí ako odkaz.
|
| 7 |
V poli Navigátor filtrov prejdite do pracovného priestoru .
|
| 8 |
(Voliteľné) V zozname Skupina použív ateľov presuňte skupiny používateľov, ktoré majú prístup k pracovnej ploche Webex Contact Center, z Dostup né na Vybrané. |
| 9 |
Predtým, ako sa pokúsite použiť telefón OpenFrame, uistite sa, že ste nahrali vlastný súbor ServiceNow Desktop Layout JSON do kontaktného centra Webex. Management Portal Ďalšie informácie nájdete v téme Nastav enie rozloženia pracovnej plochy ServiceNow v kontaktnom centre Webex. |
| 1 |
|
| 2 |
Ak je to potrebné, aktualizujte vlastnosti v súbore Rozloženie pracovnej plochy. |
| 3 |
Prejdite do kontaktného centra Webex. Management Portal |
| 4 |
Na Management Portal navigačnom paneli vyberte položky Poskytovanie chy.
|
| 5 |
Kliknite na položku Nové rozloženie a zadajte podrobnosti o rozložení pracovnej plochy. |
| 6 |
Nahrajte súbor ServiceNow Desktop Layout JSON. |
| 7 |
Kliknutím na položku Ulo žiť uložíte konfiguráciu. Pracovnú plochu Webex Contact Center môžete spustiť v konzole ServiceNow. |
| 8 |
V poli Navigátor filtrov prejdite do pracovného priestoru .
|
| 1 |
V poli Navigátor filtro vať prejdite na Incidenty > Otvoriť 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 oddelené čiarkou
Teraz môžete začať používať Webex Contact Center Desktop v konzole ServiceNow. |
| 4 |
V poli Navigátor filtrov prejdite do pracovného priestoru .
|
- Podporujeme prihlásenie Agent Desktop iba pomocou konektorov WebRTC pre Salesforce (SFDC) a Microsoft Dynamics (MS Dynamics).
- V súčasnosti je táto funkcia použiteľná iba pre agentov.
Agent Desktopv konzole ServiceNow
Pred uskutočnením vonkajších hovorov sa uistite, že vykonáte nasledujúce kroky:
-
Vytvorte vonkajší vstupný bod a nastavte stratégiu vonkajšieho vstupného bodu.
-
Povoľte outdial ANI pre profil agenta.
-
Nastavte príručku ANI na mapovanie číselného čísla k vstupnému bodu.
Ďalšie informácie nájdete v kapitole Posky tovanie príručky pre Cisco Webex Contact Centernastavenie a správu.
V poli Navigátor filtrov prejdite do pracovného priestoru .
Informácie o používaní pracovnej plochy nájdete na karte Agent v pomocníkovi Webex Contact Center.
Prehľad
Tento článok sa zaoberá niekoľkými spôsobmi, ako prispôsobiť vaše obchodné pravidlá pre konektor ServiceNow CRM. Podrobne uvádza, ako môžete prispôsobiť prípady použitia na základe obchodných pravidiel, ktoré sú špecifické pre ServiceNow.
Zákazník musí tieto prípady použitia na ServiceNow spravovať sám. Konfigurácia je špecifická pre ServiceNow a nie softvér Webex Contact Center alebo odborné znalosti.
Toto je referenčná dokumentácia na pomoc pri úprave obchodných pravidiel. Vývojári ServiceNow budú vytvárať a spravovať obchodné pravidlá a poskytovať 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.
Povoliť sadu aktualizácií pre miniaplikáciu Akcie
Pre licencované podnikové inštancie nainštalujte najnovšiu aplikáciu Webex Contact Center z obchodu Service Now.
Ak chcete nastaviť miniaplikáciu Akcie pre inštancie vývojára, stiahnite si najnovší súbor XML Set System Update, ktorý je k dispozícii v repo 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 odovzdať množinu aktualizácií pre miniaplikáciu Akcie, pozrite si kroky 2 až 9 v časti Povoliť množinu aktualizácií.
Povoliť miniaplikáciu Akcie
Použite vlastnosť isWidgetDisplayEnabled na povolenie widgetu Akcie. Hodnotu tejto vlastnosti nesmiete upravovať v bezhlavovej sekcii vlastného rozloženia pracovnej plochy. Vlastnosť je vždy nastavená na false v sekcii bez hlavy vlastného rozloženia pracovnej plochy. Hodnotu vlastnosti by ste mali aktualizovať iba v časti panelu 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 aktivít — kliknite na polož ku Zobraziť alebo upraviť záznam aktivity a zobraz te zoznam záznamov aktivít priradených k volajúcemu.
- Priradenie objektov CRM — kliknite na položku Priradiť k záznamom aktivít a pridajte do zá znamu aktivity objekty CRM, ako je typ hovoru (prichádzajúci alebo odchádzajúci), objekt hovoru, poznámky o hovoroch atď.
- Správa udalostí — kliknite na položku Vytvoriť incident. Vytvorí sa nový incident s vopred vyplnenými podrobnosťami volajúceho. Môžete vykonať požadované aktualizácie incidentu. Na základe vašich požiadaviek si môžete zvoliť úpravu typu záznamu od incidentu k prípadu, HR modulu atď. Ak chcete zmeniť typ záznamu, upravte hodnotu vlastnosti TypeOfRecord v konfigurácii miniaplikácie Akcie. Napríklad:
{ "comp": "md-tab-panel", "attributes": { "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 živého hovoru — môžete zachytiť ďalšie informácie o hovore v textovej oblasti a ukončiť hovor. Tieto poznámky pridané ako poznámky o hovoroch môžete vidieť v zázname aktivity.
Zmena kódu na ServiceNow
Skript obsahuje zmeny-
Prejdite na navigátor filtrov a vyhľad
ajte skripty
.V časti Systémov é rozhranie vyberte položku Obsahuje skript.
-
Filtrujte názov a vyhľadajte
PropuTils
. -
Zmeňte metódu
UserGetSySid v skripte
.Aktuálne:
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(); return sysid; },Nový vzorový kód incidentu:
UserGetSysId : function () { var opened_for; //Incident related changes 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.short_description='Call Received From '+ this.getParameter('value'); sysidlist.incsysid=inc.insert(); } } var grInt = new GlideRecordSecure('interaction'); grInt.initialize(); grInt.assigned_to= gs.getUserID(); grInt.type= 'phone'; grInt.opened_for= opened_for; var sysid=grInt.insert(); sysidlist.sysid=sysid; return JSON.stringify(sysidlist); },
-
Prejdite na navigátor filtrov a vyhľadajte
UI page.V časti Syst émové používateľ ské roz hranie vyberte stránky použív ateľského
-
Filtrujte názov a vyhľadajte
agentdesktop
. -
Zmeňte funkciu
screenpop
v skripte klienta.Aktuálna funkcia:
// 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 });Vzorový kód incidentu:
// 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(); // For Incident-related change 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 //'a2ba0ba62fd121106446cc96f699b6b8' }); } }
Ak informácie o volajúcom existujú v CRM a s týmto kontaktom už došlo k novému incidentu, aplikácia otvorí incident nepokroku
Ak informácie o volajúcom neexistujú v CRM, aplikácia otvorí nový incident
Ak informácie o volajúcom existujú v CRM, aplikácia otvorí nový incident s predvyplnenými podrobnosťami
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 Webex CC pre ServiceNow CRM Connector.
V predvolenom nastavení tabuľka obsahuje určité systémové polia a hodnoty mimo rámčeka.
Môžete vytvoriť viac premenných špecifických pre podnikanie (CAD premenné) vo vnútri návrhára toku WebExCC a pridať premenné CAD do denníka aktivít služby ServiceNow po volaní, ako aj to pretrvávať v údajoch tabuľky aktivít po volaní.
Toto je iba referenčná dokumentácia - a ukazuje, ako to urobiť pre vzorovú premennú CAD s názvom Customer Name, ktorá ukladá meno zákazníka vo vnútri IVR a zverejňuje ho do ServiceNow.
Očakáva sa, že vývojári partner+zákaznícka serviceNow nakonfigurujú a spravujú túto konfiguráciu, pretože ide o prispôsobenie existujúcemu konektoru.
Cisco poskytuje iba techniky, ako prispôsobiť a rozšíriť konektor.
Od 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:
Pridanie stĺpca do aktivity WebExCC IMP
-
Upravte tabuľku vo verzii ServiceNow pre vývojárov.

-
Prejdite do navigátora filtra a vyhľadajte štúdio.

Vyberte
Webex Contact Center

alebo



-
Vyberte tabuľ
ku aktivít WebExCC IMP

-
Pridanie nového stĺpca, napríklad
CustomerName


Pridanie stĺpca do denníka telefónu
-
Upravte tabuľku denníka telefónu.


-
Pridajte nový stĺpec, napríklad
CustomerName
.

Mapa transformácie aktivity WebExCC

Pridajte nový stĺpec, napríklad mapovanie po ľa CustomerName
.


Prispôsobte stĺpce zoznamu

Ako odporúča služba Service Now, zmeňte akciu Choice z vytvorenia na ignorovať.


Konfigurácia zoznamu denníkov telefónu

Prejsť na položku Script Include
Pridajte iba jeden riadok webexcc. u_customername=Actinfo
.CustomerName na PropuTils.



Pozri riadok: webexcc. u_customername=ActInfo.Customer Name; 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;
// else
// return 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();
return 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;
// This line is Added - to capture it in the Activity Log
webexcc.u_customername=actInfo.CustomerName;
sys_id=webexcc.insert();
//Activities on Incident record;
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 premennej CAD v návrhári toku

Pridanie premennej CAD do rozloženia pracovnej plochy
Príklad
"CadName1:SnowField1,CadName2:SnowField2"
CadName1 is CustomerName
SnowField1 is also used as CustomerName which is part of sample scirpt showen above "actInfo.CustomerName".

Demo snímky obrazovky
Zobrazte novo pridanú premennú CAD v tabuľke aktivít WebExCC.



Vytvorte premennú CAD pre Flow Designer
Naliehavosť incidentu
Vplyv incidentu

Aktualizácia skriptu Service Now
Aktualizácie skriptu obsahuje
-
Prejdite do navigátora filtra a vyhľadajte
script includesV časti Systémov é používateľské rozhranie vyberte možnosť Obsahuje skript.

-
Filtrovať názov pomocou
propUtils.
-
Zmeňte metódu
UserGetsySid v poli
Skript.
Aktuálny skript:
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(); return sysid; },Nový vzorový kód incidentu:
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('Impact'); inc.short_description='Call Received From '+ this.getParameter('value'); sysidlist.incsysid=inc.insert(); } } var grInt = new GlideRecordSecure('interaction'); grInt.initialize(); grInt.assigned_to= gs.getUserID(); grInt.type= 'phone'; grInt.opened_for= opened_for; var sysid=grInt.insert(); sysidlist.sysid=sysid; return JSON.stringify(sysidlist);//sysid; },
-
Prejdite do navigátora filtra a vyhľadajte
UI pages.V časti Systémov é rozhranie vyberte možnosť Str ánky použív ateľského rozhran ia.

-
Filtrujte stránky používateľského rozhran ia s náz vom a vyhľadajte
agentdesktop.
-
Zmeňte funkciu
screenpop
v poli skriptov.
Aktuálna funkcia:
// 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 }); }Vzorový kód incidentu:
// screen pop 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({ entity: 'incident', query: '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 nedochádza k žiadnemu novému alebo nepokrokovému incidentu, aplikácia otvorí nový incident


Zmeňte kód na ServiceNow
Pridanie nových stĺpcov do tabuľ ky aktivít IMP WebExCC
Otvorte tabuľ ku aktivít WebExCC IMP





Kliknite na Aktualizovať.


Pridanie nových stĺpcov do tabuľ ky Denník telef
ónu
Otvorte tabuľ ku Denník telef
ónu





Mapa transformácie aktivity WebExCC
Otvorte mapu transformácie
z navigátora filtra


Kliknite na WebExCC Activity TransformMap




Kliknite na polož ku Aktualiz ovať.

Zmeny obsahu skriptu
-
Prejdite na navigátor filtrov a vyhľadajte „skript obsahuje“.
V časti Systémov é rozhranie vyberte položku Obsahuje skript.

-
Filtrujte 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()) { //Activities on Incident record; //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']; if( interactionsysid!= 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','Closed Complete'); inte.work_notes='Update State to closed.'; 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("phone", 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(); } return sys_id; },
Zmeny metódy na stránkach používateľského rozhrania
-
Prejdite na navigátor filtrovania a vyhľadajte stránky používateľ
ského rozhrania
V časti Systémov é rozhranie vyberte možnosť Str ánky použív ateľského rozhran ia.

-
Filtrujte stránky používateľského rozhran ia s náz vom a vyhľadajte
agentdesktop.
-
Zmeňte funkciu
nowActivities a screenpop
v skripte.
Aktuálna funkcia:
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); }Vzorový kód incidentu:
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); } 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()); 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 }); } window.localStorage.setItem("screenpopinteraction",JSON.stringify(sysObj)); }
Výsledky po aktualizácii

Nasledujúce prispôsobenia sa vzťahujú na verzie 1.0.5 a nižšie. Pre prispôsobenie 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
Vytvorte nový záznam incidentu pre každý hovorPre každý nový hovor do konektora WebExCC CRM v ServiceNow vytvorte nový záznam incidentu.
Vyhľadávanie obchodných pravidiel v navigátoroch Filter

Kliknite na položku Nový.

Vzorový kód pre referenciu:
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", 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; } answer = url; return url; } function UserGetSysId(field, value) { var user = new GlideRecord("sys_user"); user.addQuery(field, value); user.query(); if (user.next()) return user.sys_id; else return null; }Vzorová konfigurácia obchodného pravidla

Povoliť volateľný klient

Sprac@@ ovanie integrácie počítačovej telefónie (CTI) pre incidenty je označené ako True.


sysparm_cti_rule=name, kde 'name' je názov funkcie, sa má vyvolať pre spracovanie CTI namiesto použitia predvoleného skriptu.
Definujte funkciu v položke označenej sys_scriptako klient volateľný.
Ak musíte vložiť, aktualizovať alebo odstrániť akýkoľvek GlideRecord (y) vo funkcii, na vykonanie aktualizácií zavolajte samostatnú funkciu, ktorú možno volať bez klienta.
Ak chcete skript volať klient, musíte začiarknuť políčko volateľné pre klienta vo formulári, ktorý sa zobrazí pri zobrazení položky. sys_script
Začiarkavacie políčko, ktoré je možné volať klient, sa predvolene nezobrazuje. Ak chcete zobraziť, musíte upraviť polia, ktoré sa zobrazujú vo formulári pomocou ikony ozubeného kolieska a mechanizmu vedra.
Prispôsobenie č. 2 - Pridajte premennú 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, ktorý webexcc_activity sa vytvorí pri inštalácii Webex CC pre ServiceNow CRM Connector.
V predvolenom nastavení tabuľka obsahuje systémové polia a hodnoty mimo rámčeka.
Potenciálne môžete vytvoriť viac premenných špecifických pre podnikanie (CAD premenné) vo vnútri návrhára toku WebExCC a pridať tieto premenné CAD do den níka aktivít služby ServiceNow po volaní a pretrvávať to v údajoch tabuľky aktiv ít po volaní.
-
Toto je iba referenčná dokumentácia - a ukazuje, ako to urobiť pre vzorovú premennú CAD s názvom Customer Name, ktorá ukladá meno zákazníka vo vnútri IVR a zverejňuje ho do ServiceNow.
-
Vývojári partner+zákaznícky ServiceNow nakonfigurujú a spravujú túto konfiguráciu, pretože ide o prispôsobenie existujúcemu konektoru.
-
Spoločnosť Cisco poskytne iba techniky, ako prispôsobiť a rozšíriť konektor.
-
Od 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 verzii ServiceNow pre vývojárov.

Prejdite na stránku .



Vyberte tabu ľku aktivít WebExCC.

Napríklad CustomerName.


Vyberte položku Rozloženie zoznamu pre aktivitu WebExCC.

Tento krok sa nevyžaduje, ak používate súbor aktualizácií XML - na pridanie je potrebné iba jeden riadok "webexcc. u_customername=ActInfo.CustomerName "na PropuTils.



Vzorový skript
Pozrite si riadok s: webexcc. u_customername=ActInfo.Customer Name; 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;
// This line is Added - to capture it in the Activity Log
webexcc.u_customername=actInfo.CustomerName;
sys_id=webexcc.insert();
// Activities on Incident record;
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(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 premennej CAD v návrhári toku
Pridanie premennej CAD do rozloženia pracovnej plochy
Demo snímky obrazovky
Zobrazte novo pridanú premennú CAD v tabuľke aktivít WebExCC.

Konektor CRM funguje na základe verzie widgetu špecifikovanej v rozložení pracovnej plochy JSON. Je mimoriadne dôležité zabezpečiť aktualizáciu verzie widgetu v rozložení pracovnej plochy.
Od správcov sa očakáva, že všetky rozloženia pracovnej plochy pre tento konektor CRM používajú túto verziu widgetu. If the layout is not updated to use the latest version, functionality will no longer be supported and may cease to work correctly.
- Posledná aktualizácia ServiceNow— .1.0_v5.0.3.jsonServiceNow_Desktop_0. Od marca 2024 je verzia balíka 1.0.9
- Posledná aktualizácia XML—WebExcc-ServiceNow-update-setv7-1-actionswidget.xml, jún 2024











































