Pourquoi mon intégration est-elle connectée mais ne fonctionne pas correctement ?
Une intégration peut sembler connectée alors que des opérations individuelles échouent ou produisent des résultats inattendus.
Une connexion réussie confirme qu'une étape d'autorisation ou de configuration a été complétée. Cela ne garantit pas nécessairement que chaque opération prise en charge dispose des autorisations requises, d'une configuration valide ou d'un accès aux ressources externes souhaitées.
Pourquoi cela peut-il arriver ?
Les causes possibles incluent :
1. Autorisations manquantes pour une opération spécifique.
2. Enregistrements externes qui ne sont pas disponibles ou inaccessibles.
3. Identifiants de ressources ou valeurs de configuration incorrects.
4. Informations d'identification d'autorisation expirées ou révoquées.
5. Restrictions API côté fournisseur.
6. Limites de taux ou quotas d'utilisation.
7. Pannes temporaires de réseau ou du fournisseur.
8. Changements dans le compte externe ou ses autorisations.
9. Données invalides soumises au service externe.
10. Une opération qui n'est pas prise en charge par l'intégration.
Comment identifier le problème
Étape 1 : Déterminez quelle opération échoue.
Identifiez si le problème affecte la récupération d'informations, la création d'enregistrements, la mise à jour de données ou une autre action prise en charge.
Étape 2 : Vérifiez si d'autres opérations fonctionnent.
Si certaines opérations réussissent tandis que d'autres échouent, le problème peut impliquer des autorisations ou des configurations spécifiques à l'opération.
Étape 3 : Vérifiez la ressource externe.
Confirmez que l'enregistrement, le calendrier, le compte ou une autre ressource existe et est accessible au compte externe autorisé.
Étape 4 : Passez en revue la configuration de l'intégration.
Vérifiez les paramètres pertinents et les identifiants de ressources pour des valeurs incorrectes ou obsolètes.
Étape 5 : Passez en revue les autorisations du compte externe.
La connexion peut être autorisée sans avoir accès à chaque ressource ou action.
Étape 6 : Inspectez les détails d'erreur disponibles.
Recherchez des erreurs d'authentification, des échecs d'autorisation, des demandes invalides ou des messages spécifiques au fournisseur.
Étape 7 : Vérifiez la disponibilité du service externe.
Certaines opérations peuvent être temporairement indisponibles lors d'incidents du fournisseur.
Étape 8 : Testez avec une opération contrôlée.
Utilisez un test à faible risque qui ne modifie pas les enregistrements commerciaux importants.
Étape 9 : Passez en revue le résultat.
Confirmez que le service externe a reçu et traité l'opération prévue.
Un statut connecté garantit-il que les données se synchronisent ?
Non.
Le statut de connexion et l'échange de données réussi sont des conditions différentes.
Reconnecter résout-il toujours le problème ?
Non.
La réautorisation peut aider lorsque les informations d'identification ont expiré ou que les autorisations ont changé, mais cela ne résoudra pas nécessairement une configuration invalide, des ressources manquantes ou des opérations non prises en charge.
Que se passe-t-il si seul un processus commercial est affecté ?
Examinez la configuration et les dépendances externes de ce processus avant de modifier l'intégration entière.
Approche recommandée
Résolvez l'opération spécifique qui échoue plutôt que de supposer que la connexion entière est rompue.