---
title: Dépanner les connexions d'application
description: 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 → Applications**

## Avant de commencer

1. Confirmez que vous avez ouvert Applications pour le projet et l'espace de travail prévus.
2. Effacez **Rechercher des applications** et tout filtre de catégorie Apps Agent.
3. Actualisez la page une fois et attendez que les états de connexion se chargent.
4. Lisez l'état exact de la carte : **Connecter**, **Connexion en cours...**, **Connecté**, **Reconnecter**,
   **Examen en attente** ou un avis d'action requise.
5. Ouvrez uniquement l'action de récupération qui correspond à cet état.
6. Ne jamais inclure une clé API, un secret, un document d'identité, un détail de paiement ou une URL de rappel de fournisseur complète dans un message d'assistance ou une capture d'écran.

## 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 **Tous**, 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 attente** | 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 **À faire maintenant**, **À faire plus tard**, **En examen**, 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'application**. |
| 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, Runner revient au compte CJ partagé, donc vérifiez le contexte du compte avant les futures actions de fournisseur.

### 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

1. Gardez le compte du fournisseur et les opérations du magasin actuelles inchangés.
2. Rouvrez **Projet → Applications** et vérifiez l'état de la carte.
3. S'il affiche toujours connecté, traitez la connexion comme active.
4. 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.
5. 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.

## Guides connexes

- [Aperçu des applications et intégrations](../apps-and-integrations)
- [Connecter, gérer et reconnecter une application](./connect-manage-reconnect)
- [Connecter et contrôler les Apps Agent](./agent-apps)