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

Bestätigen Sie, dass Sie Apps für das beabsichtigte Projekt und den Arbeitsbereich geöffnet haben.
Löschen Sie Apps durchsuchen und alle Agent Apps-Kategoriefilter.
Aktualisieren Sie die Seite einmal und warten Sie, bis die Verbindungsstatus geladen werden.
Lesen Sie den genauen Kartenstatus: Verbinden, Wird verbunden..., Verbunden, Erneut verbinden, Überprüfung ausstehend oder eine Maßnahme erforderlich-Benachrichtigung.
Öffnen Sie nur die Wiederherstellungsmaßnahme, die diesem Status entspricht.
Fügen Sie niemals einen API-Schlüssel, ein Geheimnis, ein Identitätsdokument, Zahlungsdetails oder eine vollständige Anbieter-Callback-URL in eine Support-Nachricht oder einen Screenshot ein.

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

Eine fehlgeschlagene Schalteränderung kehrt zum gespeicherten Status zurück.
Ein aktivierter Schalter beweist nicht, dass eine bestimmte E-Mail zugestellt wurde.
Überprüfen Sie das Store-Ereignis, den Empfänger, die E-Mail-Konfiguration und die aktuell veröffentlichte Version mit sicheren 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-Domäne.
Wenn ein Arbeitsbereich bereits einen Store verbunden hat, überprüfen Sie ihn, bevor Sie die Verbindung trennen.
Starten Sie die Autorisierung neu, wenn der Verbindungslink abläuft oder der zurückgegebene Store nicht der eingegebenen Domäne entspricht.

CJ Dropshipping

Bestätigen Sie, dass der API-Schlüssel zum CJ-Konto gehört, das Sie verwenden möchten.
Nach dem Trennen fällt Runner auf das gemeinsame CJ-Konto zurück, daher überprüfen Sie den Kontokontext vor zukünftigen Lieferantenmaßnahmen.

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 eine einzelne App kann bedingt nicht verfügbar sein.
Löschen Sie Filter, bevor Sie eine App als fehlend behandeln.
Überprüfen Sie Werkzeugschalter, bevor Sie erneut verbinden; gewähren Sie nicht einfach mehr Zugriff, um das Setup zu vereinfachen.

Trennung fehlgeschlagen oder erzeugte ein unsicheres Ergebnis

Halten Sie das Anbieter-Konto und die aktuellen Store-Operationen unverändert.
Öffnen Sie Projekt → Apps erneut und überprüfen Sie den Kartenstatus.
Wenn es immer noch verbunden angezeigt wird, behandeln Sie die Verbindung als aktiv.
Löschen Sie Anbieter-seitige Anmeldedaten nicht, bis Sie verstehen, ob aktive Kasse, E-Mail, Versand, Lieferant oder Erfüllung noch davon abhängt.
Versuchen Sie die Runner-Trennung nur erneut, nachdem der Status klar 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.