Passer au contenu
HeartBeatAgents

Une intégration ne se connecte pas

Voir en Markdown

Ce que signifie réellement une erreur de connexion spécifique, d'une clé API rejetée à un domaine non vérifié, et comment la corriger.

« Clé API invalide : authentification rejetée par le service distant »

La clé elle-même a été rejetée par le service auquel vous vous connectez, pas par HeartBeatAgents. Régénérez la clé sur le propre site de ce service et réessayez ; une erreur de copier-coller (un espace en fin de chaîne, une clé tronquée) est la cause la plus courante.

« Le domaine n'est pas vérifié »

Certains services (les expéditeurs d'e-mails en particulier) ne vous permettent d'utiliser qu'un domaine déjà vérifié de leur côté. Vérifiez d'abord le domaine dans le propre tableau de bord de ce service ; l'erreur nomme les domaines déjà vérifiés, s'il y en a, pour que vous puissiez confirmer que vous visez le bon.

« Veuillez remplir à la fois l'ID client et le secret client »

Pour une application OAuth personnalisée, les deux champs sont requis avant que le flux de connexion ne puisse démarrer ; une description de service avec seulement un ID client (ou seulement un secret) ne peut pas s'authentifier.

La connexion expire, ou « Impossible de se connecter à {host} »

C'est un problème d'accessibilité réseau vers cet hôte spécifique, pas un problème d'authentification. Confirmez que l'hôte est bien correct (une faute de frappe dans l'hôte API d'une intégration personnalisée est une cause courante) et accessible depuis l'endroit où cette instance s'exécute.

« Session expirée : veuillez vous reconnecter »

Cela interrompt spécifiquement un flux OAuth, pas votre session HeartBeatAgents en général. Recommencez la connexion depuis Paramètres → Intégrations.

Le test de connexion réussit, mais l'intégration ne fonctionne toujours pas pour un agent

Un test réussi confirme seulement que l'identifiant lui-même est valide ; il ne confirme pas qu'un agent a reçu l'accès. Vérifiez Paramètres → Intégrations → [ce service] → Assigner aux agents pour confirmer que l'agent que vous attendez y est bien lié.

À voir aussi