# FLOWii: collegamento

L’assistente legge da FLOWii chi gli sta scrivendo: il contatto e il partner, le
opportunità, gli ordini e gli eventi e le attività. In FLOWii non scrive mai.
Cosa può leggere esattamente lo stabilisci per ogni casella separatamente. Come
funziona in generale un collegamento in draften lo descrive la pagina
[Integrazioni](/it/admin/integrations).

## Cosa ti serve

- FLOWii con una **licenza a pagamento** – la licenza FREE non ha l’API.
- Un **amministratore di FLOWii** – solo lui può impostare i diritti di accesso
  di un utente.
- In draften, un **proprietario o gestore dell’organizzazione**.

## In FLOWii

Tramite l’API, FLOWii accede con **l’email e la password di un utente** e in più
con una chiave API. draften quindi ha bisogno della password dell’utente – per
questo crea per l’assistente un **utente separato con i diritti più ristretti
possibile**, non l’account di una persona.

### Utente con i diritti più ristretti

1. Apri **Firma** (Azienda) → **Uživatelé** (Utenti) → **Nový uživatel** (Nuovo
   utente). Compila nome, cognome ed email di accesso – annotala, a draften
   servirà.
2. Apri il nuovo utente → scheda **Přístupová práva** (Diritti di accesso). Per
   i moduli che l’assistente deve leggere scegli **Prohlížení**
   (Visualizzazione), per tutti gli altri **Zakázaný** (Vietato):
   - **Partneři** (Partner) – contatto e partner,
   - **Obchodní případy** (Opportunità),
   - **Zakázky** (Ordini),
   - **Události** (Eventi) e **Úlohy** (Attività).
3. L’utente deve essere attivo e avere una password impostata. Lo attiva
   l’amministratore; la password l’utente la imposta al primo accesso. In
   FLOWii ogni utente è una licenza a pagamento.

Gli stessi diritti puoi salvarli come profilo e riusarli: la rotella
dell’ingranaggio nel menu in alto → **Nastavení** (Impostazioni) →
**Přístupová práva** → **Profily** (Profili) → **Nový profil** (Nuovo
profilo); nell’utente lo scegli poi nel campo **Profil** (Profilo).

### Chiave API

La rotella dell’ingranaggio nel menu in alto → **Nastavení** → **Rozšíření**
(Estensioni) → **API** → **FLOWii REST API**. Compare **API klíč** (Chiave API) –
copia la chiave.

### ID azienda

Solo quando l’accesso dell’utente raggiunge più aziende. Non devi cercare l’ID:
il test della connessione in draften elenca le aziende insieme ai loro ID.

## In draften

1. Apri Organizzazione → **Integrazioni** e nel riquadro **Integrazioni**
   compila:
   - **Sistema** – **FLOWii**,
   - **Nome** – per es. `FLOWii – vendite`,
   - **Email di accesso dell’utente** – l’email dell’utente del passo
     precedente,
   - **ID azienda (facoltativo)** – vuoto se l’utente vede una sola azienda,
   - **La password dell’utente** e **Chiave API**.

   Clicca **Aggiungi collegamento**. La password e la chiave vengono salvate
   cifrate e non vengono più mostrate.
2. Nella riga del collegamento apri il menu **⋯** → **Testa la connessione**.
   Dopo un momento compare “Collegamento funzionante (…), account …” con il
   nome dell’azienda. Quando l’utente vede più aziende, il test scrive
   “L’accesso raggiunge queste aziende – inserisci l’ID di quella giusta in
   “ID azienda””; aggiungi l’ID e ripeti il test. I moduli che l’utente non può
   leggere il test li elenca sotto “Non disponibile con questo token:” (i nomi
   dei moduli sono in slovacco, come li restituisce FLOWii).
3. Nella parte **Quali caselle possono usare il collegamento** clicca
   **Concedi** accanto alla casella, spunta ciò che l’assistente può leggere e
   clicca **Salva la concessione**:
   - **Contatto e partner**,
   - **Opportunità** e sotto di esse **Ricavi previsti**,
   - **Ordini**,
   - **Eventi e attività** e sotto di essi **Note degli eventi**.
4. L’editor dell’assistente poi, nelle Impostazioni dell’assistente →
   **Conoscenze**, aggiunge una fonte di tipo **sistema esterno** e sceglie cosa
   legge davvero l’assistente – vedi
   [Collegare un CRM e altri sistemi](/it/connecting-a-crm).

**Quando la password dell’utente cambia**, il collegamento smette di
funzionare. Inserisci la nuova password nel collegamento nei campi sotto
**Nuovo segreto di accesso** (password e chiave API) e clicca **Sostituisci**;
poi di nuovo **Testa la connessione**.

## Errori del test della connessione

Il messaggio del test è in inglese, direttamente da FLOWii o da draften:

| Nel messaggio | Cosa significa | Cosa fare |
|---|---|---|
| `the login, the password or the API key was refused` | FLOWii non ha accettato l’email, la password o la chiave API | controllare tutti e tre i dati; l’utente deve essere attivo e la licenza a pagamento |
| `the login reaches N companies - set the company's id on the connection` | l’utente vede più aziende | aggiungere l’**ID azienda** in base all’elenco del test |
| `the login does not reach company …` | l’utente non vede l’ID azienda inserito | correggere l’ID, oppure rendere l’azienda accessibile all’utente |
| `the login reaches no company` | l’utente non vede nessuna azienda | assegnare l’utente a un’azienda |
| `the user of the login may not read this (403)` | l’utente non può leggere un modulo | impostare **Prohlížení** per i moduli necessari |
| `FLOWii rate limit reached (429)` | esaurito il limite giornaliero di chiamate API | riprovare più tardi |