Dépanner les connexions d'application

Diagnostiquez les problèmes de chargement, d'identifiants, d'autorisation, d'examen, de reconnexion et de déconnexion dans Applications.

Utilisez ce guide lorsqu’une application ne se charge pas, ne se connecte pas, ne se reconnecte pas, n’enregistre pas son accès aux outils ou ne se déconnecte pas comme prévu. Commencez par l’état que Runner affiche réellement plutôt que de répéter aveuglément un flux de fournisseur.

Chemin d’accès : Projet → Apps

Avant de commencer

Confirmez que vous avez ouvert les applications pour le projet et l’espace de travail prévus.
Effacer Rechercher des outils et tout filtre de catégorie d’applications d’agent.
Ractualisez la page une fois et attendez que les états de connexion se chargent.
Lire l’état exact de la carte : Connecter, Connexion en cours…, Connecté, Reconnecter, Examen en cours, ou un avis d’action requise.
Ouvrez uniquement l’action de récupération qui correspond à cet état.
N’incluez jamais de clé API, de secret, de document d’identité, de détails de paiement ou de fournisseur complet URL de rappel dans un message d’assistance ou une capture d’écran.

Les captures de cette page montrent l’interface en anglais.

Annotations en anglais : Résultats de recherche Notion dans le catalogue d’outils

Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.

La recherche réduit le catalogue d’outils. Si votre outil est manquant, effacez la recherche et les filtres avant de demander une application ; un résultat de recherche n’est pas une connexion autorisée.

Contrôles et résultats importants

Contrôle	Que se passe-t-il après l’avoir sélectionné
Effacer la recherche	Supprime la recherche Apps Agent actuelle afin que le catalogue disponible puisse réapparaître.
Connecter / Connecter et autoriser	Ouvre le flux de configuration ou d’autorisation externe pour cette application.
Reconnecter, quand affiché	Redémarre l’autorisation pour une connexion de fournisseur existante.
Réessayer	Répète la demande de catalogue, de liste d’outils ou de connexion échouée affichée par le panneau actuel.
Continuer l’intégration	Retourne au flux d’intégration Stripe existant lorsqu’une action est requise.
Déconnecter	Ouvre une confirmation ou démarre le flux de suppression documenté ; vérifiez l’état enregistré avant de modifier les identifiants du côté du fournisseur.

Tableau des symptômes et récupération

Ce que vous voyez	Signification probable	Action sûre suivante
L’application est manquante	La recherche, une catégorie, l’accès à l’espace de travail ou une fonctionnalité conditionnelle la masque.	Effacez la recherche, choisissez Tout, puis confirmez que la fonctionnalité est disponible pour cet espace de travail.
La carte continue de se charger	Runner n’a pas résolu la connexion enregistrée.	Actualisez Applications une fois. Évitez de soumettre une autre connexion pendant que l’état est inconnu.
Aucune application trouvée	Aucune application Agent ne correspond aux filtres actuels.	Sélectionnez Effacer la recherche.
Connecter ne fait rien	Un champ obligatoire est vide ou invalide, ou le flux du fournisseur n’a pas pu démarrer.	Lisez les erreurs de champ, recopiez la valeur requise et autorisez les fenêtres contextuelles du fournisseur le cas échéant.
Connexion en cours… ne se termine pas	L’autorisation externe a été fermée, bloquée ou n’a jamais retourné de résultat.	Retournez à Applications, actualisez l’état, puis utilisez Reconnecter si Runner l’offre.
Le fournisseur dit succès mais Runner ne le dit pas	Runner n’a pas confirmé une connexion utilisable.	Rouvrez Applications. Traitez uniquement Connecté comme succès ; utilisez Reconnecter au lieu de créer des doublons.
Reconnecter	L’autorisation existante nécessite une attention.	Sélectionnez-la et complétez le flux du fournisseur à nouveau.
Examen en cours	Stripe examine les détails soumis.	Suivez les avis d’action ; ne démarrez pas un autre compte simplement pour supprimer l’étiquette.
Actions Stripe requises	Stripe a besoin d’informations ou a mis en pause une capacité.	Examinez les détails À fournir maintenant, À fournir plus tard, Examen en cours, paiement et versement, puis utilisez Continuer l’intégration quand affiché.
Clé API ou secret rejeté	La valeur est incorrecte, expirée, provient du mauvais compte ou n’est pas acceptée pour cette intégration.	Recopiez-la à partir du fournisseur. Ne modifiez pas les secrets par supposition.
Domaine Shopify invalide	La valeur n’est pas le domaine permanent du magasin Shopify.	Utilisez `your-store.myshopify.com`, pas un domaine de vitrine personnalisé.
La fenêtre d’autorisation de l’application Agent est bloquée	Le navigateur a empêché le flux externe.	Autorisez les fenêtres contextuelles pour Runner et démarrez Connecter et autoriser à nouveau.
Les outils de l’application Agent ne se chargent pas	Runner n’a pas pu récupérer la liste des outils de cette application.	Sélectionnez Réessayer dans Détails de l’app.
Le commutateur d’outil signale un échec	Le nouveau paramètre d’outil n’a pas été enregistré.	Attendez que le commutateur s’actualise, confirmez son état actuel, puis réessayez une fois.
La déconnexion signale un échec	Runner n’a pas confirmé la suppression.	Supposez que la connexion existante est toujours active et rouvrez Applications avant de réessayer.

