Risoluzione dei problemi di Integrazione

Se un'Integrazione non si connette, smette di funzionare o non riesce a completare un'attività, usa questa guida per controllare la connessione, l'accesso all'account e la risorsa selezionata.

Questa pagina copre i problemi comuni di connessione e autorizzazione in Atoms. Per la configurazione specifica del servizio, le azioni supportate o la configurazione all'interno della tua app, inizia da Connettere e gestire le Integrazioni e scegli la guida del tuo servizio.

Inizia con questi controlli

1. Controlla dove si verifica l'errore. L'Agente non riesce a usare un servizio in Chat, oppure la funzionalità non riesce solo nella tua app? Connettere un servizio per Chat non conferma di per sé che la tua app sia configurata correttamente. Per errori solo nell'app, vedi Connettere e gestire le Integrazioni.
2. Apri l'Integrazione. Nella Chat del tuo progetto, apri il menu delle opzioni accanto al campo di input del messaggio, poi scegli Connectors → Add connectors. Cerca e seleziona il servizio. Controlla se è connesso o se mostra ancora Connect. Alcuni servizi aprono la propria schermata di gestione.
3. Controlla l'accesso nel servizio stesso. Conferma che l'account che intendevi connettere possa aprire esattamente il file, repository, calendario, proprietà o altra risorsa coinvolta.
4. Salva l'errore prima di modificare qualsiasi cosa. Registra il messaggio esatto, l'ora e il fuso orario, il progetto o la Chat interessati e l'ultimo tentativo riuscito. Oscura le informazioni private negli screenshot.

Apri le opzioni di input della Chat, scegli Connectors (1), poi Add connectors (2) per esplorare le Integrazioni disponibili.

Puoi anche gestire le connessioni disponibili in Settings → Connectors. Seleziona l'Integrazione che vuoi controllare.

Mantieni private le credenziali. Non incollare mai password, codici di accesso, chiavi API, token di accesso o altri segreti in Chat o in una richiesta di supporto. Inserisci le credenziali solo nel flusso di accesso del servizio o nel campo di configurazione sicuro designato.

Trova il tuo problema

Non riesci a trovare o avviare un'Integrazione

1. Usa Add connectors per cercare nel catalogo. L'elenco più breve nel menu Chat non è il catalogo completo.
2. Se Atoms dice che la funzionalità è disponibile solo all'interno di un progetto, apri il progetto previsto e prova lì.
3. Se un controllo è disabilitato, leggi la sua spiegazione. Se richiede un ruolo o un'autorizzazione diversi, chiedi aiuto al proprietario del progetto o dello spazio di lavoro. Non disconnettere un altro servizio solo per aggirare una restrizione.

Controlla il risultato: Puoi aprire la schermata di connessione o gestione del servizio. Se ancora non appare, controlla Connettere e gestire le Integrazioni o contatta il supporto per confermarne la disponibilità. Non presumere che un servizio mancante possa essere abilitato tramite ripetuti tentativi di accesso.

L'autorizzazione non si completa

1. Seleziona Connect una sola volta e cerca la finestra di accesso del servizio. Se il tuo browser segnala un pop-up bloccato, consenti i pop-up per il sito Atoms e riprova. In Chrome, segui le istruzioni per consentire i pop-up da un sito specifico; non è necessario abilitarli per ogni sito.
2. Scegli l'account previsto e controlla l'accesso richiesto. Completa il flusso di autorizzazione del servizio prima di chiudere la sua finestra.
3. Se il servizio dice esplicitamente che la tua organizzazione ha bloccato l'app o l'accesso richiesto, salva il messaggio e contatta il tuo amministratore. Non aggirare la policy della tua organizzazione.
4. Torna in Atoms e riapri l'Integrazione per controllarne lo stato. Chiudere una finestra di accesso non conferma che l'autorizzazione sia riuscita.

Controlla l'accesso richiesto prima di completare l'autorizzazione. Autorizzare un account non conferma di per sé che la risorsa prevista sia connessa.

Se l'autorizzazione include un selettore di organizzazione o spazio di lavoro, conferma la selezione prevista e controlla le autorizzazioni richieste.

Controlla il risultato: L'Integrazione viene mostrata come connessa. Nelle schermate di dettaglio dei connettori che usano il layout standard, Connect viene sostituito da Disconnect e Try it out. Altri servizi hanno layout propri. Se mostra ancora Connect o un errore, acquisisci quel risultato e contatta il supporto dopo un nuovo tentativo.

