Problemen met app-verbindingen oplossen

Diagnose laad-, referentie-, autorisatie-, beoordelings-, opnieuw verbindings- en verbreekingsproblemen in Apps.

Gebruik deze gids wanneer een app niet laadt, verbindt, opnieuw verbindt, de gereedschapstoegang opslaat, of verbreekt zoals verwacht. Begin vanuit de status die Runner werkelijk toont in plaats van blindelings een providerflow te herhalen.

Invoerpad: Project → Apps

Voordat u begint

Bevestig dat u Apps voor het beoogde project en werkruimte hebt geopend.
Wis Apps zoeken en elk Agent Apps-categoriefiltter.
Vernieuw de pagina eenmaal en wacht tot verbindingsstatussen laden.
Lees de exacte kaartsstatus: Verbinden, Verbinden…, Verbonden, Opnieuw verbinden, In afwachting van beoordeling, of een actie-vereiste melding.
Open alleen de herstelactie die overeenkomt met die status.
Voeg nooit een API-sleutel, geheim, identiteitsdocument, betalingsdetail, of volledige provider- callback-URL in een ondersteuningsbericht of schermafbeelding op.

Belangrijke besturingselementen en resultaten

Besturingselement	Wat gebeurt er nadat u het selecteert
Zoekopdracht wissen	Verwijdert de huidige Agent Apps-zoekopdracht zodat de beschikbare catalogus opnieuw kan verschijnen.
Verbinden / Verbinden en autoriseren	Opent de instellings- of externe autorisatiestroom voor die app.
Opnieuw verbinden, wanneer weergegeven	Herstart autorisatie voor een bestaande providerverbinding.
Opnieuw proberen	Herhaalt de mislukte catalogus-, gereedschapslijst-, of verbindingsaanvraag die door het huidige paneel wordt weergegeven.
Onboarding voortzetten	Keert terug naar de bestaande Stripe-onboarding-stroom wanneer actie vereist is.
Verbreken	Opent een bevestiging of start de gedocumenteerde verwijderingsstroom; controleer de opgeslagen status voordat u providergegevens wijzigt.

Symptoom- en herstellingstabel

Wat u ziet	Waarschijnlijke betekenis	Veilige volgende actie
App ontbreekt	Zoekopdracht, een categorie, werkruimtetoegang, of een voorwaardelijke functie verbergt deze.	Wis zoekopdracht, kies Alles, en bevestig dat de functie beschikbaar is voor deze werkruimte.
Kaart blijft laden	Runner heeft de opgeslagen verbinding niet opgelost.	Vernieuw Apps eenmaal. Vermijd het indienen van een ander verbinding terwijl de status onbekend is.
Geen apps gevonden	Geen Agent App komt overeen met de huidige filters.	Selecteer Zoekopdracht wissen.
Verbinden doet niets	Een vereist veld is leeg of ongeldig, of de providerflow kon niet starten.	Lees veldfouten, kopieer de vereiste waarde opnieuw, en sta providervensters toe indien van toepassing.
Verbinden… eindigt niet	De externe autorisatie werd gesloten, geblokkeerd, of retourneerde nooit een resultaat.	Ga terug naar Apps, vernieuw de status, en gebruik Opnieuw verbinden als Runner dit aanbiedt.
Provider zegt succes maar Runner niet	Runner heeft geen bruikbare verbinding bevestigd.	Open Apps opnieuw. Behandel alleen Verbonden als succes; gebruik Opnieuw verbinden in plaats van duplicaten te maken.
Opnieuw verbinden	Bestaande autorisatie heeft aandacht nodig.	Selecteer het en voltooi de providerflow opnieuw.
In afwachting van beoordeling	Stripe controleert ingediende details.	Volg actiemededelingen; start niet zomaar een ander account om het label te verwijderen.
Stripe-acties vereist	Stripe heeft informatie nodig of heeft een mogelijkheid onderbroken.	Controleer Nu verschuldigd, Later verschuldigd, In beoordeling, betaling- en uitbetalingsmededelingen, en gebruik Onboarding voortzetten wanneer weergegeven.
API-sleutel of geheim afgewezen	De waarde is onjuist, verlopen, van het verkeerde account, of niet geaccepteerd voor deze integratie.	Kopieer het opnieuw van de provider. Bewerk geheimen niet naar giswerk.
Shopify-domein ongeldig	De waarde is niet het permanente Shopify-winkeldomein.	Gebruik `your-store.myshopify.com`, niet een aangepast winkelfront-domein.
Agent App-autorisatievenster is geblokkeerd	De browser verhinderde de externe stroom.	Sta pop-ups toe voor Runner en start Verbinden en autoriseren opnieuw.
Agent App-gereedschappen kunnen niet laden	Runner kon de gereedschapslijst van die app niet ophalen.	Selecteer Opnieuw proberen in App-details.
Gereedschapschakelaar rapporteert fout	De nieuwe gereedschapsinstelling werd niet opgeslagen.	Wacht tot de schakelaar vernieuwt, bevestig de huidige status, en probeer eenmaal opnieuw.
Verbreken rapporteert fout	Runner heeft verwijdering niet bevestigd.	Ga ervan uit dat de bestaande verbinding nog steeds actief is en open Apps opnieuw voordat u het opnieuw probeert.

