Une intégration ne se connecte pas
Voir en MarkdownCe 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
- Guide des intégrations : comment la connexion à un service est censée fonctionner
- Intégrations personnalisées : l'étape de vérification spécifique à une intégration auto-définie
- Un agent reste bloqué dans une boucle de nouvelles tentatives : quand une intégration qui fonctionnait auparavant commence à échouer en pleine conversation