---
title: Risolvi i problemi di connessione delle app
description: 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

1. Conferma di aver aperto App per il progetto e lo spazio di lavoro previsto.
2. Cancella **Cerca app** e qualsiasi filtro della categoria App Agent.
3. Aggiorna la pagina una volta e attendi il caricamento degli stati di connessione.
4. Leggi lo stato esatto della scheda: **Connetti**, **Connessione in corso...**, **Connesso**, **Riconnetti**, **In attesa di revisione** o un avviso di azione richiesta.
5. Apri solo l'azione di recupero che corrisponde a quello stato.
6. 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

1. Mantieni l'account del provider e le operazioni del negozio attuale invariate.
2. Riapri **Progetto → App** e controlla lo stato della scheda.
3. Se mostra ancora connesso, tratta la connessione come attiva.
4. 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.
5. 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.

## Guide correlate

- [Panoramica di app e integrazioni](../apps-and-integrations)
- [Connetti, gestisci e riconnetti un'app](./connect-manage-reconnect)
- [Connetti e controlla le App Agent](./agent-apps)