Providerspecifieke controles

Stripe

Zet een bestaande onboarding-poging voort met Opnieuw verbinden of Onboarding voortzetten.
Lees actievereisten in plaats van alleen op de kaartkleur te vertrouwen.
Een gepubliceerde winkelfront kan nog steeds betalingen onderbroken of niet beschikbaar hebben.
Gebruik de Stripe-dashboardactie alleen nadat Runner een gekoppeld account heeft.

E-mail

Een mislukte schakelverstelling keert terug naar de opgeslagen status.
Een ingeschakelde schakelaar bewijst niet dat een bepaalde e-mail is bezorgd.
Controleer de winkelgebeurtenis, ontvanger, e-mailconfiguratie, en momenteel gepubliceerde versie met veilige testgegevens.

Shippo

Kopieer de Shippo API-sleutel opnieuw van het beoogde account.
Een verbonden kaart controleert geen tarieven, vervoerders, labels, of verzendingen.

Shopify

Gebruik het permanente myshopify.com-domein.
Als een werkruimte al een winkel verbonden heeft, controleert u deze voordat u verbreekt.
Herstart autorisatie wanneer de verbindingskoppeling verloopt of de geretourneerde winkel niet overeenkomt met het domein dat u hebt ingevoerd.

CJ Dropshipping

Bevestig dat de API-sleutel tot het CJ-account behoort dat u wilt gebruiken.
Na verbreking valt Runner terug op het gedeelde CJ-account, dus controleer de accountcontext voordat u toekomstige leverancieracties uitvoert.

4PX

Bevestig dat de API-sleutel en het geheim tot dezelfde account behoren en in de juiste velden staan.
Een verbonden kaart bewijst niet dat een bestemming of bestelling geschikt is voor vervulling.

Agent-apps

De hele sectie of een afzonderlijke app kan voorwaardelijk niet beschikbaar zijn.
Wis filters voordat u een app als afwezig behandelt.
Controleer gereedschapschakelaars voordat u opnieuw verbindt; verleen niet meer toegang alleen om instellingen gemakkelijker te maken.

Verbreken mislukt of produceerde een onzeker resultaat

Houd het provideraccount en huidige winkeloperaties ongewijzigd.
Open Project → Apps opnieuw en controleer de kaartsstatus.
Als deze nog steeds verbonden toont, behandel de verbinding als actief.
Verwijder providergegevens niet totdat u begrijpt of actieve afrekening, e-mail, verzending, leverancier, of vervullingwerk er nog steeds van afhangt.
Probeer de Runner-verbreking opnieuw alleen nadat de status duidelijk is.

Veilig om hulp vragen

Geef op:

de app-naam;
de exacte zichtbare status en fouttekst;
of het probleem optreedt bij verbinden, terugkeren, gereedschappen beheren, of verbreken;
de project-URL zonder geheime querywaarden; en
een privacyveilige schermafbeelding als deze het probleem materieel toont.

Geef niet de werkelijke API-sleutel, geheim, providerwachtwoord, identiteitsdocument, betalingsgegevens, klantengegevens, of verborgen autorisatieparameters op.