Lors de l’intégration de données entre Skeepers et vos outils externes (application connectée ou dépôt FTP), il peut arriver que des erreurs de mapping surviennent.
Ces erreurs peuvent résulter de plusieurs facteurs, comme une mauvaise configuration des champs, des incompatibilités de format, des problèmes de synchronisation ou de connexion. Cet article vous détaille comment accéder aux erreurs et tenter de les résoudre ou de les rejouer afin de garantir une intégration fluide et précise des données entre vos systèmes et Skeepers.
Comment être prévenu en cas d'erreur ?
Tous les utilisateurs ayant activé les notifications techniques reçoivent automatiquement un email envoyé par "no-reply@myfeelback.com". Ce courriel contient un récapitulatif des dernières erreurs détectées sur votre compte :
- erreurs de mapping d'applications connectées
- erreurs d'imports automatisés de fichiers (import de sollicitations, feedbacks ou contacts par FTP)
- erreurs d'exports automatisés de fichiers (export de données brutes par FTP)
Vous recevrez ce type d'email en cas d'erreur survenue sur votre compte :
Les utilisateurs ayant activé les notifications techniques sur un compte parent recevront automatiquement les erreurs provenant de tous les comptes enfants associés.
Pour activer ou faire activer les notifications techniques, il est nécessaire de modifier le profil de l'utilisateur. Si vous n'êtes pas l'administrateur (aussi appelé responsable opérationnel) du compte, vous devrez en faire la demande à cette personne.
Sur le profil de l'utilisateur, il est nécessaire de cocher l'option "Envoyer les notifications techniques" puis d'enregistrer la page.
Comment accéder aux erreurs ?
Accéder aux erreurs par l'email de notification technique
Si vous êtes un utilisateur dont les notifications techniques sont activées, vous recevrez automatiquement un email lorsque des erreurs sont détectées sur le compte de votre organisation.
L’email contient toujours un lien permettant d’accéder directement aux éléments concernés. Il suffit donc de cliquer dessus.
Accéder aux erreurs par les feedbacks de la campagne
En mettant en place des actions post-réponse de mapping, vous pouvez directement distinguer pour chaque réponse dans l'onglet "Feedbacks" de votre campagne si les conditions ont conduit au déclenchement de l'action de mapping.
Le champ "Mappings exécutés" peut afficher trois types de valeurs :
- Champ vide : Le répondant ne remplissait pas les critères de déclenchement de l'action post-réponse de mapping. Dans ce cas, le mapping ne peut pas être réexécuté.
- Champ complété avec le nom du mapping : Le répondant remplissait les critères de déclenchement, et le mapping s’est exécuté correctement.
- Champ complété avec le nom du mapping en rouge : Le répondant remplissait les critères de déclenchement, mais le mapping n’a pas abouti en raison d’une erreur détectée. Dans ce cas, le mapping peut être réexécuté si le problème est corrigé.
Dans le cas d'un mapping mal exécuté (en erreur), il est possible de cliquer sur son nom en rouge dans les feedbacks de votre campagne, pour directement accéder à l'erreur. Il est possible de relancer l'erreur en un clic en appuyant sur le bouton "Exécuter de nouveau".
Accéder aux erreurs par les paramètres du compte
Enfin, vous avez aussi la possibilité d'accéder directement aux erreurs de mappings d'une application connectée. Pour cela, avec le droit "Paramètres du compte", accédez à l'onglet "Paramètres" du menu latéral gauche, puis rendez-vous dans la section "Applications connectées".
Entrez dans les configurations de l'application connectée dont vous souhaitez identifier les erreurs, rendez-vous dans l'onglet "Mappings" et sélectionnez un mapping.
Accédez au second onglet "Erreurs", qui affiche le nombre d'erreurs détectées pour ce mapping.
Sur cette nouvelle page, vous trouverez l’ensemble des occurrences d’erreurs de mapping.
Pour chaque erreur, vous pouvez :
- Faire afficher les détails de l'erreur en cliquant sur le bouton "Détails"
- Faire afficher le feedback lié à cette erreur en cliquant sur le bouton "Feedbacks"
- Opérer une nouvelle exécution du mapping en erreur en cliquant sur le bouton "Exécuter de nouveau"
Comprendre les erreurs de mapping
Identifier les erreurs de mapping
De nombreuses erreurs peuvent survenir dans vos mappings. Les erreurs affichées dans Skeepers proviennent de votre outil externe et sont uniquement retranscrites sur la plateforme.
Nous vous recommandons de consulter directement l’erreur dans l’instance de votre outil externe, où des détails supplémentaires peuvent être disponibles. Pour mieux les interpréter, n’hésitez pas à vous référer à la documentation proposée par votre outil.
Voici une liste exhaustive des erreurs courantes :
| Code d'erreur | Description | Causes possibles |
|---|---|---|
| 400 Bad Request | Requête invalide |
|
| 401 Unauthorized | Accès non autorisé |
|
| 403 Forbidden | Accès refusé |
|
| 404 Not Found | Ressource introuvable |
|
| 409 Conflict | Conflit de données |
|
| 422 Unprocessable Entity | Données non traitables |
|
| 429 Too Many Requests | Trop de requêtes envoyées |
|
| 500 Internal Server Error | Erreur interne du serveur |
|
| 502 Bad Gateway | Problème de communication entre serveurs |
|
| 503 Service Unavailable | Service temporairement indisponible |
|
| 504 Gateway Timeout | Délai d’attente dépassé |
|
Rejouer les erreurs de mapping
Pour rejouer les erreurs de mapping, il vous suffit de vous rendre dans l'erreur spécifiée, depuis les paramètres du compte, et d'appuyer sur le bouton "Exécuter de nouveau".
|
|
|
|
Le mapping a été réexécuté, la donnée devrait apparaître dans les outils sous peu |
L'exécution du mapping n'a pas abouti, une analyse approfondie de l'erreur est nécessaire afin d'apporter les corrections appropriées |
Si vous avez des questions, n'hésitez pas à contacter notre équipe Customer Care.