App-Verbindungen beheben

Diagnose von Lade-, Anmeldedaten-, Autorisierungs-, Überprüfungs-, Wiederverbindungs- und Trennungsproblemen in Apps.

Verwenden Sie diesen Leitfaden, wenn eine App nicht geladen wird, sich nicht verbindet, nicht erneut verbindet, ihren Werkzeugzugriff nicht speichert oder sich nicht wie erwartet trennt. Beginnen Sie mit dem Status, den Runner tatsächlich anzeigt, anstatt einen Anbieterablauf blind zu wiederholen.

Eingabepfad: Projekt → Apps

Bevor Sie beginnen

Prüfen Sie, ob Apps für das beabsichtigte Projekt und den richtigen Arbeitsbereich geöffnet ist.
Leeren Sie Tools suchen und alle Kategoriefilter für Agent-Apps.
Aktualisieren Sie einmal und warten Sie auf die Verbindungszustände.
Lesen Sie den genauen Kartenstatus: Verbinden, Verbindung wird hergestellt…, Verbunden, Erneut verbinden, Prüfung läuft oder einen Handlungshinweis.
Öffnen Sie nur die zu diesem Zustand passende Wiederherstellungsaktion.
Nehmen Sie keine API-Schlüssel, Geheimwerte, Ausweisdokumente, Zahlungsdaten oder vollständigen Anbieter-Callback-URLs in Supportnachrichten oder Screenshots auf.

Die Suche grenzt den Tool-Katalog ein. Leeren Sie Suche und Filter, bevor Sie eine fehlende App anfragen. Ein Suchergebnis ist keine autorisierte Verbindung.

Wichtige Steuerelemente und Ergebnisse

Steuerelement	Was passiert, nachdem Sie es ausgewählt haben
Suche löschen	Entfernt die aktuelle Agent Apps-Suche, damit der verfügbare Katalog wieder angezeigt werden kann.
Verbinden / Verbinden & Autorisieren	Öffnet den Setup- oder externen Autorisierungsablauf für diese App.
Erneut verbinden, wenn angezeigt	Startet die Autorisierung für eine vorhandene Anbieterverbindung neu.
Erneut versuchen	Wiederholt die fehlgeschlagene Katalog-, Werkzeuglisten- oder Verbindungsanfrage, die im aktuellen Bereich angezeigt wird.
Onboarding fortsetzen	Kehrt zum vorhandenen Stripe-Onboarding-Ablauf zurück, wenn eine Maßnahme erforderlich ist.
Trennen	Öffnet eine Bestätigung oder startet den dokumentierten Entfernungsablauf; überprüfen Sie den gespeicherten Status, bevor Sie Anbieter-seitige Anmeldedaten ändern.

Symptom- und Wiederherstellungstabelle

Was Sie sehen	Wahrscheinliche Bedeutung	Sichere nächste Maßnahme
App fehlt	Suche, eine Kategorie, Arbeitsbereichszugriff oder eine bedingte Funktion versteckt sie.	Löschen Sie die Suche, wählen Sie Alle, und bestätigen Sie dann, dass die Funktion für diesen Arbeitsbereich verfügbar ist.
Karte wird ständig geladen	Runner hat die gespeicherte Verbindung nicht aufgelöst.	Aktualisieren Sie Apps einmal. Vermeiden Sie das Absenden einer weiteren Verbindung, während der Status unbekannt ist.
Keine Apps gefunden	Keine Agent App entspricht den aktuellen Filtern.	Wählen Sie Suche löschen.
Verbinden funktioniert nicht	Ein erforderliches Feld ist leer oder ungültig, oder der Anbieterablauf konnte nicht gestartet werden.	Lesen Sie Feldfehler, kopieren Sie den erforderlichen Wert erneut, und erlauben Sie Anbieter-Popups, falls zutreffend.
Wird verbunden… wird nicht beendet	Die externe Autorisierung wurde geschlossen, blockiert oder hat nie ein Ergebnis zurückgegeben.	Kehren Sie zu Apps zurück, aktualisieren Sie den Status, und verwenden Sie dann Erneut verbinden, wenn Runner es anbietet.
Anbieter sagt Erfolg, aber Runner nicht	Runner hat eine verwendbare Verbindung nicht bestätigt.	Öffnen Sie Apps erneut. Behandeln Sie nur Verbunden als Erfolg; verwenden Sie Erneut verbinden, anstatt Duplikate zu erstellen.
Erneut verbinden	Vorhandene Autorisierung benötigt Aufmerksamkeit.	Wählen Sie es aus und führen Sie den Anbieterablauf erneut aus.
Überprüfung ausstehend	Stripe überprüft eingereichte Details.	Folgen Sie Aktionsbenachrichtigungen; starten Sie nicht einfach ein anderes Konto, um das Label zu entfernen.
Stripe-Maßnahmen erforderlich	Stripe benötigt Informationen oder hat eine Funktion angehalten.	Überprüfen Sie Jetzt fällig, Später fällig, Wird überprüft, Zahlungs- und Auszahlungsbenachrichtigungen, und verwenden Sie dann Onboarding fortsetzen, wenn angezeigt.
API-Schlüssel oder Geheimnis abgelehnt	Der Wert ist falsch, abgelaufen, aus dem falschen Konto oder wird für diese Integration nicht akzeptiert.	Kopieren Sie ihn erneut vom Anbieter. Bearbeiten Sie Geheimnisse nicht durch Vermutungen.
Shopify-Domäne ungültig	Der Wert ist nicht die permanente Shopify-Store-Domäne.	Verwenden Sie `your-store.myshopify.com`, nicht eine benutzerdefinierte Storefront-Domäne.
Agent App-Autorisierungsfenster ist blockiert	Der Browser hat den externen Ablauf verhindert.	Erlauben Sie Popups für Runner und starten Sie Verbinden & Autorisieren erneut.
Agent App-Werkzeuge können nicht geladen werden	Runner konnte die Werkzeugliste dieser App nicht abrufen.	Wählen Sie Erneut versuchen in App-Details.
Werkzeugschalter meldet Fehler	Die neue Werkzeugeinstellung wurde nicht gespeichert.	Warten Sie, bis sich der Schalter aktualisiert, bestätigen Sie seinen aktuellen Status, und versuchen Sie es dann einmal erneut.
Trennung meldet Fehler	Runner hat die Entfernung nicht bestätigt.	Gehen Sie davon aus, dass die vorhandene Verbindung noch aktiv ist, und öffnen Sie Apps erneut, bevor Sie es erneut versuchen.

