Risolvi i problemi di connessione delle app

Diagnostica il caricamento, le credenziali, l'autorizzazione, la revisione, la riconnessione e i problemi di disconnessione in App.

Usa questa guida quando un'app non si carica, non si connette, non si riconnette, non salva l'accesso ai suoi strumenti o non si disconnette come previsto. Inizia dallo stato che Runner mostra effettivamente piuttosto che ripetere ciecamente un flusso del provider.

Percorso di accesso: Progetto → App

Prima di iniziare

Conferma di aver aperto App per il progetto e lo spazio di lavoro previsto.
Cancella Cerca app e qualsiasi filtro della categoria App Agent.
Aggiorna la pagina una volta e attendi il caricamento degli stati di connessione.
Leggi lo stato esatto della scheda: Connetti, Connessione in corso..., Connesso, Riconnetti, In attesa di revisione o un avviso di azione richiesta.
Apri solo l'azione di recupero che corrisponde a quello stato.
Non includere mai una chiave API, un segreto, un documento di identità, un dettaglio di pagamento o un URL di callback del provider completo in un messaggio di supporto o in uno screenshot.

Controlli e risultati importanti

Controllo	Cosa succede dopo averlo selezionato
Cancella ricerca	Rimuove la ricerca corrente delle App Agent in modo che il catalogo disponibile possa apparire di nuovo.
Connetti / Connetti e autorizza	Apre il flusso di configurazione o autorizzazione esterna per quell'app.
Riconnetti, quando mostrato	Riavvia l'autorizzazione per una connessione del provider esistente.
Riprova	Ripete la richiesta del catalogo, dell'elenco degli strumenti o della connessione non riuscita mostrata dal pannello corrente.
Continua onboarding	Ritorna al flusso di onboarding Stripe esistente quando è richiesta un'azione.
Disconnetti	Apre una conferma o avvia il flusso di rimozione documentato; verifica lo stato salvato prima di modificare le credenziali dal lato del provider.

Tabella sintomi e recupero

Cosa vedi	Significato probabile	Azione successiva sicura
L'app è mancante	La ricerca, una categoria, l'accesso allo spazio di lavoro o una funzione condizionale la sta nascondendo.	Cancella la ricerca, scegli Tutto, quindi conferma che la funzione è disponibile per questo spazio di lavoro.
La scheda continua a caricarsi	Runner non ha risolto la connessione salvata.	Aggiorna App una volta. Evita di inviare un'altra connessione mentre lo stato è sconosciuto.
Nessuna app trovata	Nessuna Agent App corrisponde ai filtri correnti.	Seleziona Cancella ricerca.
Connetti non fa nulla	Un campo obbligatorio è vuoto o non valido, oppure il flusso del provider non ha potuto avviarsi.	Leggi gli errori dei campi, ricopia il valore richiesto e consenti i popup del provider se applicabile.
Connessione in corso... non finisce	L'autorizzazione esterna è stata chiusa, bloccata o non ha mai restituito un risultato.	Torna a App, aggiorna lo stato, quindi usa Riconnetti se Runner lo offre.
Il provider dice successo ma Runner no	Runner non ha confermato una connessione utilizzabile.	Riapri App. Tratta solo Connesso come successo; usa Riconnetti invece di creare duplicati.
Riconnetti	L'autorizzazione esistente ha bisogno di attenzione.	Selezionalo e completa di nuovo il flusso del provider.
In attesa di revisione	Stripe sta rivedendo i dettagli inviati.	Segui gli avvisi di azione; non avviare un altro account solo per rimuovere l'etichetta.
Azioni Stripe richieste	Stripe ha bisogno di informazioni o ha messo in pausa una capacità.	Rivedi i dettagli Dovuto ora, Dovuto dopo, In revisione, pagamento e pagamento, quindi usa Continua onboarding quando mostrato.
Chiave API o segreto rifiutato	Il valore è sbagliato, scaduto, da un account sbagliato o non accettato per questa integrazione.	Ricopia dal provider. Non modificare i segreti per congettura.
Dominio Shopify non valido	Il valore non è il dominio permanente del negozio Shopify.	Usa `your-store.myshopify.com`, non un dominio di vetrina personalizzato.
La finestra di autorizzazione di Agent App è bloccata	Il browser ha impedito il flusso esterno.	Consenti i popup per Runner e avvia di nuovo Connetti e autorizza.
Gli strumenti di Agent App non si caricano	Runner non ha potuto recuperare l'elenco degli strumenti di quell'app.	Seleziona Riprova in Dettagli app.
L'interruttore dello strumento segnala un errore	La nuova impostazione dello strumento non è stata salvata.	Attendi l'aggiornamento dell'interruttore, conferma il suo stato attuale, quindi riprova una volta.
La disconnessione segnala un errore	Runner non ha confermato la rimozione.	Presumi che la connessione esistente sia ancora attiva e riapri App prima di riprovare.

