DokumentationApps & Integrationen
App verbinden, verwalten und erneut verbinden
Verstehen Sie die Verbindungszustände von Runner-Apps und reparieren oder entfernen Sie eine Verbindung sicher.
Verwenden Sie diese Anleitung, um eine App durch ihren Verbindungslebenszyklus zu führen: Starten Sie die Verbindung, bestätigen Sie ihren tatsächlichen Zustand, reparieren Sie die Autorisierung bei Bedarf und trennen Sie sie sicher.
Eingabepfad: Projekt → Apps
Bevor Sie beginnen
Verwenden Sie es, wenn:
- eine App Verbinden, Verbindung wird hergestellt..., Erneut verbinden oder Überprüfung ausstehend anzeigt;
- Sie überprüfen müssen, ob ein vorheriger Anbieterablauf wirklich abgeschlossen wurde;
- eine Agent-App anderen Werkzeugzugriff benötigt; oder
- Sie beabsichtigen, eine Verbindung zu entfernen und die Warnung zuerst verstehen müssen.
Sie benötigen Zugriff auf das Projekt und alle Konten, Anmeldedaten oder Genehmigungen, die vom external provider angefordert werden. Einige Apps sind bedingt und erscheinen möglicherweise nicht in jedem Workspace.
Lesen Sie die Karte vor dem Handeln
| Kartenzustand oder Steuerelement | Bedeutung | Was zu tun ist |
|---|---|---|
| Ladeanzeige | Runner überprüft die gespeicherte Verbindung. | Warten Sie, bevor Sie eine andere Aktion auswählen. |
| Verbinden | Runner hat keine verwendbare Verbindung für diese App. | Öffnen Sie den Setup-Dialog oder den Anbieter-Autorisierungsablauf. |
| Verbindung wird hergestellt... | Eine Verbindungsanfrage ist in Bearbeitung. | Beenden Sie den Anbieterablauf oder warten Sie auf ein Ergebnis von Runner. |
| Verbunden | Runner erkennt eine verwendbare Verbindung. | Verwenden Sie sein Verwaltungs- oder Trennungssteuerelement, wenn Sie eine Änderung benötigen. |
| Verwalten | Die verbundene Agent-App hat konfigurierbare Werkzeuge. | Öffnen Sie die App-Details und überprüfen Sie den Werkzeugzugriff. |
| Erneut verbinden | Autorisierung fehlt, ist abgelaufen oder benötigt anderweitig Aufmerksamkeit. | Starten Sie die Autorisierung erneut. Nehmen Sie nicht an, dass die alte Verbindung noch funktioniert. |
| Überprüfung ausstehend | Stripe hat das Konto, hat es aber noch nicht bereit gemacht. | Folgen Sie dem Status oder der Aktionsmitteilung; das Label ist keine Connect-Schaltfläche. |
| Onboarding fortsetzen | Stripe benötigt noch Informationen. | Setzen Sie das vorhandene Setup fort, anstatt ein anderes Konto zu erstellen. |
| Löschen oder Trennen | Eine Verbindung kann entfernt werden. | Lesen und bestätigen Sie die anbieterspezifische Auswirkung. |
Schließen Sie den Lebenszyklus ab
- Öffnen Sie Apps und suchen Sie die App.
- Wählen Sie Verbinden.
- Geben Sie nur die im Dialog angezeigten Felder ein. Je nach App kann dies eine Shop- Domain, ein API-Schlüssel, ein Schlüssel und Geheimnis, Anbieteranmeldedaten oder externe Autorisierung sein.
- Schließen Sie den Anbieter-Schritt ab und kehren Sie dann zu Apps zurück.
- Bestätigen Sie, dass die Karte jetzt ein verbundenes Badge oder die verbundenen Steuerelemente des Anbieters anzeigt. Ein geschlossener Dialog oder ein geschlossenes Anbieter-Fenster ist kein Erfolgsbeweis.
- Wenn die Karte Erneut verbinden oder Onboarding fortsetzen anzeigt, wählen Sie diese Aktion aus und setzen Sie die vorhandene Verbindung fort.
- Um die App zu entfernen, wählen Sie ihr Trennungssteuerelement, lesen Sie die Bestätigung und wählen Sie Trennen oder Bestätigen nur, wenn die angegebene Workspace-weite Auswirkung akzeptabel ist.
- Öffnen Sie Apps erneut und bestätigen Sie, dass die Karte in ihren getrennten Zustand zurückgekehrt ist.
Store Apps und Agent Apps unterscheiden sich
Store Apps verwenden anbieterspezifische Steuerelemente:
- E-Mail verwendet einen Ein-/Aus-Schalter.
- Stripe kann Onboarding-, Überprüfungs-, Aktionserfordernis-, Dashboard- und Trennungssteuerelemente anzeigen.
- Shippo, CJ Dropshipping, 4PX und Shopify fordern anbieterspezifische Setup- Daten an und zeigen eine destruktive Trennungsbestätigung.
Verbindungssicherheit
- Behandeln Sie Anbieter-Schlüssel und Geheimnisse wie Passwörter.
- Lesen Sie, ob eine Verbindung zum Workspace oder nur zum aktuellen Projekt gehört.
- Ein abgeschlossenes Anbieter-Fenster garantiert nicht, dass Runner ein verwendbares Ergebnis erhalten hat.
- Trennen Sie keinen Versand-, Zahlungs-, E-Mail- oder Fulfillment-Anbieter während aktiver Store-Operationen, ohne die Warnung und Ihre aktuellen Bestellungen zu überprüfen.
- Wenn eine Trennung fehlschlägt, behält Runner den aktuellen Zustand bei. Nehmen Sie nicht an, dass der Anbieter entfernt wurde.