Anbieter-spezifische Überprüfungen

Stripe

Setzen Sie einen vorhandenen Onboarding-Versuch mit Erneut verbinden oder Onboarding fortsetzen fort.
Lesen Sie Aktionsanforderungen, anstatt sich nur auf die Kartenfarbe zu verlassen.
Ein veröffentlichtes Storefront kann immer noch Zahlungen angehalten oder nicht verfügbar haben.
Verwenden Sie die Stripe-Dashboard-Aktion nur, nachdem Runner ein zugeordnetes Konto hat.

E-Mail

Ein fehlgeschlagener Schalterwechsel kehrt zum gespeicherten Zustand zurück.
Ein aktivierter Schalter beweist nicht, dass eine bestimmte E-Mail zugestellt wurde.
Prüfen Sie Store-Ereignis, Empfänger, E-Mail-Konfiguration und veröffentlichte Version mit geeigneten Testdaten.

Shippo

Kopieren Sie den Shippo API-Schlüssel erneut vom beabsichtigten Konto.
Eine verbundene Karte überprüft nicht Tarife, Spediteure, Etiketten oder Sendungserstellung.

Shopify

Verwenden Sie die permanente myshopify.com-Domain.
Prüfen Sie eine vorhandene Store-Verbindung des Arbeitsbereichs, bevor Sie sie trennen.
Starten Sie die Autorisierung erneut, wenn der Link abläuft oder der zurückgegebene Store nicht zur eingegebenen Domain passt.

CJ Dropshipping

Prüfen Sie, ob der API-Schlüssel zum vorgesehenen CJ-Konto gehört.
Nach dem Trennen bleiben vom Händler autorisierte CJ-Suche, Importe, Checkout und Lieferantenvorgänge gesperrt, bis wieder eine gültige Verbindung besteht.
Verbinden Sie dasselbe CJ-Konto erneut und prüfen Sie vorhandene Importe. Stimmen Lieferantenidentität oder Live-Daten eines Artikels nicht mehr, entfernen Sie ihn und importieren Sie ihn erneut.

4PX

Bestätigen Sie, dass der API-Schlüssel und das Geheimnis zum selben Konto gehören und sich in den richtigen Feldern befinden.
Eine verbundene Karte beweist nicht, dass ein Ziel oder eine Bestellung für die Erfüllung berechtigt ist.

Agent-Apps

Der gesamte Bereich oder einzelne Apps können bedingt nicht verfügbar sein.
Leeren Sie die Filter, bevor Sie eine App als fehlend betrachten.
Prüfen Sie vor dem erneuten Verbinden die Tool-Schalter. Gewähren Sie keinen zusätzlichen Zugriff nur für eine einfachere Einrichtung.

Trennung fehlgeschlagen oder erzeugte ein unsicheres Ergebnis

Lassen Sie Anbieterkonto und laufenden Store-Betrieb unverändert.
Öffnen Sie Projekt → Apps erneut und prüfen Sie den Kartenstatus.
Zeigt die Karte weiterhin Verbunden, behandeln Sie die Verbindung als aktiv.
Löschen Sie Anbieterzugangsdaten erst, wenn geklärt ist, ob Checkout, E-Mail, Versand, Lieferanten- oder Fulfillment-Vorgänge davon abhängen.
Wiederholen Sie das Trennen in Runner erst, wenn der Zustand eindeutig ist.

Sicher um Hilfe bitten

Bereitstellen:

den App-Namen;
den genauen sichtbaren Status und Fehlertext;
ob das Problem beim Verbinden, Zurückkehren, Verwalten von Werkzeugen oder Trennen auftritt;
die Projekt-URL ohne geheime Abfragewerte; und
einen datenschutzfreundlichen Screenshot, wenn er das Problem wesentlich zeigt.

Geben Sie nicht den tatsächlichen API-Schlüssel, das Geheimnis, das Anbieter-Passwort, das Identitätsdokument, Zahlungsdetails, Kundendaten oder versteckte Autorisierungsparameter an.

Wenn das gewünschte Tool nach dem Leeren von Suche und Filtern weiterhin fehlt, wählen Sie App anfragen oder Diese App anfragen im leeren Ergebnis. Das Formular fragt Anbieterunterstützung an; es verbindet den Anbieter nicht. Öffnen Sie für CJ-Verbindungsprobleme die Dropshipping-Lieferanteneinrichtung.