È connesso l'account sbagliato

Se la schermata di gestione dell'Integrazione mostra un account, confrontalo con l'account che possiede o può accedere alla risorsa. Non tutti i connettori mostrano l'account connesso, quindi non usare solo l'accesso corrente del browser come prova di quale account Atoms stia usando.

Apri direttamente la risorsa nel servizio con l'account previsto. Se quell'account non può accedervi, chiedi prima l'accesso al proprietario della risorsa. Se la connessione usa l'account sbagliato, segui le istruzioni del servizio per cambiare account oppure riconnetti in modo sicuro e scegli esplicitamente l'account corretto durante l'autorizzazione.

Controlla il risultato: Una piccola richiesta di lettura supportata restituisce la risorsa prevista. Se ancora non riesci a stabilire quale account è connesso, contatta il supporto invece di disconnettere ripetutamente.

L'Integrazione è connessa, ma l'Agente non riesce a trovare i tuoi dati

1. Controlla la connessione. Apri i dettagli dell'Integrazione in Connectors e conferma che sia connessa. Controlla l'account o la risorsa selezionati dove mostrati.
2. Controlla la risorsa esatta. Aprila direttamente nel servizio con l'account previsto. Conferma la sua posizione e le autorizzazioni di accesso, inclusi organizzazione, spazio di lavoro, cartella o proprietà corretti, dove rilevante.
3. Rendi specifica la richiesta. Indica il servizio e fornisci il nome esatto o il link della risorsa quando il connettore lo supporta. Chiedi prima una sola azione di lettura supportata, invece di cercare e modificare più risorse contemporaneamente.

Per esempio, se il connettore supporta la lettura di documenti: “Usa [service] per leggere [document name or link] e dimmi il suo titolo. Non modificarlo.”

Controlla il risultato: L'Agente restituisce la risorsa prevista. Se l'accesso diretto funziona ma l'Agente ancora non riesce a leggerla, controlla le funzionalità supportate dal connettore e l'accesso concesso. Riconnetti solo se ci sono prove di un problema di autorizzazione.

L'Agente può leggere i dati, ma non può modificarli

Una lettura riuscita non conferma che il connettore supporti la modifica richiesta o abbia l'autorizzazione per eseguirla.

1. Vedi Connettere e gestire le Integrazioni o l'elenco What you can do del connettore, se mostrato. Conferma che l'azione richiesta sia supportata.
2. Controlla se all'account connesso è consentito apportare quella modifica alla risorsa esatta. Chiedi al proprietario della risorsa o all'amministratore solo l'accesso necessario.
3. Leggi eventuali errori o richieste di conferma. Se è richiesta un'autorizzazione aggiuntiva, segui il flusso documentato del servizio. Riconnettere non può aggiungere un'azione che il connettore non supporta.

Prima di riprovare una scrittura: Controlla la destinazione per vedere se il primo tentativo ha già creato o modificato qualcosa. Una risposta di errore non basta a dimostrare che non sia avvenuta alcuna modifica. Non ripetere un pagamento, un messaggio, un invito o la creazione di un record finché non conosci il risultato precedente.

Controlla il risultato: Una modifica supportata riesce su una risorsa di test appropriata e la confermi direttamente nel servizio. Per i pagamenti o altri flussi di lavoro live, usa le istruzioni di test specifiche del servizio invece di una transazione reale.

Una connessione che prima funzionava si è interrotta

Controlla cosa è cambiato dall'ultima richiesta riuscita: l'account, il suo accesso alla risorsa, la policy dell'organizzazione per le app o l'autorizzazione della connessione.

1. Riapri l'Integrazione in Atoms e controlla se è ancora connessa.
2. Prova ad aprire direttamente la risorsa nel servizio. Se l'accesso è stato rimosso, risolvi il problema con il proprietario della risorsa o l'amministratore.
3. Se l'errore dice che l'autorizzazione è scaduta, è stata revocata o non è valida, segui Riconnetti in modo sicuro. Se l'errore riguarda un'interruzione del servizio, un limite o un'azione non supportata, affronta prima quella causa.

Controlla il risultato: Una piccola richiesta di lettura funziona di nuovo. Se lo stesso errore rimane, salvalo insieme all'ora dell'ultimo successo e contatta il supporto.

I risultati non sono aggiornati o una richiesta continua a non riuscire

