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.
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
- Apri Firma (Azienda) → Uživatelé (Utenti) → Nový uživatel (Nuovo utente). Compila nome, cognome ed email di accesso – annotala, a draften servirà.
- 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à).
- 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
- 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.
- 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).
- 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.
- 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.
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 |