ServiceNow

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:

  1. Gehen Sie zu User > New (Nutzer > Neu).

  2. Geben Sie die Details ein und wählen Sie „Nur Webdienstzugriff“ aus.

  3. 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.

  1. Wählen Sie im Menü Konfigurieren > Formulardesign aus, um den Formulardesigner zu öffnen.

  2. Wählen Sie in der linken Spalte den Tab Feldtypen aus.

  3. Ziehen Sie den Typ des benutzerdefinierten Felds, den Sie hinzufügen möchten.

  4. Nachdem Sie den Feldtyp in den gewünschten Bereich gezogen haben, wählen Sie das Zahnradsymbol aus, um die Einstellungen aufzurufen.

  5. Ändern Sie im Fenster das Label und notieren Sie sich den Namen. Der Name wird in den CCAI Platform-Anwendungseinstellungen verwendet.

  6. 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

  1. Gehen Sie zu Alle > Systemanwendungen > Alle verfügbaren Anwendungen > Alle.

  2. Suchen Sie nach „OpenFrame“.

  3. Installieren Sie OpenFrame.

  4. Rufen Sie nach der Installation All > OpenFrame > Configurations auf.

  5. 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.

  6. Gib sys_properties.list in die Suche ein.

  7. glide.ui.concourse.onmessage_enforce_same_origin_whitelist bearbeiten

  8. Fügen Sie die neue URL der Liste der Werte hinzu.

  9. sn_openframe.cross.origin.access bearbeiten

  10. Fügen Sie autoplay zur Liste der Werte hinzu.

Next-UI-Erfahrung für Nutzer aktivieren

  1. Geben Sie sys_properties.list in die Navigationsleiste ein und drücken Sie die Eingabetaste.

  2. Legen Sie die Systemeigenschaft glide.ui.polaris.experience auf true fest.

  3. Legen Sie die Nutzereinstellung glide.ui.polaris.use für das System auf false fest.

  4. Legen Sie die Nutzereinstellung glide.ui.polaris.use für einen Nutzer auf true fest. (Sie können eine Zeile für Nutzereinstellungen erstellen.)

Systemeigenschaften aktualisieren

  1. Geben Sie sys_properties.list in die Navigationsleiste ein und drücken Sie die Eingabetaste.

  2. glide.ui.concourse.onmessage_enforce_same_origin_whitelist bearbeiten

  3. Fügen Sie die URL der Werteliste hinzu. Mehrere Werte müssen durch Kommas getrennt werden.

  4. sn_openframe.cross.origin.access bearbeiten

  5. Fügen Sie der Werteliste „autoplay“ hinzu.

  6. glide.ui.polaris.experience bearbeiten

  7. Ändern Sie den Wert in false, da einige Funktionen nicht funktionieren, wenn sie aktiviert sind.

Click-to-Call-Funktion oben im Formular hinzufügen

  1. Rufen Sie System-UI > UI-Aktionen auf.

  2. Wählen Sie Neue Aktion erstellen aus.

  3. Wählen Sie im Formular die Tabelle aus, zu der diese Click-to-Call-Funktion gehören soll.

  4. Verwenden Sie für Formulare mit einem Verweis auf einen Kontakt oder Nutzer die g_form.getReference API, 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);
      });
    }
    
  5. Verwenden Sie für Formulare mit einer Nummer im Formular, die angerufen werden soll, die g_form.getValue API, 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

  1. 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_phone oder show_phone_customer_service zum Wert ref_contributions hinzu.

  2. Bearbeiten Sie in „UI Macros“ (UI-Makros) show_phone und show_phone_customer_service.

  3. 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.

  1. Rufen Sie im CCAI Platform-Portal Einstellungen > Entwicklereinstellungen > CRM auf.

  2. Wählen Sie im Abschnitt „Agent Platform“ die Option ServiceNow aus.

  3. 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.

  4. Wählen Sie im Feld ServiceNow Cloud Selection (ServiceNow-Cloud-Auswahl) die Option Incident für einen einfachen Tickettyp aus. Wenn Sie Custom auswählen, werden zusätzliche Optionen angezeigt. Vorfälle sind Erweiterungen der Aufgabentabelle. Benutzerdefinierte Objekte sollten Erweiterungen von Vorfällen sein.

  5. Geben Sie in den Feldern Authentifizierungsdaten Ihren Nutzernamen und Ihr Passwort ein.

  6. Wenn Sie Incident fü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 fields und Phone number primary field.
  7. Wenn Sie Custom für den Feldtyp „Cloud-Auswahl“ ausgewählt haben, werden die folgenden Felder angezeigt:

    • Lookup-Eintragsobjekt:

      • Objekttyp des Basisdatensatzes: Wählen Sie entweder den Tabellentyp task oder incident aus.

      • 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 fields und Phone number primary field.

  8. 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.

  9. Telefonnummernformat: Hier können Sie das Format auswählen, das Sie für die Anzeige von Telefonnummern verwenden möchten.

  10. Sitzungsmetadatendatei: Setzen Sie hier ein Häkchen, um Sitzungsmetadaten an CRM-Datensätze anzuhängen.

  11. 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

  1. Rufen Sie in Ihrem ServiceNow-Konto Alle > System-OAuth > Anwendungsregistrierung auf.

  2. Erstellen Sie eine OAuth-Anwendung und wählen Sie OAuth-API-Endpunkt für externe Clients erstellen aus.

  3. 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_callback

    • Tokeneinschrä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.

  4. Klicken Sie auf Senden.

  5. 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

  1. Gehen Sie zu Entwicklereinstellungen > CRM.

  2. Achten Sie darauf, dass die Einstellungen wie in den vorherigen Schritten beschrieben eingegeben und konfiguriert sind.

  3. Klicken Sie unter „Authentifizierungsmethode“ auf OAuth.

  4. Geben Sie die OAuth-Client-ID und den OAuth-Clientschlüssel ein. (Siehe Schritt 5 oben.)

  5. Klicken Sie auf Speichern.

  6. 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

  1. Gehen Sie zu Einstellungen > Betriebsverwaltung.

  2. Gehen Sie zum Bereich Zuordnung benutzerdefinierter CRM-Felder und klicken Sie auf Alle ansehen.

  3. 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. device für SDK-Nutzlasten oder orderId fü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-Endpunkt Send custom data in a chat gesendet werden. Der Schlüssel muss genau übereinstimmen (einschließlich Groß-/Kleinschreibung).

  4. 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.