# Raynet CRM: collegamento

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](/it/admin/integrations).

## 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

1. In alto a destra clicca il tuo nome → **Nastavení** (Impostazioni).
2. 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.
3. 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.
4. 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

1. **Nastavení** → nel menu a sinistra, nella parte **PRO VÝVOJÁŘE** (Per gli
   sviluppatori) → **API klíče** (Chiavi API).
2. 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.
3. **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

1. 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.
2. 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:”.
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 azienda**,
   - **Opportunità** e sotto di esse **Importi**,
   - **Offerte e ordini**,
   - **Attività** e sotto di esse **Descrizione e soluzione delle attività**.
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 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 |