Controlli specifici del provider

Stripe

Continua un tentativo di onboarding esistente con Riconnetti o Continua onboarding.
Leggi i requisiti di azione invece di fare affidamento solo sul colore della scheda.
Una vetrina pubblicata può ancora avere pagamenti in pausa o non disponibili.
Usa l'azione del dashboard Stripe solo dopo che Runner ha un account associato.

Email

Un cambio di interruttore non riuscito ritorna allo stato salvato.
Un interruttore abilitato non prova che un'email particolare sia stata consegnata.
Verifica l'evento del negozio, il destinatario, la configurazione dell'email e la versione attualmente pubblicata con dati di test sicuri.

Shippo

Ricopia la chiave API Shippo dall'account previsto.
Una scheda connessa non verifica tariffe, vettori, etichette o creazione di spedizioni.

Shopify

Usa il dominio permanente myshopify.com.
Se uno spazio di lavoro ha già un negozio connesso, revisionalo prima di disconnetterlo.
Riavvia l'autorizzazione quando il collegamento di connessione scade o il negozio restituito non corrisponde al dominio che hai inserito.

CJ Dropshipping

Conferma che la chiave API appartiene all'account CJ che intendi utilizzare.
Dopo la disconnessione, Runner ritorna all'account CJ condiviso, quindi verifica il contesto dell'account prima di future azioni del fornitore.

4PX

Conferma che la chiave API e il segreto appartengono allo stesso account e sono nei campi corretti.
Una scheda connessa non prova che una destinazione o un ordine sia idoneo per l'evasione.

App Agent

L'intera sezione o un'app individuale può essere condizionatamente non disponibile.
Cancella i filtri prima di trattare un'app come assente.
Rivedi gli interruttori degli strumenti prima di riconnettere; non concedere più accesso solo per semplificare la configurazione.

La disconnessione non è riuscita o ha prodotto un risultato incerto

Mantieni l'account del provider e le operazioni del negozio attuale invariate.
Riapri Progetto → App e controlla lo stato della scheda.
Se mostra ancora connesso, tratta la connessione come attiva.
Non eliminare le credenziali dal lato del provider fino a quando non capisci se il checkout attivo, l'email, la spedizione, il fornitore o il lavoro di evasione dipendono ancora da esse.
Riprova la disconnessione di Runner solo dopo che lo stato è chiaro.

Chiedi aiuto in sicurezza

Fornisci:

il nome dell'app;
lo stato visibile esatto e il testo dell'errore;
se il problema si verifica durante la connessione, il ritorno, la gestione degli strumenti o la disconnessione;
l'URL del progetto senza valori di query segreti; e
uno screenshot sicuro per la privacy se mostra materialmente il problema.

Non fornire la chiave API effettiva, il segreto, la password del provider, il documento di identità, i dettagli di pagamento, i dati dei clienti o i parametri di autorizzazione nascosti.