Please log in to continue
WalkMe stores your data in the region chosen during account setup.
We have data centers in the US and EU that follow local privacy and compliance laws. If you're not sure which region to select, check with your admin.
Mit der Benachrichtigungs-API für Desktop- und Mobilmenü können Sie Ereignisse in jedem System verwenden (auch wenn es kein WalkMe-Snippet hat), um eine Benachrichtigung in WalkMe auszulösen und Ihre Benutzer automatisch auf dem Laufenden zu halten. Menübenachrichtigungen mit einem REST-Aufruf an unseren WalkMe-Benachrichtigungs-Webhook auslösen.
Dieser Artikel enthält die Informationen, die für den REST-Aufruf erforderlich sind, der sowohl ein Authentifizierungs-Token als auch eine JSON-Nutzlast erfordert.
Jedes System, das eine REST-API aufrufen kann, kann verwendet werden, um Benachrichtigungen im Desktop-Menü oder im mobilen Menü auszulösen.
Für den Aufruf der API sind einige Berechtigungen und technische Einstellungen erforderlich. Stellen Sie sicher, dass Sie Zugriff haben und Folgendes tun können:
Folgendes benötigen Sie von WalkMe, um die API zu aktivieren. Nachfolgend erfahren Sie, wie Sie alles erfassen können.
Insbesondere finden Sie hier die notwendigen Informationen, um eine JSON-Benachrichtigung mit den folgenden Informationen zu verwenden:
Was ist ein Zugriffstoken?
Ein Zugriffstoken ist eine Anmeldeinformation, das von einer Anwendung zum Zugriff auf eine API verwendet werden kann. Sie informieren die API, dass der Inhaber des Tokens berechtigt ist, auf eine bestimmte Aktion zuzugreifen.
Das Zugriffstoken authentifiziert den API-Aufruf und erteilt der Anwendung die Berechtigung, Daten aus ihrem System an das Menü zu übergeben.
Im Bedienfeld „Create new key“:
Im Bedienfeld „Key Details“:
Für zusätzlichen Support und um das Authentifizierungs-Token zu erhalten: Seite der Entwickler
Wechseln Sie zum Kommunikationszentrum und erstellen Sie eine benutzerdefinierte Vorlage (Erstellen einer Meldung) Bei der Meldung, die Sie für die API erstellen, sind einige Dinge zu beachten:
Wenn Sie möchten, dass eine Benachrichtigung entweder für den Benutzer oder für das Ereignis personalisiert wird, das ausgelöst wird, können Sie dynamische Werte hinzufügen, die von der API automatisch ausgefüllt werden.
In der Abbildung sehen Sie zwei Beispiele für Werte, die mit dynamischem Text überschrieben werden, der je nach den Werten, die die API auslöst, ersetzt wird.
Dies ist ein Beispiel für eine API-Benachrichtigung mit Salesforce, die ausgelöst wird, wenn ein neuer Lead zugewiesen wurde. Der Vertriebsmitarbeiter wird über den Namen der Verkaufschance und den Link zum Lead in Salesforce informiert.
Die folgenden Schritte verbinden die Benachrichtigung mit der API.
Zusätzlichen Support erhalten Sie auf der Seite der Entwickler.
Jetzt ist es an der Zeit, einige Informationen über Ihre API einzugeben. Zur Klarstellung: Wir verwenden Zapier zur Erläuterung, aber wir empfehlen diese Anwendung nicht gegenüber anderen. Jede ähnliche App funktioniert.
Die unten verwendeten Informationen sind für alle Anwendungen allgemein notwendig:
Hinzufügen der Basis-Authentifizierung
Bei der Verwendung von Basic Auth ist die ClientID der Benutzername und das Client-Geheimnis wird als Passwort verwendet.
Sobald Sie diese Informationen hinzugefügt haben, erhalten Sie ein Zugriffstoken.
Jetzt ist es an der Zeit, die Leerstellen auszufüllen und den JSON-Code zu verwenden, der die Benachrichtigung aufrufen wird.
|
{ "notification": { "systemId": "<the workstation system id>", //Erforderlich, wenn Sie mehr als ein Workstation-System haben "templateId": "<template id>", //Erforderlich "endUsersIds": ["<end user id 1>",""<end user id 2>","<...>"], //Sie benötigen entweder eine Endbenutzer-ID oder eine Zielgruppen-ID (Sie können beide verwenden). Entfernen Sie die nichtverwendete "audiencesIds": ["<audience id 1>",""<audience id 2>","<...>"], //Sie benötigen entweder eine Endbenutzer-ID oder eine Zielgruppen-ID (Sie können beide verwenden), entfernen Sie die nicht-verwendete "notificationType": "<how notification will display, push v popup>", //Optional, Standard-Push, entfernen, wenn nicht verwendet "title": "<notification title as appears in the ComCenter notification table>", //Optional, entfernen, wenn nicht verwendet "runtimeTitle": "<what will appear to end-users in the Workstation list and in the push notification>", //Optional, entfernen, wenn nicht verwendet "runtimeDescription": "<what will appear to end-users i in the Workstation list and in the push message>", //Optional, entfernen, wenn nicht verwendet "startAt": "<start date YYYY-MM-DD hh:mm>", // Optional, Standard jetzt, die Zeitzone ist UTC, Sie können ein Datum und keine Uhrzeit hinzufügen, die Standardzeit ist 00:00 UTC, entfernen, was Sie nicht verwenden. "endAt": "<end date YYYY-MM-DD hh:mm>", // Optional, standardmäßig 30 Tage ab sofort, können Sie ein Datum und keine Uhrzeit hinzufügen, die Standardzeit ist 00:00, alles entfernen, was Sie nicht verwenden. "override": [ { // Weitere mit Komma getrennte {key:value}Paare können folgen // Der Wert könnte zum Beispiel eine URL sein, die von ServiceNow zum Öffnen eines Tickets übermittelt wird ] } } |
Hier sehen Sie ein Beispiel eines JSON-Codes mit echten Daten, aus dem einige Zeilen entfernt wurden, um ihn zu vereinfachen.
| { "notification": { "systemId": "bcf4c7f5682b4aa6875a0fc9bdfa21ca", "templateId": "1e5afe51-2d2a-4b22-a60a-cf2d6c01d726", "endUsersIds": ["name@email.com"], "runtimeTitle": "API Test 3", "notificationType": "Push", “override”: [ {“key”: “URL”, “value”: “www.someurl.com”} ] } } |
Nun, da wir die nötigen Informationen haben, können wir die Zusammenhänge herstellen. Um den Anruf zu tätigen (die Systeme zu verbinden, um neue Benachrichtigungen im Desktop- und Mobilmenü Ihres Unternehmens zu erstellen und zu veröffentlichen), benötigen Sie Ihr JSON plus:
