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.
Autorisez les services externes à créer, modifier, supprimer ou utiliser les données des segments WalkMe existantes pour la segmentation du contenu, le filtrage sur Insights et la production de rapports.
Par exemple : utilisez Heap Analytics pour créer un nouveau segment et afficher un ShoutOut en fonction de la logique de segmentation.
Qu'est-ce qu'un jeton d'accès ?
Un jeton d'accès est un identifiant qui peut être utilisé par une application pour accéder à une API. Ils informent l'API que le porteur du jeton a été autorisé à accéder à une action particulière.
Le jeton d'accès authentifie l'appel API, en donnant à l'application la permission de transmettre les données de son système au menu WalkMe.
À partir du panneau Créer une nouvelle clé :
À partir du panneau Détails clés :
Pour une assistance supplémentaire et pour obtenir le jeton d'autorisation: Page du développeur
Pour une assistance supplémentaire Page du développeur.
Maintenant, il est temps de remplir certaines informations sur votre application de connexion API.
Les informations utilisées ci-dessous sont universellement nécessaires sur toutes les applications :
Ajouter l'authentification de base
Une fois que vous avez ajouté ces informations, vous recevrez un jeton d'accès.
Maintenant, vous pouvez utiliser le jeton pour créer, obtenir, mettre à jour ou supprimer les segments WalkMe, en utilisant la documentation API ci-dessous.
Vous pouvez également utiliser les blocs de code cURL suivants :
Demande d'exemple - 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"} |
Appeler
| Description | Créer un nouveau segment basé sur la liste statique des utilisateurs |
| URL | https://api.walkme.com/public/v1/user/system/{systemGuid}/segment |
| Méthode | POST |
| En-têtes | Autorisation - Bearer - jwt |
| Paramètres d'URL |
Vous pouvez obtenir le système GUID à partir de l'éditeur depuis le Snippet du > Menu éditeur> Copiez la clé qui se trouve entre 'https:cdn.walkme.com/users/<LE GUID EST ICI>/test/walkme_<....>' |
| Charge utile / corps | {"id": "<external id>", "name": "<Le nom du segment WalkMe - sera visible dans l'éditeur>", « userIds » : [« John@company.com », « Melissa@company.com »] }id : id du segment de tas >- paramuserIds optionnels : liste des id d'utilisateurs -
|
| Description | Mettre à jour un segment existant | ||
| URL | https://api.walkme.com/public/v1/user/system/{systemGuid}/segment/{segmentGuid} | ||
| Méthode | PUT | ||
| En-têtes | autorisation - Bearer - jwt | ||
| systemGUID | systemGuid- GUID du système WalkMe segmentGuid - segment WalkMe GUID**SegmentGuid devra être placé dans l'URL dans son format de sortie avec un trait d'union comme : 12345aeb-123c-4d83-8b38-a5a456789d0a |
||
| Charge utile | application/json
paramètres de charge utile :
exemple de charge utile :
|
| Description | Obtenir des segments |
| URL | https://api.walkme.com/public/v1/user/system/{systemGuid}/segment |
| En-têtes | Autorisation - Bearer - jwt |
| paramètres d'URL | GUID du système - GUID du système WalkMe |
Une fois qu'un segment est créé, l'éditeur prendra jusqu'à 10 minutes pour se mettre à jour avec le nouveau segment externe dans le générateur de conditions.
Pour segmenter le contenu en fonction de l'identifiant de l'utilisateur s'il se trouve dans un segment spécifique créé par l'API, allez dans le générateur de condition et sélectionnez : Attributs de l'utilisateur → External-segment → Nom du segment → Est ou n'est pas → "true"
Vous devez seulement utiliser Est ou n'est pas en tant qu'opérateur, et "true" dans le champ de saisie (d'autres options ne fonctionneront pas).
| DESCRIPTION | Supprimer les segments |
| URL | https://api.walkme.com/public/v1/user/system/{systemGuid}/segment |
| En-têtes | Autorisation - Bearer - jwt |
| paramètres d'URL | ID de segment |
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>