Per gli amministratori
← Tutti gli argomenti

FLOWii: collegamento

Un utente con i permessi più ristretti e una chiave API in FLOWii, e il collegamento in draften, passo passo.

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

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.

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 messaggioCosa significaCosa fare
the login, the password or the API key was refusedFLOWii non ha accettato l’email, la password o la chiave APIcontrollare 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 connectionl’utente vede più aziendeaggiungere l’ID azienda in base all’elenco del test
the login does not reach company …l’utente non vede l’ID azienda inseritocorreggere l’ID, oppure rendere l’azienda accessibile all’utente
the login reaches no companyl’utente non vede nessuna aziendaassegnare l’utente a un’azienda
the user of the login may not read this (403)l’utente non può leggere un moduloimpostare Prohlížení per i moduli necessari
FLOWii rate limit reached (429)esaurito il limite giornaliero di chiamate APIriprovare più tardi

Versione solo testo