Connecter HubSpot
À quoi sert cette connexion ?
Section intitulée « À quoi sert cette connexion ? »HubSpot permet à ELChat de retrouver et mettre à jour les données CRM utiles à la relation client : contacts, opportunités, tickets, tâches, rendez-vous, notes, appels, emails et fichiers.
Ce dont vous avez besoin
Section intitulée « Ce dont vous avez besoin »ELChat demande un jeton d’accès d’application privée. Il s’agit du secret utilisé par HubSpot pour autoriser ELChat au nom de votre application privée. Exemple fictif : pat-na1-xxxxxxxxxxxxxxxxxxxxx.
Le jeton agit avec les scopes sélectionnés dans HubSpot. Il ne donne pas automatiquement accès à toutes les fonctions : chaque famille d’objets doit être autorisée.
Étape 1 — Créer l’application privée HubSpot
Section intitulée « Étape 1 — Créer l’application privée HubSpot »- Connectez-vous au compte HubSpot concerné avec les droits permettant de gérer les applications privées.
- Ouvrez Paramètres.
- Accédez à Intégrations > Applications privées.
- Créez une application privée et nommez-la
ELChat. - Dans l’onglet des scopes, accordez les droits nécessaires en lecture et écriture pour les objets que vous utiliserez : contacts, transactions, tickets, tâches/engagements, rendez-vous, notes, appels, emails et fichiers. Ajoutez la lecture des propriétaires pour l’affectation.
- Si vous utilisez l’envoi d’email, activez aussi l’accès correspondant à l’email transactionnel et vérifiez que votre abonnement HubSpot le permet.
- Créez l’application et copiez son jeton d’accès.
Information à compléter : HubSpot fait évoluer ses noms de scopes granulaires. La configuration ELChat ne fournit pas de liste figée de ces noms ; vérifiez dans HubSpot que chaque famille ci-dessus possède bien les droits lecture/écriture correspondant aux actions que vous activez.
Consultez le guide officiel des applications privées HubSpot et le catalogue des scopes.
Étape 2 — Connecter HubSpot à ELChat
Section intitulée « Étape 2 — Connecter HubSpot à ELChat »- Ouvrez Dashboard > votre site > Actions IA > Connecteurs.
- Sur la carte HubSpot, cliquez sur Connecter.
- Collez le Jeton d’application privée.
- Validez.
Étape 3 — Vérifier la connexion
Section intitulée « Étape 3 — Vérifier la connexion »La carte doit afficher Connecté. Effectuez d’abord une recherche sur un contact test connu. Contrôlez son nom et son email dans HubSpot. Testez ensuite une lecture d’opportunité ou de ticket si vous comptez utiliser ces modules.
Que peut faire ELChat avec HubSpot ?
Section intitulée « Que peut faire ELChat avec HubSpot ? »| Domaine | Capacités réellement disponibles | Type |
|---|---|---|
| Contacts | Rechercher, consulter, créer et mettre à jour un contact ; qualifier et noter un prospect ; produire un résumé | Lecture et écriture |
| Transactions | Rechercher, consulter, créer, mettre à jour et clôturer une transaction | Lecture et écriture |
| Tickets | Rechercher, consulter, créer, mettre à jour et clôturer un ticket | Lecture et écriture |
| Tâches | Lister, créer, mettre à jour et terminer une tâche | Lecture et écriture |
| Rendez-vous | Rechercher, créer et annuler un rendez-vous | Lecture et écriture |
| Activités | Ajouter/lister une note, journaliser un appel ou un email | Lecture et écriture |
| Fichiers | Charger un fichier et l’attacher à un contact | Écriture |
| Envoyer un email lorsque l’accès transactionnel du compte le permet | Écriture | |
| Support | Consulter la charge des agents, la satisfaction et les statistiques de premier temps de réponse | Lecture |
ELChat n’implémente pas la création de listes marketing, l’envoi de campagnes marketing complètes ni l’administration du portail HubSpot.
Limitations
Section intitulée « Limitations »- Les données accessibles dépendent des scopes, du rôle de l’application privée et de l’abonnement HubSpot.
- Les statistiques de premier temps de réponse nécessitent, d’après le contrôle présent dans ELChat, Service Hub Professional ou Enterprise.
- Certaines propriétés personnalisées peuvent ne pas être retournées si elles ne sont pas demandées par l’outil ELChat.
- Une clôture, un envoi d’email ou une affectation peut être refusé par les règles du portail.
Reconnecter ou déconnecter
Section intitulée « Reconnecter ou déconnecter »Pour remplacer un jeton, créez-en un nouveau dans HubSpot, reconnectez la carte et testez une recherche. Révoquez ensuite l’ancien jeton. Le bouton Désactiver arrête l’utilisation dans ELChat ; supprimez ou faites tourner le jeton dans HubSpot pour une révocation complète.
Problèmes fréquents
Section intitulée « Problèmes fréquents »Fonction disponible mais accès refusé
Section intitulée « Fonction disponible mais accès refusé »Le scope de l’objet manque. Ouvrez l’application privée HubSpot, ajoutez les droits de lecture ou d’écriture nécessaires, puis recréez ou faites tourner le jeton si HubSpot l’exige.
Contact, ticket ou transaction introuvable
Section intitulée « Contact, ticket ou transaction introuvable »Vérifiez que la donnée appartient au portail connecté, qu’elle n’est pas archivée et que l’application privée a accès à cet objet.
Envoi d’email impossible
Section intitulée « Envoi d’email impossible »Contrôlez l’abonnement HubSpot, le domaine expéditeur, les droits d’email transactionnel et la conformité du destinataire.
Statistiques de support indisponibles
Section intitulée « Statistiques de support indisponibles »Vérifiez l’édition Service Hub et l’existence des propriétés attendues dans le portail.
Sécurité
Section intitulée « Sécurité »Le jeton d’application privée peut accéder à des données personnelles. Créez une application dédiée à ELChat, limitez ses scopes, conservez son jeton hors des conversations et révoquez-le dès qu’il n’est plus utilisé.