1. Confronta il risultato con il servizio stesso. Conferma l'account, la risorsa, l'intervallo di date, i filtri e il fuso orario, dove rilevante. Chiedi all'Agente di recuperare il valore corrente invece di fare affidamento su una risposta precedente nella conversazione.
2. Per un timeout esplicito o un errore di servizio non disponibile, controlla la pagina ufficiale di stato o di supporto del servizio. Se l'errore indica un momento per riprovare, aspetta fino ad allora; non inviare richieste ripetute mentre il limite o l'interruzione persistono.
3. Salva qualsiasi testo non inviato, aggiorna Atoms e ricontrolla lo stato del connettore. Aggiornare la pagina non equivale a riautorizzare l'account.
4. Riprova una piccola richiesta di lettura. Prima di riprovare qualsiasi operazione che modifichi dati esterni, controlla la destinazione per il risultato precedente.

Controlla il risultato: Il nuovo risultato corrisponde alla risorsa prevista nel servizio. Se rimane errato, invia al supporto i valori attesi e quelli effettivi con i timestamp. Non presumere che ogni Integrazione si aggiorni con la stessa frequenza.

Riconnetti in modo sicuro

Riconnetti quando l'autorizzazione non è valida o è collegato l'account sbagliato, non come primo passaggio per ogni richiesta non riuscita.

Prima di disconnettere: Completa o metti in pausa le attività che dipendono dalla connessione, controlla il risultato di qualsiasi scrittura esterna in sospeso e assicurati di poter accedere di nuovo con l'accesso richiesto. Disconnettere rende la connessione non disponibile finché non viene collegata di nuovo. Controlla Connettere e gestire le Integrazioni per eventuali effetti aggiuntivi; non presumere che disconnettere annulli modifiche precedenti o cancelli lavori già inviati.

1. Apri i dettagli della connessione del servizio. Se ha una propria schermata di gestione account, segui le istruzioni di quell'Integrazione.
2. Nella schermata standard dei dettagli del connettore, seleziona Disconnect quando sei pronto, poi seleziona Connect. Non presumere che ci sarà una conferma aggiuntiva prima della disconnessione.
3. Scegli l'account previsto e completa l'autorizzazione. Controlla le autorizzazioni richieste.
4. Torna in Atoms e conferma lo stato connesso.
5. Esegui il controllo di ripristino qui sotto prima di riprendere l'attività originale.

Se lo stesso errore si ripresenta, smetti di riconnettere e contatta il supporto con l'errore e i controlli già completati.

Verifica che il problema sia risolto

1. Chiedi una sola azione supportata in sola lettura su una risorsa che puoi verificare direttamente. Se usi Try it out, controlla il prompt suggerito prima di inviarlo.
2. Confronta la risposta con il servizio stesso. Conferma la risorsa corretta, il contesto dell'account e il risultato richiesto, non solo l'indicatore di connessione.
3. Se la tua attività richiede modifiche, usa una risorsa di test appropriata o il flusso di test documentato del servizio e verifica il risultato nella destinazione.

Controlla lo stato della connessione e la risorsa selezionata. Un indicatore di connessione da solo non conferma che i dati previsti siano disponibili o aggiornati.

Conferma l'organizzazione e il progetto, poi apri Dashboard per controllare la risorsa senza apportare modifiche. Disconnettere non fa parte di questo controllo.

Se il controllo va a buon fine, riprendi la tua attività. Se Chat funziona ma la funzionalità continua a non riuscire nella tua app, vedi Connettere e gestire le Integrazioni o risoluzione dei problemi di build e anteprima. Controlla l'ambiente in cui si verifica l'errore; una richiesta Chat riuscita non dimostra che l'app sia configurata correttamente.

Ottieni aiuto

Se il problema persiste, usa Ottieni supporto e includi:

• Il nome dell'Integrazione e l'email del tuo account Atoms.
• Il progetto o il link della Chat interessati, e se l'errore si verifica in Chat o nella tua app. Per un'app, identifica l'ambiente interessato.
• L'account di servizio e la risorsa previsti, usando solo identificatori non segreti necessari per l'indagine.
• L'errore esatto, la data, l'ora e il fuso orario; includi l'ora dell'ultimo successo se nota.
• I passaggi per riprodurre il problema, il risultato atteso, il risultato effettivo e i controlli già provati.
• Il tuo browser e dispositivo, oltre a screenshot oscurati o una breve registrazione se utile.

Per una scrittura non riuscita, indica se la destinazione mostra una modifica completata, nessuna modifica o un risultato sconosciuto. Rimuovi password, codici di accesso, chiavi API, token e dati privati non correlati da tutti gli allegati.