L’assistant lit dans HubSpot qui lui écrit : le contact et l’entreprise, les affaires et les tickets de support. Il n’écrit jamais dans HubSpot. Ce qu’il peut lire exactement, vous le définissez pour chaque boîte mail séparément. Le fonctionnement général des connexions dans draften est décrit sur la page Intégrations.
Ce dont vous avez besoin
- Un compte HubSpot avec les droits super admin (ou avec l’autorisation Developer tools access) – seul un tel compte peut créer une clé pour l’API.
- Dans draften, un propriétaire ou un gestionnaire de l’organisation.
draften a besoin d’une clé pour l’API avec uniquement des champs d’application en lecture. HubSpot la délivre aujourd’hui sous la forme d’une service key. Les comptes plus anciens peuvent aussi avoir le jeton d’une private app d’avant (il commence par pat-) ; il continue de fonctionner, mais HubSpot ne permet plus de créer de nouvelles private apps.
Dans HubSpot : service key
- Ouvrez la liste des clés : dans le menu principal, Development → Keys → Service keys (dans certains comptes, Settings → Integrations → Service Keys).
- En haut à droite, cliquez sur Create service key et nommez la clé, par exemple
draften. - Cliquez sur Add new scope. Dans le panneau de droite, recherchez (champ Find a scope) et cochez uniquement ces champs d’application en lecture :
crm.objects.contacts.read– les contacts,crm.objects.companies.read– les entreprises,crm.objects.owners.read– qui s’occupe du contact,crm.objects.deals.read– les affaires,crm.objects.tickets.read– les tickets.
N’ajoutez rien qui contient
.write. Une clé ne peut recevoir que les autorisations dont dispose son créateur. - Créez la clé. Sur sa page, cliquez sur Show, puis sur Copy.
La clé peut plus tard être remplacée (Rotate and expire now, ou Rotate and expire later – l’ancienne reste alors valable encore 7 jours). Saisissez la nouvelle clé dans draften (voir ci-dessous).
Dans draften
- Ouvrez Organisation → Intégrations et, dans la carte Intégrations, renseignez :
- Système – HubSpot,
- Nom – par exemple
HubSpot – ventes et support, - Secret d’accès – la clé copiée.
Cliquez sur Ajouter une connexion. La clé est stockée chiffrée et n’est plus jamais affichée.
- Dans la ligne de la connexion, ouvrez le menu ⋯ → Tester la connexion. Au bout d’un instant s’affiche « Connexion opérationnelle (…) ». Le test liste les champs d’application manquants sous « Non disponible avec ce jeton : » ; si la clé comporte aussi des champs d’application en écriture, il le signale.
- Dans la partie Quelles boîtes mail peuvent utiliser la connexion, cliquez sur Accorder à côté d’une boîte mail, cochez ce que l’assistant peut lire, puis cliquez sur Enregistrer l’accès :
- Contact et entreprise,
- Affaires et, en dessous, Montants des affaires,
- Tickets de support et, en dessous, Détail du ticket et Notes internes d’un ticket.
- L’éditeur de l’assistant ajoute ensuite, dans Paramètres de l’assistant → Connaissances, une source de type système externe et choisit ce que l’assistant lit réellement – voir Connecter un CRM et d’autres systèmes.
Lorsque vous remplacez la clé, saisissez la nouvelle dans le champ Nouveau secret d’accès de la connexion et cliquez sur Remplacer ; puis relancez Tester la connexion.
Erreurs du test de connexion
Le message du test est en anglais ; il vient directement de HubSpot ou de draften :
| Dans le message | Ce que cela signifie | Que faire |
|---|---|---|
the access token was refused (401) | HubSpot n’a pas accepté la clé – faute de frappe, ou la clé a été remplacée ou supprimée | saisir une clé valide |
… lacks a scope for this read (403) | il manque à la clé un champ d’application en lecture | ajouter le champ d’application à la clé dans HubSpot |
HubSpot rate limit reached (429) | la limite d’appels API est atteinte | réessayer plus tard |
HubSpot answered HTTP … | une autre réponse de HubSpot | réessayer ; si cela persiste, remplacer la clé |