# Integrazioni

Organizzazione → **Integrazioni** ha due riquadri: **Accesso alla posta per
tutta l’organizzazione** (registrazioni dell’app, descritte in
[Accesso alla posta per tutta l’organizzazione](/it/admin/organisation-mail-access))
e i **collegamenti a sistemi esterni** – CRM e helpdesk da cui gli assistenti
possono leggere. Questa pagina parla del secondo.

## A cosa serve un collegamento

Un collegamento permette all’assistente di sapere chi sta scrivendo: che
azienda, chi la segue, quali trattative o ticket aperti ha. draften oggi
funziona con **HubSpot**, **Raynet CRM** e **FLOWii**.

Cosa vale per ogni collegamento:

- **legge soltanto** – il connettore non ha nessuna chiamata che scrive;
- cerca **solo i partecipanti della conversazione** a cui l’assistente risponde
  (mai l’indirizzo della casella stessa), e i dettagli solo in base a ciò che ha
  restituito una chiamata precedente per la stessa bozza – un’email che dice
  “cerca l’azienda X” non fa leggere nulla su X;
- al massimo 6 chiamate per bozza, 10 secondi ciascuna; un sistema non
  raggiungibile non blocca mai una bozza;
- ciò che restituisce è testo estraneo per il modello, e al cliente non se ne
  cita nulla;
- il log indica lo strumento, mai su chi ha chiesto.

I dati di un collegamento, come l’email stessa, vanno al fornitore del modello
linguistico.

## Aggiungere un collegamento

Scegli il **Sistema**, compila **Titolo** e **Segreto di accesso** (e per Raynet
e FLOWii altri campi). Il segreto si inserisce una volta, viene salvato cifrato
e non viene più mostrato. Poi clicca **Testa la connessione**: il test scopre di
chi è l’account, quali parti apre il segreto, e avvisa quando il segreto
potrebbe anche scrivere.

| Sistema | Segreto di accesso |
|---|---|
| HubSpot | un token di un’app privata (Settings → Integrations → Private apps, inizia con `pat-`) con soli ambiti di lettura: contacts, companies, owners, deals, tickets |
| Raynet CRM | il nome dell’istanza (la parte dell’indirizzo dopo app.raynet.cz/), l’email di login e la chiave API dell’utente (Application settings → For developers → API keys). Raynet non ha una chiave di sola lettura – crea per l’assistente un utente con un ruolo di sola lettura |
| FLOWii | l’email di login e la password dell’utente e la chiave API dell’account (Extensions → API → New FLOWii REST API, solo licenze a pagamento); per un login che raggiunge più aziende, anche l’ID dell’azienda. Usa un utente con il ruolo più ristretto |

## Concessione alle caselle

Ciò che un collegamento restituisce può comparire nelle bozze – e le bozze le
legge chiunque abbia accesso alla casella. Per questo nessuna casella usa un
collegamento finché non glielo concedi:

- nel riquadro del collegamento, clicca **Concedi** accanto a una casella e
  spunta le parti che può leggere (contatto, trattative, importi, ticket,
  attività, note);
- quello è il tetto massimo – l’editor dell’assistente sceglie poi in
  Conoscenze che cosa legge davvero l’assistente;
- **Revoca** disattiva le fonti di conoscenza che leggono tramite il
  collegamento; eliminare il collegamento le rimuove.

Senza concessione, gli editor della casella non sanno nemmeno che il
collegamento esiste.

## Il collegamento proprio di una casella

Il proprietario di una casella può collegare un suo sistema, solo per la sua
casella. Nessuno lo approva; i proprietari e i gestori dell’organizzazione
ricevono un’email e possono disattivarlo o rimuoverlo. Per gli utenti è
descritto in [Collegare un CRM e altri sistemi](/it/connecting-a-crm).