# HubSpot: collegamento

L’assistente legge da HubSpot chi gli sta scrivendo: il contatto e l’azienda, le
trattative e i ticket di assistenza. In HubSpot 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

- Un account HubSpot con i diritti di **super admin** (o con l’autorizzazione
  **Developer tools access**) – solo un account così può creare una chiave per
  l’API.
- In draften, un **proprietario o gestore dell’organizzazione**.

draften ha bisogno di una **chiave per l’API con sole autorizzazioni di
lettura**. Oggi HubSpot la rilascia come **service key**. Gli account più
vecchi possono avere anche un token di una **private app** (inizia con `pat-`);
continua a funzionare, solo che HubSpot non permette più di creare nuove
private app.

## In HubSpot: service key

1. Apri l’elenco delle chiavi: nel menu principale **Development** → **Keys** →
   **Service keys** (in alcuni account **Settings** → **Integrations** →
   **Service Keys**).
2. In alto a destra clicca **Create service key** e dai un nome alla chiave,
   per es. `draften`.
3. Clicca **Add new scope**. Nel pannello a destra cerca (campo **Find a
   scope**) e spunta solo queste autorizzazioni di lettura:
   - `crm.objects.contacts.read` – contatti,
   - `crm.objects.companies.read` – aziende,
   - `crm.objects.owners.read` – chi segue il contatto,
   - `crm.objects.deals.read` – trattative,
   - `crm.objects.tickets.read` – ticket.

   Non aggiungere nulla con `.write`. Una chiave può ricevere solo le
   autorizzazioni che ha il suo creatore.
4. Crea la chiave. Nella sua pagina clicca **Show** e poi **Copy**.

La chiave si può in seguito **sostituire** (**Rotate and expire now**, oppure
**Rotate and expire later** – la vecchia vale allora ancora 7 giorni). Inserisci
la nuova chiave in draften (sotto).

## In draften

1. Apri Organizzazione → **Integrazioni** e nel riquadro **Integrazioni**
   compila:
   - **Sistema** – **HubSpot**,
   - **Nome** – per es. `HubSpot – vendite e assistenza`,
   - **Segreto di accesso** – la chiave copiata.

   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 (…)”. Le autorizzazioni
   mancanti il test le elenca sotto “Non disponibile con questo token:”; quando
   la chiave ha anche autorizzazioni di scrittura, lo segnala.
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**,
   - **Trattative** e sotto di esse **Importi delle trattative**,
   - **Ticket di assistenza**, sotto di essi **Dettaglio del ticket** e **Note
     interne del ticket**.
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 HubSpot o da draften:

| Nel messaggio | Cosa significa | Cosa fare |
|---|---|---|
| `the access token was refused (401)` | HubSpot non ha accettato la chiave – un errore di battitura, oppure la chiave è stata sostituita o eliminata | inserire una chiave valida |
| `… lacks a scope for this read (403)` | alla chiave manca un’autorizzazione di lettura | aggiungere l’autorizzazione alla chiave in HubSpot |
| `HubSpot rate limit reached (429)` | esaurito il limite di chiamate API | riprovare più tardi |
| `HubSpot answered HTTP …` | un’altra risposta di HubSpot | riprovare; se persiste, sostituire la chiave |