Dépannage de l’Intégration

Si une intégration ne se connecte pas, cesse de fonctionner ou ne peut pas accomplir une tâche, utilisez ce guide pour vérifier la connexion, l’accès au compte et la ressource sélectionnée.

Cette page couvre les problèmes courants de connexion et d’autorisation dans Atoms. Pour la configuration spécifique à un service, les actions prises en charge ou la configuration dans votre app, commencez par Connect and Manage Intégrations et choisissez le guide de votre service.

Commencez par ces vérifications

1. Vérifiez où l’échec se produit. L’Agent est-il incapable d’utiliser un service dans le Chat, ou la fonctionnalité échoue-t-elle uniquement dans votre app ? Connecter un service pour le Chat ne confirme pas à lui seul que votre app est correctement configurée. Pour les échecs propres à l’app, consultez Connect and Manage Intégrations.
2. Ouvrez l’intégration. Dans le Chat de votre projet, ouvrez le menu d’options à côté du champ de saisie du message, puis choisissez Connectors → Add connectors. Recherchez et sélectionnez le service. Vérifiez s’il est connecté ou s’il propose encore Connect. Certains services ouvrent leur propre écran de gestion.
3. Vérifiez l’accès dans le service lui-même. Confirmez que le compte que vous aviez l’intention de connecter peut ouvrir le fichier, dépôt, calendrier, propriété ou autre ressource exact(e) concerné(e).
4. Enregistrez l’erreur avant de modifier quoi que ce soit. Notez le message exact, la date, l’heure et le fuseau horaire, le projet ou le Chat affecté, ainsi que la dernière tentative réussie. Masquez les informations privées dans les captures d’écran.

Ouvrez les options de saisie du Chat, choisissez Connectors (1), puis Add connectors (2) pour parcourir les intégrations disponibles.

Vous pouvez également gérer les connexions disponibles dans Settings → Connectors. Sélectionnez l’intégration que vous souhaitez vérifier.

Gardez vos identifiants privés. Ne collez jamais de mots de passe, codes de connexion, clés API, jetons d’accès ou autres secrets dans le Chat ou dans une demande d’assistance. Saisissez les identifiants uniquement dans le flux de connexion du service ou dans le champ de configuration sécurisé prévu à cet effet.

Trouvez votre problème

Vous ne trouvez pas ou ne pouvez pas démarrer une intégration

1. Utilisez Add connectors pour rechercher dans le catalogue. La liste plus courte dans le menu Chat n’est pas le catalogue complet.
2. Si Atoms indique que la fonctionnalité est disponible uniquement dans un projet, ouvrez le projet concerné et essayez à cet endroit.
3. Si un contrôle est désactivé, lisez son explication. S’il nécessite un rôle ou une autorisation différente, demandez de l’aide au propriétaire du projet ou de l’espace de travail. Ne déconnectez pas un autre service simplement pour contourner une restriction.

Vérifiez le résultat : Vous pouvez ouvrir l’écran de connexion ou de gestion du service. S’il n’apparaît toujours pas, consultez Connect and Manage Intégrations ou contactez l’assistance pour confirmer sa disponibilité. Ne supposez pas qu’un service manquant peut être activé par des tentatives répétées de connexion.

L’autorisation ne se termine pas

1. Sélectionnez Connect une seule fois et recherchez la fenêtre de connexion du service. Si votre navigateur signale une fenêtre pop-up bloquée, autorisez les pop-up pour le site Atoms et réessayez. Dans Chrome, suivez les instructions pour autoriser les pop-up d’un site spécifique ; vous n’avez pas besoin de les activer pour tous les sites.
2. Choisissez le compte prévu et examinez l’accès demandé. Terminez le flux d’autorisation du service avant de fermer sa fenêtre.
3. Si le service indique explicitement que votre organisation a bloqué l’app ou l’accès demandé, enregistrez le message et contactez votre administrateur. Ne contournez pas la politique de votre organisation.
4. Revenez à Atoms et rouvrez l’intégration pour vérifier son état. Fermer une fenêtre de connexion ne confirme pas que l’autorisation a réussi.

Examinez l’accès demandé avant de terminer l’autorisation. Autoriser un compte ne confirme pas à lui seul que la ressource prévue est connectée.

Si l’autorisation inclut un sélecteur d’organisation ou d’espace de travail, confirmez la sélection prévue et examinez les autorisations demandées.

Vérifiez le résultat : L’intégration est affichée comme connectée. Sur les écrans de détail des connecteurs qui utilisent la mise en page standard, Connect est remplacé par Disconnect et Try it out. D’autres services ont leur propre mise en page. Si l’option Connect est toujours proposée ou si une erreur s’affiche, capturez ce résultat et contactez l’assistance après une nouvelle tentative unique.

