L’assistente legge da Raynet chi gli sta scrivendo: il contatto e l’azienda, le opportunità, le offerte e gli ordini e le attività. In Raynet 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
- Raynet con il piano PROFESSIONAL o superiore – il piano START non ha chiavi API.
- Un’istanza su app.raynet.cz (il server ceco). Le istanze sui server slovacco o internazionali di Raynet (
app.raynetcrm.sk,eu.raynetcrm.com,app.raynetcrm.com) non si possono collegare. - Un amministratore di Raynet – solo lui può creare l’utente e la chiave API.
- In draften, un proprietario o gestore dell’organizzazione.
In Raynet
Raynet non ha una chiave di sola lettura: una chiave API ha sempre i diritti dell’utente a cui appartiene. Per questo crea per l’assistente un utente separato con il ruolo di sola lettura. Non dare la chiave a un amministratore – un amministratore vede e può fare tutto.
Utente di sola lettura
- In alto a destra clicca il tuo nome → Nastavení (Impostazioni).
- Nel menu a sinistra apri Uživatelské účty (Account utente) e aggiungi un utente (Přidat uživatele – Aggiungi utente; nella versione a pagamento prima Přidat další uživatelské účty – Aggiungi altri account utente – e poi Přiřadit uživatele – Assegna utente). Compila:
- il nome, per es.
draften, - l’email di accesso – annotala, a draften servirà,
- il ruolo Jen ke čtení (Sola lettura).
In Raynet ogni utente è una licenza a pagamento.
- il nome, per es.
- Se l’utente esiste già: Uživatelské účty → apri il suo profilo → Oprávnění uživatele (Autorizzazioni utente) → cambia il ruolo in Jen ke čtení e salva.
- Facoltativamente limita quali record vede l’utente: Nastavení → Bezpečnostní úrovně (Livelli di sicurezza) → Přidat úroveň (Aggiungi livello), dagli un nome e scegli l’utente.
Chiave API
- Nastavení → nel menu a sinistra, nella parte PRO VÝVOJÁŘE (Per gli sviluppatori) → API klíče (Chiavi API).
- Clicca Nový API klíč (Nuova chiave API). Nella finestra Vytvořit API klíč (Crea chiave API) compila:
- Název klíče (Nome della chiave) – per es.
draften, - Uživatel (Utente) – l’utente di sola lettura del passo precedente. La chiave leggerà con le sue autorizzazioni.
- Název klíče (Nome della chiave) – per es.
- Copia subito la chiave – dopo il salvataggio Raynet non la mostra più. Poi clicca Vytvořit API klíč.
Nome dell’istanza
In alto a destra clicca il tuo nome → O aplikaci Raynet CRM (Informazioni su Raynet CRM); lì trovi il nome dell’istanza. È anche la parte dell’indirizzo dopo app.raynet.cz/ – per l’indirizzo https://app.raynet.cz/firma è firma.
In draften
- Apri Organizzazione → Integrazioni e nel riquadro Integrazioni compila:
- Sistema – Raynet CRM,
- Nome – per es.
Raynet – vendite, - Nome dell’istanza – dal passo precedente,
- Utente (email) – l’email di accesso dell’utente di sola lettura,
- Segreto di accesso – la chiave API.
Clicca Aggiungi collegamento. La chiave viene salvata cifrata e non viene più mostrata.
- Nella riga del collegamento apri il menu ⋯ → Testa la connessione. Dopo un momento compare “Collegamento funzionante (…), account …”. Quando l’utente non può leggere qualcosa, il test lo elenca sotto “Non disponibile con questo token:”.
- 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 azienda,
- Opportunità e sotto di esse Importi,
- Offerte e ordini,
- Attività e sotto di esse Descrizione e soluzione delle attività.
- 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 sostituisci la chiave, inserisci quella nuova nel collegamento in Nuovo segreto di accesso e clicca Sostituisci; poi di nuovo Testa la connessione.
Errori del test della connessione
Il messaggio del test è in inglese, direttamente da Raynet o da draften:
| Nel messaggio | Cosa significa | Cosa fare |
|---|---|---|
the user name or the API key was refused (401) | Raynet non ha accettato l’email o la chiave | controllare che l’email sia l’email di accesso dell’utente a cui appartiene la chiave, e inserire di nuovo la chiave |
the user of the API key may not read this (403) | l’utente della chiave non può leggere | controllare il ruolo e il livello di sicurezza dell’utente |
Raynet rate limit reached (429) | esaurito il limite giornaliero di chiamate API | riprovare più tardi; il limite dipende dal piano di Raynet |
Raynet needs the instance name (letters, digits, dashes) | il nome dell’istanza manca o contiene caratteri non validi | copiare il nome dell’istanza da O aplikaci Raynet CRM |
Raynet answered HTTP … | un’altra risposta di Raynet | controllare il nome dell’istanza e riprovare |