Vérifications spécifiques au fournisseur

Stripe

Continuez une tentative d’intégration existante avec Reconnecter ou Continuer l’intégration.
Lisez les exigences d’action au lieu de vous fier uniquement à la couleur de la carte.
Une vitrine publiée peut toujours avoir des paiements en pause ou indisponibles.
Utilisez l’action du tableau de bord Stripe uniquement après que Runner ait un compte associé.

E-mail

Un changement de commutateur échoué revient à l’état enregistré.
Un commutateur activé ne prouve pas qu’un e-mail particulier a été livré.
Vérifiez l’événement du magasin, le destinataire, la configuration de l’e-mail et la version actuellement publiée avec des données de test sûres.

Shippo

Recopiez la clé API Shippo à partir du compte prévu.
Une carte connectée ne vérifie pas les tarifs, les transporteurs, les étiquettes ou la création d’expédition.

Shopify

Utilisez le domaine permanent myshopify.com.
Si un espace de travail a déjà un magasin connecté, examinez-le avant de déconnecter.
Redémarrez l’autorisation lorsque le lien de connexion expire ou que le magasin retourné ne correspond pas au domaine que vous avez saisi.

CJ Dropshipping

Confirmez que la clé API appartient au compte CJ que vous avez l’intention d’utiliser.
Après la déconnexion, les futures recherches, importations, commandes et opérations CJ avec votre compte marchand sont bloquées jusqu’au rétablissement d’une connexion valide.
Reconnectez le même compte CJ et vérifiez les importations existantes. Si l’identité fournisseur ou les données en direct d’un article ne correspondent plus, supprimez-le et importez-le à nouveau.

4PX

Confirmez que la clé API et le secret appartiennent au même compte et sont dans les champs corrects.
Une carte connectée ne prouve pas qu’une destination ou une commande est admissible à l’exécution.

Apps Agent

La section entière ou une application individuelle peut être conditionnellement indisponible.
Effacez les filtres avant de traiter une application comme absente.
Examinez les commutateurs d’outils avant de reconnecter ; n’accordez pas plus d’accès simplement pour faciliter la configuration.

La déconnexion a échoué ou a produit un résultat incertain

Gardez le compte du fournisseur et les opérations du magasin actuelles inchangés.
Rouvrez Projet → Apps et vérifiez l’état de la carte.
S’il affiche toujours connecté, traitez la connexion comme active.
Ne supprimez pas les identifiants du côté du fournisseur jusqu’à ce que vous compreniez si le paiement actif, l’e-mail, l’expédition, le fournisseur ou le travail d’exécution en dépend toujours.
Réessayez la déconnexion Runner uniquement après que l’état soit clair.

Demander de l’aide en toute sécurité

Fournissez :

le nom de l’application ;
l’état visible exact et le texte d’erreur ;
si le problème se produit lors de la connexion, du retour, de la gestion des outils ou de la déconnexion ;
l’URL du projet sans valeurs de requête secrètes ; et
une capture d’écran respectueuse de la vie privée si elle montre matériellement le problème.

Ne fournissez pas la clé API réelle, le secret, le mot de passe du fournisseur, le document d’identité, les détails de paiement, les données client ou les paramètres d’autorisation masqués.

Si l’outil souhaité est toujours absent après avoir effacé la recherche et les filtres, utilisez Demander une app (ou Demander cette app dans le résultat vide). Le formulaire demande l’assistance d’un fournisseur ; il ne le connecte pas. Pour les problèmes de connexion CJ, ouvrez Configuration du fournisseur Dropshipping.