# Connessione di app esterne ai tuoi Agents

Source: https://support.kapsulehost.com/it-it/agents-connections

Connections ti permettono a un esperto di Kapsule Agents di lavorare all'interno di app che usi già, con il tuo permesso, e sono completamente separate da quello che un esperto può fare sul tuo account KapsuleHost.

## Che cos'è una Connection

Una connection è un collegamento firmato tra uno dei tuoi esperti e un'app esterna. Una volta collegata, quell'esperto può usare gli strumenti dell'app in una conversazione: leggere un documento, redigere un messaggio, controllare un record. Senza una connection, l'esperto non ha alcun accesso.

Due cose vale la pena di essere precisi:

- Una connection concede accesso a **quell'app**, non al tuo account KapsuleHost. I due insiemi di autorizzazioni non si mescolano mai.
- Qualsiasi cosa che **cambi** qualcosa nell'app collegata passa comunque attraverso la stessa scheda di conferma di una modifica sul tuo account KapsuleHost. La lettura è immediata; la scrittura chiede prima il permesso.

> **Note:** Le connections si trovano in **Agents**, poi **Gestisci Connessioni**, oppure vai direttamente a `/agents/connections`. La home page di Agents mostra anche una scheda Connections con alcuni esempi di app.

## Quali Esperti Possono Usare Quali App

L'elenco è deliberatamente conservatore, e ogni esperto vede solo le app di cui ha bisogno per il suo lavoro. Alcuni sono limitati a strumenti di sola lettura anche quando l'app stessa può fare di più:

| Esperto | App esterne che può raggiungere |
|---|---|
| Mara, Business Advisor | Stripe (sola lettura) |
| Thea, Creative Writer | Notion |
| Sef, SEO Consultant | GitHub (sola lettura) |
| Mila, Marketing Planner | Gmail, Slack, Notion, Google Calendar |
| Iris, Customer Comms | Gmail, Slack |
| Ash, Sales and Outreach | Gmail, Slack, Stripe (sola lettura) |
| Pip, Policy and Docs | Nessuna |

Collegare un'app non la mette a disposizione dell'intero team. Diventa disponibile solo per gli esperti nella riga sopra.

