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.
Gli screenshot e le registrazioni mostrano l’interfaccia in inglese.
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
- Controlla di aver aperto App per il progetto e lo spazio di lavoro desiderati.
- Svuota Cerca strumenti e rimuovi i filtri di categoria delle app dell’Agente.
- Aggiorna la pagina una volta e attendi il caricamento degli stati.
- Leggi lo stato esatto: Collega, Connessione in corso…, Collegato, Riconnetti, In revisione o un avviso di azione richiesta.
- Apri solo l’azione di recupero adatta a quello stato.
- Non includere chiavi API, segreti, documenti d’identità, dati di pagamento o URL completi di callback del fornitore in messaggi all’assistenza o screenshot.
Le annotazioni in inglese indicano i controlli. Seleziona l’immagine per ingrandirla.
La ricerca restringe il catalogo. Se manca uno strumento, svuota ricerca e filtri prima di richiedere un’app; un risultato non è una connessione autorizzata.
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.
- 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, ricerche, importazioni, checkout e operazioni CJ future con il tuo account commerciante restano bloccati finché non ripristini una connessione valida.
- Riconnetti lo stesso account CJ e controlla le importazioni esistenti. Se l’identità del fornitore o i dati in tempo reale di un articolo non corrispondono più, rimuovilo e importalo di nuovo.
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.
Se lo strumento resta assente dopo aver rimosso ricerca e filtri, usa Richiedi un’app (o Richiedi questa app nel risultato vuoto). Il modulo richiede il supporto di un fornitore, non lo collega. Per problemi CJ, apri Configurazione fornitori Dropshipping.