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.
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
- Apri l’elenco delle chiavi: nel menu principale Development → Keys → Service keys (in alcuni account Settings → Integrations → Service Keys).
- In alto a destra clicca Create service key e dai un nome alla chiave, per es.
draften. - 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. - 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
- 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.
- 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.
- 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.
- 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 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 |