Le mauvais compte est connecté

Si l’écran de gestion de l’intégration affiche un compte, comparez-le avec le compte qui possède la ressource ou peut y accéder. Tous les connecteurs n’affichent pas le compte connecté, donc n’utilisez pas uniquement la connexion actuelle du navigateur comme preuve du compte utilisé par Atoms.

Ouvrez la ressource directement dans le service avec le compte prévu. Si ce compte ne peut pas y accéder, demandez d’abord l’accès au propriétaire de la ressource. Si la connexion utilise le mauvais compte, suivez les instructions du service pour changer de compte ou reconnectez en toute sécurité et choisissez explicitement le bon compte pendant l’autorisation.

Vérifiez le résultat : Une petite requête de lecture prise en charge renvoie la ressource prévue. Si vous ne pouvez toujours pas déterminer quel compte est connecté, contactez l’assistance au lieu de déconnecter de manière répétée.

L’intégration est connectée, mais l’Agent ne trouve pas vos données

1. Vérifiez la connexion. Ouvrez les détails de l’intégration dans Connectors et confirmez qu’elle est connectée. Vérifiez le compte ou la ressource sélectionné(e) lorsqu’ils sont affichés.
2. Vérifiez la ressource exacte. Ouvrez-la directement dans le service avec le compte prévu. Confirmez son emplacement et ses autorisations d’accès, y compris la bonne organisation, le bon espace de travail, dossier ou propriété, le cas échéant.
3. Rendez la requête spécifique. Nommez le service et fournissez le nom exact ou le lien de la ressource lorsque le connecteur le prend en charge. Demandez d’abord une seule action de lecture prise en charge, plutôt que de rechercher et modifier plusieurs ressources à la fois.

Par exemple, si le connecteur prend en charge la lecture de documents : “Utilise [service] pour lire [nom du document ou lien] et dis-moi son titre. Ne le modifie pas.”

Vérifiez le résultat : L’Agent renvoie la ressource prévue. Si l’accès direct fonctionne mais que l’Agent ne peut toujours pas la lire, vérifiez les capacités prises en charge par le connecteur et l’accès accordé. Reconnectez-vous uniquement s’il existe des preuves d’un problème d’autorisation.

L’Agent peut lire les données, mais ne peut pas les modifier

Une lecture réussie ne confirme pas que le connecteur prend en charge la modification demandée ou qu’il a l’autorisation de l’effectuer.

1. Consultez Connect and Manage Intégrations ou la liste What you can do du connecteur, si elle est affichée. Confirmez que l’action demandée est prise en charge.
2. Vérifiez si le compte connecté est autorisé à effectuer cette modification sur la ressource exacte. Demandez au propriétaire de la ressource ou à l’administrateur uniquement l’accès nécessaire.
3. Lisez toute erreur ou demande de confirmation. Si une autorisation supplémentaire est requise, suivez le flux documenté du service. Se reconnecter ne peut pas ajouter une action que le connecteur ne prend pas en charge.

Avant de réessayer une écriture : Inspectez la destination pour voir si la première tentative a déjà créé ou modifié quelque chose. Une réponse d’échec ne suffit pas à prouver qu’aucun changement n’a eu lieu. Ne répétez pas un paiement, un message, une invitation ou la création d’un enregistrement tant que vous ne connaissez pas le résultat précédent.

Vérifiez le résultat : Une modification prise en charge réussit sur une ressource de test appropriée, et vous la confirmez directement dans le service. Pour les paiements ou autres flux de travail en production, utilisez les instructions de test spécifiques au service au lieu d’une transaction réelle.

Une connexion qui fonctionnait auparavant s’est arrêtée

Vérifiez ce qui a changé depuis la dernière requête réussie : le compte, son accès à la ressource, la politique d’apps de l’organisation ou l’autorisation de la connexion.

1. Rouvrez l’intégration dans Atoms et vérifiez si elle est toujours connectée.
2. Essayez d’ouvrir la ressource directement dans le service. Si l’accès a été supprimé, résolvez cela avec le propriétaire de la ressource ou l’administrateur.
3. Si l’erreur indique que l’autorisation a expiré, a été révoquée ou n’est pas valide, suivez Reconnect safely. Si l’erreur concerne une panne du service, une limite ou une action non prise en charge, traitez d’abord cette cause.

Vérifiez le résultat : Une petite requête de lecture fonctionne à nouveau. Si la même erreur persiste, enregistrez-la avec la dernière heure de réussite et contactez l’assistance.

Les résultats ne sont pas à jour ou une requête continue d’échouer

