DocumentazioneApp e integrazioni
Connetti, gestisci e ricollega un'app
Comprendi gli stati di connessione dell'app di Runner e ripara o rimuovi in modo sicuro una connessione.
Utilizza questa guida per portare un'app attraverso il suo ciclo di vita di connessione: avvia la connessione, conferma il suo stato reale, ripara l'autorizzazione quando necessario e disconnettila in modo sicuro.
Percorso di accesso: Progetto → App
Prima di iniziare
Usalo quando:
- un'app dice Connetti, Connessione in corso..., Ricollega o In attesa di revisione;
- hai bisogno di verificare se un flusso del provider precedente è davvero terminato;
- un'app Agent ha bisogno di un accesso agli strumenti diverso; o
- intendi rimuovere una connessione e hai bisogno di comprendere prima l'avviso.
Hai bisogno di accesso al progetto e di qualsiasi account, credenziale o approvazione richiesti dal provider esterno. Alcune app sono condizionali e potrebbero non apparire in ogni area di lavoro.
Leggi la scheda prima di agire
| Stato della scheda o controllo | Significato | Cosa fare |
|---|---|---|
| Indicatore di caricamento | Runner sta controllando la connessione salvata. | Attendi prima di selezionare un'altra azione. |
| Connetti | Runner non ha una connessione utilizzabile per questa app. | Apri la finestra di dialogo di configurazione o il flusso di autorizzazione del provider. |
| Connessione in corso... | Una richiesta di connessione è in corso. | Completa il flusso del provider o attendi che Runner restituisca un risultato. |
| Connesso | Runner riconosce una connessione utilizzabile. | Utilizza il suo controllo di gestione o disconnessione se hai bisogno di una modifica. |
| Gestisci | L'app Agent connessa ha strumenti configurabili. | Apri i dettagli dell'app e rivedi l'accesso agli strumenti. |
| Ricollega | L'autorizzazione è mancante, scaduta o altrimenti ha bisogno di attenzione. | Avvia di nuovo l'autorizzazione. Non presumere che la vecchia connessione funzioni ancora. |
| In attesa di revisione | Stripe ha l'account ma non l'ha reso pronto. | Segui lo stato o l'avviso di azione; l'etichetta non è un pulsante Connetti. |
| Continua l'onboarding | Stripe ha ancora bisogno di informazioni. | Continua la configurazione esistente invece di creare un altro account. |
| Elimina o Disconnetti | Una connessione può essere rimossa. | Leggi e conferma l'impatto specifico del provider. |
Completa il ciclo di vita
- Apri App e trova l'app.
- Seleziona Connetti.
- Fornisci solo i campi mostrati nella finestra di dialogo. A seconda dell'app, questo può essere un dominio del negozio, una chiave API, una chiave e un segreto, credenziali del provider o autorizzazione esterna.
- Completa il passaggio del provider, quindi torna alle app.
- Conferma che la scheda ora mostra un badge connesso o i controlli connessi del provider. Una finestra di dialogo chiusa o una finestra del provider non è prova di successo.
- Se la scheda mostra Ricollega o Continua l'onboarding, seleziona quell'azione e continua la connessione esistente.
- Per rimuovere l'app, seleziona il suo controllo di disconnessione, leggi la conferma e scegli Disconnetti o Conferma solo quando l'impatto a livello di area di lavoro indicato è accettabile.
- Riapri le app e conferma che la scheda è tornata al suo stato disconnesso.
Le app Store e le app Agent differiscono
Le app Store utilizzano controlli specifici del provider:
- Email utilizza un interruttore on/off.
- Stripe può mostrare onboarding, revisione, azione richiesta, dashboard e controlli di disconnessione.
- Shippo, CJ Dropshipping, 4PX e Shopify chiedono dati di configurazione specifici del provider e mostrano una conferma di disconnessione distruttiva.
Sicurezza della connessione
- Tratta le chiavi e i segreti del provider come password.
- Leggi se una connessione appartiene all'area di lavoro o solo al progetto corrente.
- Una finestra del provider che si completa non garantisce che Runner abbia ricevuto un risultato utilizzabile.
- Non disconnettere un provider di spedizione, pagamento, email o adempimento durante operazioni di negozio attive senza controllare l'avviso e i tuoi ordini correnti.
- Se una disconnessione non riesce, Runner mantiene lo stato corrente. Non presumere che il provider sia stato rimosso.