![Il catalogo Connections in Kapsule Agents](https://support.kapsulehost.com/help/screenshots/agents-connections.26935fcd.webp)

## Collegare un'App

1. Apri **Agents**, poi **Gestisci Connessioni**.
2. Sfoglia la scheda **Popular**, passa a **Tutte le app**, oppure digita nella casella di ricerca. Ogni scheda mostra il nome dell'app e quanti strumenti espone.
3. Fai clic su **Connect** sull'app che desideri. Il pulsante diventa **Opening...** mentre viene preparata la finestra di accesso.
4. Accedi all'app stessa e approva l'accesso che ti chiede.
5. Torni sulla pagina Connections con una conferma **[app] Connected**.

Una volta collegata, la scheda mostra una pillola **Connected**, l'etichetta dell'account a cui hai effettuato l'accesso, e quando la connection è stata utilizzata l'ultima volta, oppure **Non ancora utilizzato**.

## Stati della Connection

| Stato | Che cosa significa | Che cosa fare |
|---|---|---|
| Connected | Funzionante. I tuoi esperti possono usarla. | Niente |
| Pending | L'accesso è stato avviato ma non è mai stato completato. | Fai clic su **Completa la connessione** |
| Reconnect Needed | L'accesso è scaduto o è stato revocato da parte dell'app. | Fai clic su **Riconnetti** |

Lo stato **Riconnessione Necessaria** è normale nel tempo: la maggior parte delle app fa scadere l'accesso che concedono secondo una pianificazione. La riconnessione lo ripristina senza perdere nulla.

## Come Rimane Sicuro

La pagina Connections espone il modello di sicurezza in tre righe, ed è utile comprenderlo piuttosto che scorrerlo rapidamente:

- **Gestito da un partner certificato.** L'accesso a un'app è gestito dal nostro partner di integrazione certificato, che detiene l'autorizzazione. La tua password dell'app non tocca mai KapsuleHost.
- **Conferma prima dell'azione.** Agents chiede prima di agire. Qualsiasi cosa che cambi qualcosa ha bisogno del tuo consenso.
- **Revoca istantanea.** Disconnettere taglia l'accesso subito, sia qui che nell'app.

> **Warning:** Tratta una connection come una chiave che hai fatto fare per qualcuno. Collega gli account in cui vuoi che i tuoi esperti lavorino, non ogni account che possiedi. Se non sei sicuro se un esperto ha bisogno di un'app per fare il lavoro che hai in mente, non collegarla: chiedi prima, poi collega.

## Disconnettere un'App

1. Apri **Agents**, poi **Gestisci Connessioni**.
2. Fai clic su **Disconnect** sull'app collegata.
3. Appare una conferma: *Il tuo team perde l'accesso a [app] subito. Qualsiasi cosa l'abbia già utilizzato rimane nelle tue chat passate.*
4. Fai clic su **Disconnect** per confermare.

L'accesso termina immediatamente. Quello che questo **non** fa è cancellare il contenuto dell'app dalle conversazioni che hai già avuto: se un esperto ha citato un documento in una chat la scorsa settimana, quel testo è ancora nella trascrizione della chat. Disconnettere riguarda l'accesso futuro, non l'eliminazione retroattiva.

## Quando Connections Non è Disponibile sul Tuo Account

Se la pagina Connections mostra una singola scheda calma che legge **Le connessioni non sono ancora disponibili**, il collegamento delle app esterne non è stato attivato per il tuo account. La scheda è esplicita nel dire che niente è collegato e niente ha accesso, che è esattamente la verità in questo stato. I tuoi esperti lavorano ancora; semplicemente non riescono a raggiungere fuori da KapsuleHost.

Il resto di Agents non è influenzato. Le chat, le [Skills](https://support.kapsulehost.com/it-it/agents-skills) e le letture dell'account funzionano tutte normalmente.

## Che Cosa Fare Se Fallisce

**"L'autorizzazione non è stata concessa, quindi niente è stato collegato."** Hai annullato o rifiutato nella schermata di approvazione dell'app stessa. Niente è stato creato. Fai clic su **Connect** di nuovo e approva l'accesso.

**"Le connessioni non sono disponibili in questo momento. Riprova tra un momento."** Il servizio di integrazione non ha potuto essere raggiunto. Questo è deliberatamente fail-closed: piuttosto che mostrare un elenco semi-costruito, la pagina non mostra nulla. Aspetta un minuto e ricarica.

**"Le connessioni non potevano essere caricate."** Le tue impostazioni sono sicure. Aggiorna la pagina. Se persiste, [apri un ticket di supporto](https://support.kapsulehost.com/it-it/opening-a-support-ticket).

**Un esperto dice che non riesce a raggiungere un'app collegata.** Controlla la tabella sopra. Non ogni esperto è autorizzato a usare ogni app, e un'app collegata per Iris non è automaticamente disponibile per Mara.

**Una connection rimane in Pending.** La finestra di accesso è stata chiusa prima che finisse. Fai clic su **Completa la connessione** e completala.

## Cosa Costano le Connections

Usare un'app collegata in una conversazione è misurato come qualsiasi altro lavoro. Ogni chiamata che un esperto fa a un'app esterna viene addebitata al peso della connection-call, che è una frazione di quello che costa un lungo pezzo di scrittura. Le letture sul tuo account KapsuleHost rimangono gratuite. La ponderazione completa è in [Come Funzionano i Crediti dell'Agent](https://support.kapsulehost.com/it-it/agents-credits).

## Argomenti Correlati

- [Panoramica degli Agenti Kapsule](https://support.kapsulehost.com/it-it/agents-overview)
- [Iniziare con gli Agenti Kapsule](https://support.kapsulehost.com/it-it/agents-getting-started)
- [Utilizzo delle Agent Skills](https://support.kapsulehost.com/it-it/agents-skills)