1. Comparez le résultat avec le service lui-même. Confirmez le compte, la ressource, la plage de dates, les filtres et le fuseau horaire, le cas échéant. Demandez à l’Agent de récupérer la valeur actuelle plutôt que de s’appuyer sur une réponse antérieure dans la conversation.
2. En cas d’erreur explicite de délai d’attente ou de service indisponible, consultez la page officielle d’état ou d’aide du service. Si l’erreur indique un délai avant nouvelle tentative, attendez jusque-là ; n’envoyez pas de requêtes répétées tant que la limite ou la panne persiste.
3. Enregistrez tout texte non envoyé, actualisez Atoms et revérifiez l’état du connecteur. Actualiser la page n’est pas la même chose que réautoriser le compte.
4. Réessayez une petite requête de lecture. Avant de réessayer quoi que ce soit qui modifie des données externes, inspectez la destination pour vérifier le résultat précédent.

Vérifiez le résultat : Le nouveau résultat correspond à la ressource prévue dans le service. S’il reste incorrect, envoyez à l’assistance les valeurs attendues et réelles avec les horodatages. Ne supposez pas que toutes les intégrations se mettent à jour selon le même calendrier.

Reconnectez en toute sécurité

Reconnectez-vous lorsque l’autorisation n’est pas valide ou que le mauvais compte est lié — pas comme première étape pour chaque requête échouée.

Avant de déconnecter : Terminez ou mettez en pause les tâches qui dépendent de la connexion, vérifiez le résultat de toute écriture externe en attente et assurez-vous de pouvoir vous reconnecter avec l’accès requis. La déconnexion rend la connexion indisponible jusqu’à ce qu’elle soit reconnectée. Consultez Connect and Manage Intégrations pour tout effet supplémentaire ; ne supposez pas que la déconnexion annule les modifications précédentes ou le travail déjà envoyé.

1. Ouvrez les détails de connexion du service. S’il possède son propre écran de gestion de compte, suivez les instructions de cette intégration.
2. Sur l’écran standard de détail du connecteur, sélectionnez Disconnect lorsque vous êtes prêt, puis sélectionnez Connect. Ne supposez pas qu’il y aura une confirmation supplémentaire avant la déconnexion.
3. Choisissez le compte prévu et terminez l’autorisation. Examinez les autorisations demandées.
4. Revenez à Atoms et confirmez l’état connecté.
5. Exécutez la vérification de récupération ci-dessous avant de reprendre la tâche d’origine.

Si la même erreur réapparaît, cessez de vous reconnecter et contactez l’assistance avec l’erreur et les vérifications déjà effectuées.

Vérifiez que le problème est résolu

1. Demandez une action unique, prise en charge et en lecture seule sur une ressource que vous pouvez vérifier directement. Si vous utilisez Try it out, examinez le prompt suggéré avant de l’envoyer.
2. Comparez la réponse avec le service lui-même. Confirmez la bonne ressource, le bon contexte de compte et le résultat demandé — pas seulement l’indicateur de connexion.
3. Si votre tâche nécessite des modifications, utilisez une ressource de test appropriée ou le flux de test documenté du service et vérifiez le résultat à la destination.

Vérifiez l’état de la connexion et la ressource sélectionnée. Un indicateur de connexion seul ne confirme pas que les données attendues sont disponibles ou à jour.

Confirmez l’organisation et le projet, puis ouvrez Dashboard pour inspecter la ressource sans effectuer de modifications. La déconnexion ne fait pas partie de cette vérification.

Si la vérification réussit, reprenez votre tâche. Si le Chat fonctionne mais que la fonctionnalité échoue toujours dans votre app, consultez Connect and Manage Intégrations ou le dépannage de build et preview. Vérifiez l’environnement dans lequel l’échec se produit ; une requête Chat réussie ne prouve pas que l’app est correctement configurée.

Obtenir de l’aide

Si le problème persiste, utilisez Get support et incluez :

• Le nom de l’intégration et l’adresse e-mail de votre compte Atoms.
• Le projet ou le lien du Chat affecté, et si l’échec se produit dans le Chat ou dans votre app. Pour une app, identifiez l’environnement affecté.
• Le compte de service et la ressource prévus, en utilisant uniquement des identifiants non secrets nécessaires à l’enquête.
• L’erreur exacte, la date, l’heure et le fuseau horaire ; incluez la dernière heure de réussite si elle est connue.
• Les étapes pour reproduire le problème, le résultat attendu, le résultat réel et les vérifications déjà essayées.
• Votre navigateur et votre appareil, ainsi que des captures d’écran expurgées ou un court enregistrement si utile.

Pour une écriture échouée, indiquez si la destination montre une modification terminée, aucune modification ou un résultat inconnu. Supprimez les mots de passe, codes de connexion, clés API, jetons et données privées non pertinentes de toutes les pièces jointes.