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.
Ermöglichen Sie externen Diensten die Erstellung, Bearbeitung, Löschung oder Verwendung bestehender WalkMe-Segmentdaten zum Zweck der Inhaltssegmentierung, der Filterung von Insights und der Berichterstellung.
Zum Beispiel: Verwenden Sie Heap Analytics, um ein neues Segment zu erstellen und ein ShoutOut entsprechend der Segmentierungslogik anzuzeigen.
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 gibt der Anwendung die Berechtigung, Daten aus ihrem System an das WalkMe-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
Zusätzlichen Support erhalten Sie auf der Seite der Entwickler.
Jetzt ist es an der Zeit, einige Informationen über Ihre API einzugeben.
Die unten verwendeten Informationen sind für alle Anwendungen allgemein notwendig:
Hinzufügen der Basis-Authentifizierung
Sobald Sie diese Informationen hinzugefügt haben, erhalten Sie ein Zugriffstoken.
Jetzt können Sie das Token verwenden, um WalkMe-Segmente zu erstellen, zu erhalten, zu aktualisieren oder zu löschen, indem Sie die API-Dokumentation unten verwenden.
Sie können auch die folgenden cURL-Code-Blöcke verwenden:
Beispiel anfordern – cURL
--header 'Content-Type: application/x-www-form-urlencoded' \--header 'Authorization: Basic <credentials>' \--data-urlencode 'grant_type=client_credentials'# <credentials> is the base64 encoding of the consumer key and consumer secrect of the WalkMe account joined by a colon. |
{ "access_token": "asdjkldfsjsdfhjksfdhjkxvc32cvhjhjksefbnxjnweuirou8sdfg8xdfjwkjr.sv8o8vuisuhvseuksfe", "expires_in": 86400, "token_type": "Bearer", "scope": "segments:write segments:read"} |
Anruf tätigen
| Beschreibung | Erstellen eines neuen Segments basierend auf der statischen Liste der Benutzer |
| URL | https://api.walkme.com/public/v1/user/system/{systemGuid}/segment |
| Methode | POST |
| Header | Authentifizierungs-Bearer – jwt |
| URL-Parameter |
Sie können das System-GUID aus dem Editor > Editor Menu > Snippet abrufen Kopieren des Schlüssels zwischen 'https:cdn.walkme.com/users/<GUID IST HIER>/test/walkme_<....>' |
| Payload / Body | {"id": "<extneral id>", „name“: „<WalkMe Segment Name – wird im Editor sichtbar>“, "userIds": ["John@company.com", "Melissa@company.com"] }id: heap segment id >- optional paramuserIds: Liste der Benutzer-IDs -
|
| Beschreibung | Aktualisieren eines bestehenden Segments | ||
| URL | https://api.walkme.com/public/v1/user/system/{systemGuid}/segment/{segmentGuid} | ||
| Methode | PUT | ||
| Header | Authorisierung – Bearer – jwt | ||
| systemGUID | systemGuid- WalkMe system GUID segmentGuid – WalkMe Segment GUID**SegmentGuid muss in URL im ausgegebenen Format mit einem Bindestrich platziert werden wie: 12345aeb-123c-4d83-8b38-a5a456789d0a |
||
| Payload | application/json
Payload-Parameter
Payload-Beispiel:
|
| Beschreibung | Segmente abrufen |
| URL | https://api.walkme.com/public/v1/user/system/{systemGuid}/segment |
| Header | Authentifizierungs-Bearer – jwt |
| URL-Parameter | System Guid – WalkMe System GUID |
Sobald ein Segment erstellt wurde, dauert es bis zu 10 Minuten, bis der Editor mit dem neuen externen Segment im Condition Builder aktualisiert ist.
Um Inhalte zu segmentieren, die darauf basieren, ob die Benutzerkennung in einem bestimmten, von der API erstellten Segment enthalten ist, gehen Sie zum Condition Builder und wählen Sie: User Attributes (Benutzerattribute) → External-Segment (Externes-Segment) → Segment name (Segmentname) → Is or Is not (Ist oder Ist nicht) → „true“ (wahr)
Sie dürfen nur „Is or Is not“ als Operator und „true“ im Eingabefeld verwenden (andere Optionen funktionieren nicht).
| Beschreibung | Segmente löschen |
| URL | https://api.walkme.com/public/v1/user/system/{systemGuid}/segment |
| Header | Authentifizierungs-Bearer – jwt |
| URL-Parameter | Segement-ID |
DELETE <a target="_blank" data-stringify-link="https://api.walkme.com/public/v1/user/system/{systemGuid}/segment/{segmentId}" delay="150" data-sk="tooltip_parent" href="https://api.walkme.com/public/v1/user/system/%7BsystemGuid%7D/segment/%7BsegmentId%7D" rel="noopener noreferrer">https://api.walkme.com/public/v1/user/system/{systemGuid}/segment/{segmentId}</a>