Die Contact Center AI Platform (CCAI Platform) bietet eine Integration in ServiceNow CRM.
ServiceNow-Entwicklereinstellungen
Bevorzugte Mindestanforderungen an die ServiceNow-Version: Tokyo patch 1
Nutzer für die Basisauthentifizierung einrichten
Wahrscheinlich ist für das ServiceNow-Administratorkonto die Bestätigung in zwei Schritten aktiviert und mit diesem Nutzer verknüpft. Daher kann es nicht verwendet werden, um Administratorzugriff in der CCAI Platform zu erhalten. Dazu müssen Sie ein Nutzerkonto in ServiceNow erstellen.
Erstellen Sie einen einfachen Nutzer mit Anmeldedaten:
Gehen Sie zu User > New (Nutzer > Neu).
Geben Sie die Details ein und wählen Sie „Nur Webdienstzugriff“ aus.
Notieren Sie sich die Nutzer-ID und das Passwort.
Erforderliche Rollen in ServiceNow
Standardrollen in ServiceNow sind vorkonfiguriert, um bestimmte Zugriffsrechte und Berechtigungen innerhalb der Plattform zu gewähren. Administratoren können Rollen erstellen und konfigurieren, die bestimmte Berechtigungen gewähren. Diese Berechtigungen legen fest, was Nutzer und Gruppen mit dieser Rolle tun können.
Für diese Integration benötigen Sie die folgenden Rollen in ServiceNow:
user_admin: Diese Rolle ist für Administratoren gedacht, die Nutzer, Gruppen, Standorte und Unternehmen in der ServiceNow-Instanz verwalten müssen.
sn_incident_read: Diese Rolle bietet Lesezugriff auf die Incident Management-Anwendung und die zugehörigen Funktionen. Nutzende können damit Vorfallaufzeichnungen ansehen.
sn_incident_write: Diese Rolle gewährt Schreibzugriff auf die Incident Management-Anwendung und die zugehörigen Funktionen, sodass Nutzer Vorfallseinträge erstellen und ändern können.
personalize_dictionary: Mit dieser Rolle können Wörterbucheinträge und Labels an bestimmte Geschäftsanforderungen angepasst werden.
function_field_admin: Diese Rolle ist für Nutzer gedacht, die Funktionsfelder speziell im Berichtsdesigner erstellen, bearbeiten und ansehen müssen. Sie bietet keine Möglichkeit, Funktionsfelder aus der Plattformliste oder dem Formular zu erstellen oder zu löschen.
Instanzansichten konfigurieren
In den folgenden Abschnitten werden die Konfigurationsänderungen beschrieben, die für Instanzansichten erforderlich sind.
Optional: Favoriten hinzufügen
Favoriten sind eine schnelle Möglichkeit, die am häufigsten verwendeten Links in der ServiceNow-Instanz zu finden. Wenn Sie einen Favoriten hinzufügen möchten, wählen Sie das Sternsymbol neben einem Feld im Navigator-Bereich aus. Wenn Sie den Navigatorbereich später so filtern möchten, dass nur Ihre Favoriten angezeigt werden, können Sie das Sternsymbol direkt unter dem Feld „Filter“ im Navigatorbereich auswählen.
Beispiele für nützliche Favoriten:
Vorfälle: Verknüpfungen mit Datensätzen für benutzerdefiniertes CRM.
Nutzer: Verknüpfungen mit Konten für benutzerdefiniertes CRM.
REST API Explorer: Eine gute Möglichkeit, die API zu testen.
Benutzerdefinierte Felder manuell hinzufügen
Wählen Sie in der Objektansicht, die Sie ändern möchten, oben links das Symbol zum Maximieren (3 horizontale Linien) aus. Sie können dies in der Self-Service-Ansicht oder der Standardansicht tun.
Wählen Sie im Menü Konfigurieren > Formulardesign aus, um den Formulardesigner zu öffnen.
Wählen Sie in der linken Spalte den Tab Feldtypen aus.
Ziehen Sie den Typ des benutzerdefinierten Felds, den Sie hinzufügen möchten.
Nachdem Sie den Feldtyp in den gewünschten Bereich gezogen haben, wählen Sie das Zahnradsymbol aus, um die Einstellungen aufzurufen.
Ändern Sie im Fenster das Label und notieren Sie sich den Namen. Der Name wird in den CCAI Platform-Anwendungseinstellungen verwendet.
Wählen Sie rechts oben auf dem Bildschirm Speichern aus.
Sitzungsdaten dem CRM zuordnen
Sie müssen die entsprechenden Sitzungsdaten aus CCAIP mit Dialogflow zuordnen und die folgenden Parameter verwenden:
Daten des virtuellen Agenten
{
"ujet": {
"session_variable": {
"capture_target": "payload",
"payload": {
"value_one": "$session.params.payload_value_one"
};
"capture_type": [ "comment", "field" ] // optional, default of ["comment"]
}
}
}
Metadaten
https://INSTANCE.service-now.com/api/now/table/sys_dictionary?sysparm_query=name%3Dsys_user https://INSTANCE.service-now.com/api/now/table/sys_dictionary?sysparm_query=name%3Dincident
Label: column_label
API-Schlüssel: element
Benutzerdefinierte Felder befinden sich auf derselben Ebene wie die Standardfelder in der Antwort von sys_user oder incident.
Datei von der CCAI Platform in das CRM hochladen
https://INSTANCE_URL.service-now.com/api/now/attachment/upload
Methode: POST
Format der Anfragedaten: property
Speicherort der Antwortdaten: data.result
Typ: Multi-part form
Anhangstyp: Attachment Url
Anhang-URL: download_link
Parameter: table below
Beispielanfrage:
{
file: FILE_DATA,
table_name: incident,
table_sys_id: RECORD_ID
}
Agentenadapter (benutzerdefinierte Formulare) einbinden
In den folgenden Schritten wird beschrieben, wie Sie Agent-Adapter und die Click-to-Call-Funktion in der ServiceNow-Instanz aktivieren.
OpenFrame installieren und konfigurieren
Gehen Sie zu Alle > Systemanwendungen > Alle verfügbaren Anwendungen > Alle.
Suchen Sie nach „OpenFrame“.
Installieren Sie OpenFrame.
Rufen Sie nach der Installation All > OpenFrame > Configurations auf.
Konfiguration mit einer URL erstellen. Wenn Sie mehrere Konfigurationen in einer ServiceNow-Instanz haben, hat Ihr Nutzer möglicherweise keinen Zugriff auf eine neu erstellte Konfiguration. Prüfen Sie Ihre Gruppen und die Liste der OpenFrame-Konfigurationsreihenfolgen, um festzustellen, welche Konfiguration Ihr Nutzer verwendet.
Gib
sys_properties.listin die Suche ein.glide.ui.concourse.onmessage_enforce_same_origin_whitelistbearbeitenFügen Sie die neue URL der Liste der Werte hinzu.
sn_openframe.cross.origin.accessbearbeitenFügen Sie
autoplayzur Liste der Werte hinzu.
Next-UI-Erfahrung für Nutzer aktivieren
Geben Sie
sys_properties.listin die Navigationsleiste ein und drücken Sie die Eingabetaste.Legen Sie die Systemeigenschaft
glide.ui.polaris.experienceauf true fest.Legen Sie die Nutzereinstellung
glide.ui.polaris.usefür das System auf false fest.Legen Sie die Nutzereinstellung
glide.ui.polaris.usefür einen Nutzer auf true fest. (Sie können eine Zeile für Nutzereinstellungen erstellen.)
Systemeigenschaften aktualisieren
Geben Sie
sys_properties.listin die Navigationsleiste ein und drücken Sie die Eingabetaste.glide.ui.concourse.onmessage_enforce_same_origin_whitelistbearbeitenFügen Sie die URL der Werteliste hinzu. Mehrere Werte müssen durch Kommas getrennt werden.
sn_openframe.cross.origin.accessbearbeitenFügen Sie der Werteliste „autoplay“ hinzu.
glide.ui.polaris.experiencebearbeitenÄndern Sie den Wert in false, da einige Funktionen nicht funktionieren, wenn sie aktiviert sind.
Click-to-Call-Funktion oben im Formular hinzufügen
Rufen Sie System-UI > UI-Aktionen auf.
Wählen Sie Neue Aktion erstellen aus.
Wählen Sie im Formular die Tabelle aus, zu der diese Click-to-Call-Funktion gehören soll.

Verwenden Sie für Formulare mit einem Verweis auf einen Kontakt oder Nutzer die
g_form.getReferenceAPI, um auf die Telefonnummer des Nutzers zuzugreifen. Bei benutzerdefinierten Tabellen können die Referenz-ID und die resultierenden Attribute abweichen. Die Kommunikation mit der CCAI Platform ist dieselbe, daher müssen die Nutzlast und die Datenstruktur mit den folgenden identisch sein:function clickToDial() { var user = g_form.getReference('caller_id',function(res) { var phone = res.phone || res.mobile_phone; var payload = {"name": "clicktodial", "number": phone}; var data = {"payload": payload, "method": "openframe_communication" }; CustomEvent.fireAll("openframe_request", data); }); }Verwenden Sie für Formulare mit einer Nummer im Formular, die angerufen werden soll, die
g_form.getValueAPI, um die relevanten Werte abzurufen. Dies ist ein Beispiel für die UI-Aktion für die Tabelle „Users“. Bei benutzerdefinierten Tabellen können die Namen der Formularfelder abweichen. Die Kommunikation mit der CCAI Platform ist dieselbe, daher müssen die Nutzlast und die Datenstruktur mit den folgenden identisch sein:function clickToDial() { var phone = g_form.getValue('phone') || g_form.getValue('mobile_phone'); var payload = {"name": "clicktodial", "number": phone}; var context = {"payload": payload, "method" : "openframe_communication" }; CustomEvent.fireAll("openframe_request", context); }
Click-to-Call neben Referenzen hinzufügen
Die Anrufschaltfläche neben Verweisen auf Kontakte muss im Formular bearbeitet werden. Rechtsklicken Sie auf das Feld und rufen Sie Configure Dictionary (Wörterbuch konfigurieren) auf. Fügen Sie für Attribute entweder den Wert
show_phoneodershow_phone_customer_servicezum Wertref_contributionshinzu.Bearbeiten Sie in „UI Macros“ (UI-Makros)
show_phoneundshow_phone_customer_service.Ersetzen Sie Folgendes:
Zurück:
var task = {"entity": p.attr('data-task-table'), "query" :"sys_id="+p.attr('data-task-id')+"$[AMP]sysparm_view="+p.attr('data-task-view'),"value":p.attr('data-task-value'),"label":p.attr('data-task-label')};
var company = {"entity": p.attr('data-company-table'),"query":"sys_id="+p.attr('data-company-id')+"$[AMP]sysparm_view="+p.attr('data-task-view'),"value":p.attr('data-company-value'),"label":p.attr('data-company-label')};
var caller = {"entity": p.attr('data-caller-table'),"query": "sys_id="+p.attr('data-caller-id')+"$[AMP]sysparm_view="+p.attr('data-task-view'),"value":p.attr('data-caller-value'),"label":p.attr('data-caller-label')};
var callContext = [];
callContext.push(task);
callContext.push(company);
callContext.push(caller);
var metaData = {"phoneNumber":p.attr('data-caller-phone'),"taskId":p.attr('data-task-id')};
var data = {"metaData":metaData , "data": callContext};
var payload = {"type": "OUTGOING_CALL", "data" : data};
var createInteractionData ={};
createInteractionData.interactionSysId = -1;
createInteractionData.direction = 'outbound';
createInteractionData.context_document = p.attr('data-task-id');
createInteractionData.context_table = p.attr('data-task-table');
createInteractionData.account = p.attr('data-company-id');
if(p.attr('data-caller-table') === 'customer_contact')
createInteractionData.contact = p.attr('data-caller-id');
createInteractionData.opened_for = p.attr('data-caller-id');
var ga = new GlideAjax('sn_openframe.OpenFrameAjaxUtility');
ga.addParam('sysparm_name', 'createInteractionWithPropertyCheck');
ga.addParam('context', JSON.stringify(createInteractionData));
ga.getXML(function(serverResponse) {
var result = serverResponse.responseXML.getElementsByTagName("result");
var output = JSON.parse(result[0].getAttribute("data"));
if(output.status == "success"){
var interaction = {"entity": "interaction", "query" :"sys_id="+output.fields.interactionSysId, "value":output.fields.number, "label":"Interaction", "display":false};
payload.data.data.push(interaction);
}
var context = {"payload": payload, "method" : "openframe_communication" };
jslog("context with interaction : "+ JSON.stringify(context));
CustomEvent.fireAll("openframe_request", context);
});
Neu:
var phone = p.attr('data-caller-phone')
var payload = {"name": "clicktodial", "number": phone};
var data = {"payload": payload, "method": "openframe_communication" };
CustomEvent.fireAll("openframe_request", data);
CRM-Einstellungen
In den folgenden Schritten wird beschrieben, wie Sie die API über das CCAI Platform-Portal mit ServiceNow verbinden.
Rufen Sie im CCAI Platform-Portal Einstellungen > Entwicklereinstellungen > CRM auf.
Wählen Sie im Abschnitt „Agent Platform“ die Option ServiceNow aus.
Geben Sie Ihre ServiceNow-Domaininformationen in das Feld ServiceNow-Domain ein. Dies kann je nach Bedarf eine Entwickler- oder Anbieterinstanz sein, steht aber in direktem Zusammenhang mit der Instanz und ist der erste Teil der URL in der Webadresse des ServiceNow-Portals:
https://{your instance}.servicenow.com.Wählen Sie im Feld ServiceNow Cloud Selection (ServiceNow-Cloud-Auswahl) die Option
Incidentfür einen einfachen Tickettyp aus. Wenn SieCustomauswählen, werden zusätzliche Optionen angezeigt. Vorfälle sind Erweiterungen der Aufgabentabelle. Benutzerdefinierte Objekte sollten Erweiterungen von Vorfällen sein.Geben Sie in den Feldern Authentifizierungsdaten Ihren Nutzernamen und Ihr Passwort ein.
Wenn Sie
Incidentfür den Feldtyp „Cloud-Auswahl“ ausgewählt haben, werden die folgenden Felder angezeigt:- Lookup account object enthält drei Drop-down-Felder:
Object Type,Phone Number lookup fieldsundPhone number primary field.
- Lookup account object enthält drei Drop-down-Felder:
Wenn Sie
Customfür den Feldtyp „Cloud-Auswahl“ ausgewählt haben, werden die folgenden Felder angezeigt:Lookup-Eintragsobjekt:
Objekttyp des Basisdatensatzes: Wählen Sie entweder den Tabellentyp
taskoderincidentaus.Objekttyp aufzeichnen: Dieses Feld wird mit Daten gefüllt, wenn eine Vorfallstabelle erweitert wurde. Sie können es bei Bedarf auswählen.
Lookup account object enthält drei Drop-down-Felder:
Object Type,Phone Number lookup fieldsundPhone number primary field.
Benutzerdefinierte Nutzer-ID-Felder: Setzen Sie hier ein Häkchen, wenn Sie benutzerdefinierte Suchfelder für Nutzer für Mobile- oder Web-SDK- oder Apps API-Sitzungen (Chat) aktivieren möchten.
Telefonnummernformat: Hier können Sie das Format auswählen, das Sie für die Anzeige von Telefonnummern verwenden möchten.
Sitzungsmetadatendatei: Setzen Sie hier ein Häkchen, um Sitzungsmetadaten an CRM-Datensätze anzuhängen.
Klicken Sie auf Speichern, um Ihre Auswahl zu speichern.
Benutzerdefinierte Felder für Datensätze
Dies sind die benutzerdefinierten Felder, die bereits für die ServiceNow-Instanz im Form Designer erstellt wurden und in der CCAI Platform verwendet werden können. Sie können auch andere benutzerdefinierte Felder erstellen, indem Sie im Menü im Abschnitt „Benutzerdefinierte Felder für Datensätze“ die Option Erstellen auswählen.
| Feld | Typ | Definition |
|---|---|---|
u_ujet_custom_field_after_call_work |
String | Dauer der Anrufnachbereitung |
u_ujet_custom_field_call_duration |
String | Anrufdauer |
u_ujet_custom_field_comm_id |
Ganzzahl | Anruf- oder Chat-ID je nach Kontakttyp |
u_ujet_custom_field_rating |
Ganzzahl | CSAT-Wert |
u_ujet_custom_field_email_via_web |
String | E‑Mail wurde über das Web gesendet |
u_ujet_custom_field_feedback |
String | Feedback |
u_ujet_custom_field_from_phone_number |
String | Telefonnummer des Anrufers |
u_ujet_custom_field_hold_duration |
String | Gesamte Haltedauer |
u_ujet_custom_field_menu_path |
String | Menüauswahl |
u_ujet_custom_field_queue_name |
String | Warteschlangenname |
u_ujet_custom_field_session_type |
String | Sitzungstyp |
u_ujet_custom_field_verification |
Wahr/falsch | Bestätigen, dass die Überprüfung abgeschlossen ist |
u_ujet_custom_field_wait_time |
String | Gesamtwartezeit |
OAuth einrichten
Wenn Sie OAuth konfigurieren möchten, müssen Sie eine OAuth-Anwendung in ServiceNow erstellen. Geben Sie dann unter Entwicklereinstellungen > CRM > Authentifizierungsmethode die Anmeldedaten (OAuth-Client-ID und OAuth-Clientschlüssel) ein.
OAuth-Anwendung in ServiceNow erstellen
Rufen Sie in Ihrem ServiceNow-Konto Alle > System-OAuth > Anwendungsregistrierung auf.
Erstellen Sie eine OAuth-Anwendung und wählen Sie OAuth-API-Endpunkt für externe Clients erstellen aus.
Konfigurieren Sie die folgenden Felder:
Name: Geben Sie einen eindeutigen Namen ein.
Client-ID: Die Client-ID wird automatisch vom ServiceNow-OAuth-Server generiert.
Clientschlüssel: Dies ist der Clientschlüssel für die OAuth-Anwendung. Lassen Sie das Feld leer, um sie automatisch generieren zu lassen.
Lebensdauer des Aktualisierungstokens: Die Zeit in Sekunden, die das Aktualisierungstoken gültig ist.
Lebensdauer des Zugriffstokens: Die Zeit in Sekunden, die das Zugriffstoken gültig ist.
Weiterleitungs-URL: Geben Sie die URL Ihrer Umgebung und das Unterverzeichnis ein. Beispiel:
https://servicenow.yourcompany.co/v1/servicenow/oauth_callbackTokeneinschränkung erzwingen: Beschränkt die Verwendung des Zugriffstokens auf die APIs, die in den REST API-Zugriffsrichtlinien in der ServiceNow-Dokumentation definiert sind. Wenn Sie diese Option deaktivieren, kann das Zugriffstoken auch für andere REST APIs verwendet werden.
Klicken Sie auf Senden.
Kehren Sie nach dem Erstellen der Anwendung zum Eintrag zurück und rufen Sie die Client-ID und den neu erstellten Clientschlüssel ab.
Einstellungen in den Entwicklereinstellungen aktualisieren
Gehen Sie zu Entwicklereinstellungen > CRM.
Achten Sie darauf, dass die Einstellungen wie in den vorherigen Schritten beschrieben eingegeben und konfiguriert sind.
Klicken Sie unter „Authentifizierungsmethode“ auf OAuth.
Geben Sie die OAuth-Client-ID und den OAuth-Clientschlüssel ein. (Siehe Schritt 5 oben.)
Klicken Sie auf Speichern.
Klicken Sie auf Anmeldedaten verknüpfen.
Benutzerdefinierte Feldzuordnung für virtuellen Agenten
Wenn Sie Virtual Agent verwenden, konfigurieren Sie dieses Feld im Bildschirm Benutzerdefinierte Feldzuordnungen. Dadurch können die Virtual Agent-Variablen von der Nutzlast der Virtual Agent-Sitzung an ServiceNow übertragen werden. Variablennamen können ein beliebiger String sein. Die hier aufgeführten Feldlabels sind ein Beispiel.
Konfigurieren Sie auf dem Bildschirm Benutzerdefinierte Feldzuordnungen die Verbindung zwischen den Variablen, die durch die Nutzlastdefinitionen erstellt wurden, die Sie in der ursprünglichen Virtual Agent-Konfiguration verwendet haben, und der relevanten Variable in ServiceNow.
| Titel der Feldzuordnung | CRM-Feldlabel | Benutzerdefiniertes Datenfeldlabel |
|---|---|---|
| Feedback zum virtuellen Kundenservicemitarbeiter | ccaip_custom_field_incident_feedback |
va_feedback |
CRM-Feldzuordnung hinzufügen
Gehen Sie zu Einstellungen > Betriebsverwaltung.
Gehen Sie zum Bereich Zuordnung benutzerdefinierter CRM-Felder und klicken Sie auf Alle ansehen.
Klicken Sie auf den Link + CRM-Feldzuordnung hinzufügen.
Titel der Feldzuordnung: CCAI Platform-Name für diese benutzerdefinierte Feldzuordnung, die im CCAI Platform-Portal verwendet wird.
CRM-Feldlabel: Label des CRM-Felds in Ihrem CRM-System, dem Sie die Daten zuordnen.
Benutzerdefiniertes Datenfeldlabel (benutzerdefinierter Datenschlüssel): Der Name des Schlüssels auf oberster Ebene in der benutzerdefinierten Datennutzlast der CCAI Platform, von der Sie zuordnen möchten (z. B.
devicefür SDK-Nutzlasten oderorderIdfür Apps API-Chat-Nutzlasten). Dieser Schlüssel muss von den CCAI Platform Web- oder Mobile SDKs oder (für Chatinteraktionen) über den Apps API-EndpunktSend custom data in a chatgesendet werden. Der Schlüssel muss genau übereinstimmen (einschließlich Groß-/Kleinschreibung).
Klicken Sie auf Speichern.
Andere Einstellungen konfigurieren
Die anderen Einstellungen, mit denen Sie die CCAI Platform ordnungsgemäß in Ihre ServiceNow-Instanz einbinden können, finden Sie im Drop-down-Menü Einstellungen. Weitere Informationen zum Konfigurieren der einzelnen Abschnitte finden Sie unter den Links in der folgenden Liste.
Testausgaben
Sie können jetzt die Funktionalität Ihrer Anruf- und Chatabläufe prüfen, indem Sie auf die entsprechenden Schaltflächen oben auf dem Bildschirm des CCAI Platform-Portals klicken. Achten Sie darauf, dass der Pop-up-Blocker deaktiviert ist, wenn Sie diesen Test ausführen.
In ServiceNow sollte ein Vorfall erstellt werden, wobei der Anruf- oder Chatkontakt im Abschnitt Aktivitäten des Vorfalls aufgeführt ist. Dies sollte als Arbeitsnotiz und nicht als Vorfallkommentar angezeigt werden, damit diese Backend-Aktivität für Kunden nicht sichtbar ist.
Die Fallbeschreibung wird automatisch mit „Anruf über CCAI Platform“ oder „Chat über CCAI Platform“ ausgefüllt und muss möglicherweise von Kundenservicemitarbeitern aktualisiert werden.
Wenn Sie mit den Ergebnissen Ihres Anrufs oder Chats zufrieden sind, können Sie einen Lösungscode und eine Notiz eingeben (sofern die Felder für ServiceNow-Lösungscodes und ‑Notizen konfiguriert wurden) und dann die Anfrage schließen.
Möglicherweise müssen Sie im Browser auf die Navigationsschaltfläche back klicken, um zu prüfen, ob die Anfrage geschlossen wurde. In der ServiceNow-Instanz ist es normal, dass die Anfrage nach der Lösung automatisch geschlossen wird und Sie zu einer Kundendatensatzseite weitergeleitet werden.