L’API de flux personnalisé vous permet de filtrer les flux de reconnaissance des employés en fonction des métadonnées, d’afficher des étiquettes supplémentaires pour les destinataires et de personnaliser la manière dont les reconnaissances sont affichées. Bien que l’API de flux personnalisé soit couramment utilisée avec ScreenCloud, vous pouvez la configurer indépendamment pour répondre aux besoins uniques de votre organisation. Si vous souhaitez intégrer avec ScreenCloud, vous pouvez suivre les étapes décrites dans cet article.
Pour les clients configurant directement l’API de flux personnalisé, voici un guide étape par étape pour vous aider à la configurer.
- Accéder aux paramètres de l’API
- Configurer le champ de filtre (dans la plateforme)
- Sélectionner les étiquettes de métadonnées (optionnel)
- Activer les notifications d’erreur
- Configurer l’API (filtre de métadonnées)
- Tester et dépanner
- Ressources utiles
Accéder aux paramètres de l’API
Pour commencer avec l’API de flux personnalisé, connectez-vous à votre portail d’administration Awardco et accédez aux paramètres de configuration nécessaires.
- Connectez-vous à votre portail d’administration Awardco.
- Accédez aux paramètres d’administration.
- Sélectionnez Paramètres de l’API.
- Cliquez sur l’onglet Configuration de l’API.
Cette action ouvrira la page où vous pouvez configurer à la fois les paramètres dans la plateforme et la configuration de l’API nécessaires pour votre flux personnalisé.
Configurer le champ de filtre (dans la plateforme)
Le champ de filtre vous permet de contrôler comment les reconnaissances sont filtrées en fonction des champs de métadonnées, tels que l’emplacement, le département ou toute autre catégorie pertinente pour votre organisation. Ce filtre garantit que seules les reconnaissances correspondant à certains critères sont affichées. Pour configurer le champ de filtre :
- Choisissez un champ de métadonnées qui servira de filtre. Par exemple, si votre entreprise a plusieurs bureaux, vous pouvez utiliser le champ de métadonnées Emplacement.
- Cliquez sur « Enregistrer les modifications ».
Exemple :
Pour une entreprise ayant des bureaux dans différentes villes, sélectionner Emplacement comme filtre vous permet d’afficher les reconnaissances selon des emplacements spécifiques, comme « Londres » ou « New York ».
Note : Le champ de filtre spécifie le champ de métadonnées (par exemple, « Emplacement »), et vous définirez plus tard les valeurs à filtrer dans l’API elle-même.
Sélectionner les étiquettes de métadonnées (optionnel)
Vous pouvez enrichir le flux de reconnaissance en affichant des métadonnées supplémentaires, telles que le Département ou le titre de poste pour chaque employé recevant une reconnaissance. Pour configurer les étiquettes de métadonnées :
- Sous Sous-étiquette 1 et Sous-étiquette 2, sélectionnez les champs de métadonnées que vous souhaitez afficher. Des exemples courants incluent Département et titre de poste.
- Par exemple, sélectionner Département et titre de poste pourrait afficher des détails comme « Ventes » et « Représentant commercial ».
Cette étape est optionnelle, mais elle peut fournir un contexte supplémentaire à votre flux de reconnaissance.
Activer les notifications d’erreur
Pour assurer le bon fonctionnement de votre configuration, nous recommandons d’activer les courriels d’erreur. Cette fonctionnalité vous avertira s’il y a des problèmes avec le flux personnalisé, comme des configurations invalides ou des métadonnées manquantes.
- Trouvez l’option Envoyer des courriels d’erreur dans les paramètres.
- Activez cette fonctionnalité pour recevoir les notifications d’erreur.
Vous pouvez désactiver temporairement les courriels d’erreur si vous êtes au courant de problèmes connus en cours de résolution.
Configurer l’API (filtre de métadonnées)
Une fois les paramètres dans la plateforme configurés, vous devrez définir les valeurs spécifiques pour le filtrage en utilisant le paramètre de requête metadataFilter dans les appels API.
- Le paramètre de filtre de métadonnées dans la plateforme détermine quel champ est utilisé pour le filtrage (par exemple, Emplacement).
- Le paramètre API metadataFilter spécifie quelle valeur dans ce champ doit être utilisée comme critère de filtrage (par exemple, afficher uniquement les reconnaissances où « Emplacement » = « Las Vegas » sur cet écran).
Pour configurer l’API :
- Dans la configuration de l’API, utilisez le paramètre de requête metadataFilter pour spécifier les valeurs de filtrage.
- Assurez-vous que la valeur correspond aux valeurs de métadonnées stockées dans vos données utilisateur.
Exemple d’appel API :
https://api.awardco.com/api/feed?metadataFilter=Location:London
Cela garantit que seules les reconnaissances étiquetées avec la métadonnée d’emplacement Londres sont affichées.
Si des champs de métadonnées sont modifiés ou supprimés, vous devez mettre à jour la configuration du filtre en conséquence.
Tester et dépanner
Une fois la configuration terminée, il est important de tester le flux pour vous assurer que tout s’affiche correctement.
- Vérifiez que le filtre est correctement appliqué et que les bonnes reconnaissances sont affichées selon vos paramètres configurés.
- Si vous rencontrez des problèmes, consultez vos notifications de courriels d’erreur pour plus de détails.
Ressources utiles
Pour vous aider dans la configuration et fournir des conseils plus détaillés, voici quelques ressources utiles :
- Documentation de l’API : documentation complète sur l’utilisation de l’API de flux personnalisé, y compris les paramètres disponibles et des exemples.
- Ressources API Awardco : documentation générale de l’API et support supplémentaire.
If you have any questions, please contact Awardco Admin Support.