Guide de l’app HubSpot
OOMOL vous permet de connecter HubSpot une seule fois, puis de rendre des outils HubSpot CRM autorisés disponibles aux agents IA et aux Skills réutilisables que vous utilisez déjà. Ce guide explique comment ajouter l’app HubSpot, quelles permissions OOMOL utilise, ce que vous pouvez faire avec elle, comment résoudre les problèmes courants et comment supprimer l’app.
Prérequis
- Un compte OOMOL.
- Un compte HubSpot que vous êtes autorisé à connecter à des apps tierces.
- Accès à OOMOL Console sur https://console.oomol.com/.
- Permission dans HubSpot d’autoriser des apps avec les scopes d’objets CRM et de schémas CRM.
- Des fiches de test de contact, entreprise et transaction si vous voulez essayer les outils de recherche, lecture ou mise à jour.
- Si votre organisation HubSpot restreint les apps tierces, votre administrateur HubSpot peut devoir autoriser l’app OOMOL avant que vous puissiez l’autoriser.
Ajouter l’app
- Connectez-vous à OOMOL Console.
- Ouvrez Connectables ou allez directement dans Connections.
- Recherchez HubSpot.
- Sélectionnez HubSpot, puis choisissez Connect.
- OOMOL vous redirige vers HubSpot. Connectez-vous à HubSpot si cela vous est demandé.
- Vérifiez l’écran d’autorisation HubSpot, y compris les permissions CRM demandées.
- Sélectionnez le compte HubSpot que vous voulez connecter.
- Sélectionnez Connect app ou l’action d’autorisation équivalente affichée par HubSpot.
- Après le retour de HubSpot vers OOMOL, confirmez que HubSpot apparaît comme connecté dans vos connexions OOMOL.
Si une étape échoue, consultez Dépannage.
Après l’autorisation, OOMOL stocke la connexion nécessaire pour appeler les outils HubSpot en votre nom. Vous pouvez ensuite utiliser les outils HubSpot depuis les agents pris en charge par OOMOL, les Skills réutilisables et les workflows.
Utilisation
Les outils HubSpot sont disponibles uniquement après la connexion d’un compte HubSpot. La liste exacte des outils affichés dans OOMOL peut changer lorsque le connecteur est mis à jour, mais le connecteur HubSpot actuel prend en charge la lecture des définitions de propriétés CRM ainsi que la recherche, la lecture, la création et la mise à jour de contacts, entreprises et transactions.
Utiliser les outils HubSpot avec oo-cli
Pour rendre les outils HubSpot connectés disponibles dans un environnement d’agent IA pris en charge, installez et configurez oo-cli après vous être connecté à OOMOL.
- Connectez-vous à OOMOL Console.
- Ouvrez la page d’installation de oo-cli.
- Suivez les instructions de cette page. Elle fournit un prompt copiable en un clic pour installer et configurer
oo-clidans un environnement d’agent IA pris en charge. - Une fois
oo-cliconfiguré et HubSpot connecté dans OOMOL, demandez à l’agent d’utiliser les outils HubSpot CRM connectés avec des données CRM de démonstration.
Le prompt exact dépend de l’environnement. Vous pouvez par exemple demander à l’agent de créer un contact de démonstration, de rechercher ce contact par e-mail, de mettre à jour un champ modifiable comme le poste, ou de lister les propriétés HubSpot CRM.
Permissions utilisées
OOMOL utilise ces scopes HubSpot pour permettre à un utilisateur HubSpot autorisé de connecter HubSpot comme App dans OOMOL, puis de rendre les outils CRM approuvés disponibles aux agents et aux Skills réutilisables.
Scopes requis :
| Scope HubSpot | Utilisé par | Pourquoi OOMOL l’utilise |
|---|---|---|
oauth | Connexion OAuth HubSpot | Terminer le flux d’autorisation OAuth HubSpot et maintenir la connexion HubSpot autorisée dans OOMOL. |
crm.objects.contacts.read | Search Contacts, Get Contact | Rechercher et lire les fiches de contacts HubSpot quand un utilisateur ou une action d’agent approuvée demande des informations de contact. |
crm.objects.contacts.write | Create Contact, Update Contact | Créer ou mettre à jour des fiches de contacts HubSpot quand un utilisateur ou une action d’agent approuvée fournit les détails de contact requis. |
crm.objects.companies.read | Search Companies, Get Company | Rechercher et lire les fiches d’entreprises HubSpot quand un utilisateur ou une action d’agent approuvée demande des informations d’entreprise. |
crm.objects.companies.write | Create Company, Update Company | Créer ou mettre à jour des fiches d’entreprises HubSpot quand un utilisateur ou une action d’agent approuvée fournit les détails requis. |
crm.objects.deals.read | Search Deals, Get Deal | Rechercher et lire les transactions HubSpot quand un utilisateur ou une action d’agent approuvée demande des informations de transaction. |
crm.objects.deals.write | Create Deal, Update Deal | Créer ou mettre à jour des transactions HubSpot quand un utilisateur ou une action d’agent approuvée fournit les détails requis. |
crm.schemas.contacts.read | List Properties, Get Property | Lire les définitions de propriétés de contacts pour que les outils utilisent des champs de contact HubSpot valides. |
crm.schemas.companies.read | List Properties, Get Property | Lire les définitions de propriétés d’entreprises pour que les outils utilisent des champs d’entreprise HubSpot valides. |
crm.schemas.deals.read | List Properties, Get Property | Lire les définitions de propriétés de transactions pour que les outils utilisent des champs de transaction HubSpot valides. |
Outils HubSpot pris en charge
| Outil | Fonction prise en charge | Cas d’utilisation courant | Prérequis |
|---|---|---|---|
| List Properties | Lister les définitions de propriétés pour contacts, entreprises ou transactions. | Permettre à un agent de comprendre quels champs CRM sont disponibles avant de créer des filtres, des fiches ou des mises à jour. | HubSpot est connecté dans OOMOL et le compte connecté a accès aux schémas de propriétés CRM. |
| Get Property | Lire une définition de propriété, par exemple la propriété email des contacts. | Vérifier un champ CRM précis avant de l’utiliser dans une recherche, création ou mise à jour. | HubSpot est connecté dans OOMOL et la propriété demandée existe. |
| Search Contacts | Rechercher des contacts avec mots-clés, filtres, tri et champs de retour sélectionnés. | Trouver la bonne personne avant un appel, un transfert, une tâche de support ou un suivi. | HubSpot est connecté dans OOMOL et le compte connecté peut lire les contacts. |
| Get Contact | Lire un contact par ID de fiche HubSpot ou propriété unique personnalisée. | Insérer les détails d’un contact dans un workflow d’agent avant l’étape suivante. | HubSpot est connecté dans OOMOL et le contact demandé est disponible pour le compte connecté. |
| Create Contact | Créer un contact avec les propriétés fournies et des associations facultatives. | Enregistrer un nouveau prospect, client ou interlocuteur à partir des informations données à l’agent. | HubSpot est connecté dans OOMOL et l’utilisateur fournit les détails de contact requis. |
| Update Contact | Mettre à jour des propriétés de contact par ID de fiche ou propriété unique personnalisée. | Garder une fiche de contact à jour après un appel, un e-mail, une recherche ou une étape de workflow. | HubSpot est connecté dans OOMOL, le contact peut être localisé et l’utilisateur a approuvé les détails mis à jour. |
| Search Companies | Rechercher des entreprises avec mots-clés, filtres, tri et champs de retour sélectionnés. | Trouver des informations de compte avant une recherche, une prospection ou un suivi. | HubSpot est connecté dans OOMOL et le compte connecté peut lire les entreprises. |
| Get Company | Lire une entreprise par ID de fiche HubSpot ou propriété unique personnalisée. | Insérer les détails d’un compte dans un workflow d’agent avant de créer des notes, plans ou mises à jour. | HubSpot est connecté dans OOMOL et l’entreprise demandée est disponible pour le compte connecté. |
| Create Company | Créer une entreprise avec les propriétés fournies et des associations facultatives. | Ajouter un nouveau compte à partir d’informations d’entreprise fournies par l’utilisateur. | HubSpot est connecté dans OOMOL et l’utilisateur fournit les détails d’entreprise requis. |
| Update Company | Mettre à jour des propriétés d’entreprise par ID de fiche ou propriété unique personnalisée. | Garder les détails d’un compte à jour après une recherche, une action commerciale ou une revue opérationnelle. | HubSpot est connecté dans OOMOL, l’entreprise peut être localisée et l’utilisateur a approuvé les détails mis à jour. |
| Search Deals | Rechercher des transactions avec mots-clés, filtres, tri et champs de retour sélectionnés. | Trouver la bonne opportunité avant une revue de pipeline, une prévision ou un suivi. | HubSpot est connecté dans OOMOL et le compte connecté peut lire les transactions. |
| Get Deal | Lire une transaction par ID de fiche HubSpot ou propriété unique personnalisée. | Insérer les détails d’une opportunité dans un workflow d’agent avant de la résumer ou de la mettre à jour. | HubSpot est connecté dans OOMOL et la transaction demandée est disponible pour le compte connecté. |
| Create Deal | Créer une transaction avec les propriétés fournies et des associations facultatives. | Ajouter une nouvelle opportunité à partir d’informations commerciales fournies par l’utilisateur. | HubSpot est connecté dans OOMOL et l’utilisateur fournit les détails de transaction requis. |
| Update Deal | Mettre à jour des propriétés de transaction par ID de fiche ou propriété unique personnalisée. | Garder le pipeline à jour après une interaction client ou une revue interne. | HubSpot est connecté dans OOMOL, la transaction peut être localisée et l’utilisateur a approuvé les détails mis à jour. |
Rechercher et lire des fiches CRM
Cas d’utilisation : permettre à un agent de trouver le bon contact, la bonne entreprise ou la bonne transaction HubSpot avant un appel, un transfert, une recherche ou un suivi.
Prérequis :
- HubSpot est connecté dans OOMOL.
- Le compte HubSpot connecté a la permission de lire l’objet CRM demandé.
- L’agent ou le workflow dispose d’un mot-clé de recherche, filtre, ID de fiche ou valeur de propriété unique.
Ce que font les outils :
- Rechercher ou lire les contacts, entreprises et transactions disponibles pour le compte HubSpot connecté.
- Retourner les champs HubSpot demandés par l’entrée de l’outil lorsqu’ils sont disponibles.
- Ne pas créer, mettre à jour ni supprimer de fiches pendant les actions en lecture seule.
Créer des fiches CRM
Cas d’utilisation : permettre à un agent de créer un contact, une entreprise ou une transaction HubSpot à partir d’informations fournies par l’utilisateur, par exemple un nouveau client, compte ou opportunité.
Prérequis :
- HubSpot est connecté dans OOMOL.
- Le compte HubSpot connecté a la permission de créer l’objet CRM demandé.
- L’agent ou le workflow dispose des propriétés requises pour la nouvelle fiche.
- Si des associations sont incluses, les fiches liées doivent être valides et disponibles pour le compte connecté.
Ce que font les outils :
- Créer un contact, une entreprise ou une transaction HubSpot à partir des entrées fournies.
- Retourner les informations de fiche rendues disponibles par HubSpot, par exemple l’ID de fiche et les propriétés sélectionnées.
- Ne pas inventer de valeurs CRM manquantes. Les valeurs requises doivent être fournies par l’utilisateur, le workflow ou la source de données connectée.
Mettre à jour des fiches CRM
Cas d’utilisation : permettre à un agent de garder les fiches HubSpot à jour quand un utilisateur demande de modifier un champ de contact, d’entreprise ou de transaction.
Prérequis :
- HubSpot est connecté dans OOMOL.
- Le compte HubSpot connecté a la permission de mettre à jour l’objet CRM demandé.
- L’agent ou le workflow peut localiser la fiche cible par ID HubSpot ou propriété unique personnalisée.
- Les valeurs mises à jour sont valides pour les définitions de propriétés HubSpot.
Ce que font les outils :
- Mettre à jour les propriétés HubSpot prises en charge pour les contacts, entreprises ou transactions à partir des entrées fournies.
- Retourner le résultat de mise à jour rendu disponible par HubSpot.
- Ne pas supprimer de fiches.
Tester l’app
Vous pouvez tester l’app HubSpot avec tout compte HubSpot que vous êtes autorisé à connecter. Utilisez des contacts, entreprises et transactions de démonstration afin de tester en sécurité les actions de recherche, création et mise à jour.
Prompts de test
- Crée un contact HubSpot nommé
Demo Contactavec l’e-maildemo-contact@example.com. - Recherche les contacts HubSpot pour
demo-contact@example.com. - Récupère le contact HubSpot avec l’e-mail
demo-contact@example.com. - Mets à jour le contact HubSpot avec l’e-mail
demo-contact@example.comet définis le poste surDemo Buyer. - Recherche les entreprises HubSpot pour
Demo Company. - Crée une entreprise HubSpot nommée
Demo Company. - Recherche les transactions HubSpot pour
Demo Deal. - Crée une transaction HubSpot nommée
Demo Dealavec des valeurs de test. - Mets à jour le montant ou la date de clôture de
Demo Deal. - Liste les propriétés de contact HubSpot.
- Récupère la définition de propriété de contact HubSpot pour
email.
Utilisez uniquement des données de démonstration pendant les tests. N’utilisez pas de données client réelles dans les prompts de test.
Dépannage
Je ne peux pas ajouter l’app HubSpot
- Vérifiez que vous êtes connecté au bon compte OOMOL.
- Vérifiez que vous vous connectez au compte HubSpot que vous voulez relier.
- Confirmez que le compte HubSpot autorise les scopes CRM demandés.
- Si le compte HubSpot appartient à une organisation, demandez à un administrateur HubSpot si les apps tierces nécessitent une approbation.
- Essayez de déconnecter toute connexion HubSpot échouée ou partielle dans OOMOL, puis reconnectez-la.
- Si le problème continue, contactez le support OOMOL et incluez l’e-mail du compte OOMOL, le compte HubSpot ou l’ID de portail, l’heure de la tentative et tout message d’erreur ou capture d’écran.
Un outil HubSpot ne trouve pas une fiche
- Confirmez que le compte HubSpot connecté a accès au contact, à l’entreprise ou à la transaction demandée.
- Confirmez que le workflow utilise le bon ID de fiche, la bonne propriété unique, le bon mot-clé de recherche ou le bon filtre.
- Vérifiez que la fiche existe dans le compte HubSpot connecté à OOMOL.
- Si vous avez récemment modifié les permissions HubSpot, reconnectez HubSpot dans OOMOL afin de rafraîchir l’état d’autorisation.
Un outil HubSpot ne peut pas créer une fiche
- Confirmez que le compte HubSpot connecté peut créer le contact, l’entreprise ou la transaction directement dans HubSpot.
- Vérifiez que toutes les propriétés HubSpot requises sont incluses.
- Vérifiez que les valeurs fournies sont valides pour les définitions de propriétés HubSpot.
- Si des associations sont incluses, confirmez que les fiches associées et les types d’association sont valides.
Un outil HubSpot ne peut pas mettre à jour une fiche
- Confirmez que le compte HubSpot connecté a la permission de mettre à jour la fiche demandée.
- Confirmez que le workflow utilise le bon ID de fiche HubSpot ou la bonne propriété unique personnalisée.
- Vérifiez que les champs et valeurs mis à jour sont valides pour HubSpot.
- Si une propriété est en lecture seule ou restreinte dans HubSpot, retirez-la de la demande de mise à jour ou mettez-la à jour directement dans HubSpot.
Supprimer l’app
Vous pouvez supprimer l’app HubSpot depuis OOMOL ou HubSpot. Nous recommandons de la supprimer des deux endroits si vous ne voulez plus qu’OOMOL accède à HubSpot.
Supprimer HubSpot d’OOMOL
- Connectez-vous à OOMOL Console.
- Ouvrez Connections.
- Trouvez HubSpot dans vos apps connectées.
- Ouvrez les détails de connexion HubSpot.
- Choisissez Disconnect, Remove ou l’action de suppression équivalente affichée dans OOMOL.
- Confirmez la suppression.
Supprimer OOMOL de HubSpot
- Connectez-vous à HubSpot.
- Ouvrez Settings.
- Ouvrez Integrations, puis Connected Apps.
- Trouvez OOMOL.
- Choisissez l’action permettant de désinstaller, déconnecter ou supprimer l’app.
- Confirmez la suppression.
Ce qui se passe après la suppression
- OOMOL ne peut plus utiliser les outils HubSpot pour votre compte après la suppression ou la désautorisation de la connexion HubSpot.
- Les workflows, agents ou Skills qui dépendent de HubSpot peuvent échouer jusqu’à ce que vous reconnectiez HubSpot.
- Les fiches HubSpot créées ou mises à jour avant la suppression restent dans HubSpot sauf si vous les modifiez ou supprimez dans HubSpot.
- Supprimer l’app ne supprime pas votre compte OOMOL.
Traitement des données
OOMOL accède aux données HubSpot uniquement après qu’un utilisateur HubSpot a autorisé l’app et qu’un utilisateur ou une action d’agent approuvée a besoin de HubSpot. OOMOL utilise les données HubSpot uniquement pour fournir les outils HubSpot demandés via les agents pris en charge par OOMOL, les Skills réutilisables et les workflows.
- Les tokens OAuth HubSpot sont stockés chiffrés.
- Les tokens OAuth HubSpot ne sont pas exposés aux agents IA, prompts, fichiers de projet ou utilisateurs finaux.
- OOMOL peut traiter les métadonnées de contacts, entreprises, transactions et propriétés CRM HubSpot lorsqu’un outil HubSpot est appelé.
- Les données HubSpot peuvent être stockées uniquement si nécessaire dans les résultats d’outils visibles par l’utilisateur, les journaux d’utilisation, l’historique d’exécution ou les enregistrements opérationnels.
- Les données stockées sont chiffrées au repos et transmises via TLS/SSL.
- OOMOL ne vend pas vos données HubSpot.
- OOMOL n’utilise pas vos données HubSpot pour la publicité.
- OOMOL n’utilise pas le contenu client privé pour entraîner des modèles IA.
- Lorsque vous supprimez ou désautorisez l’app HubSpot, OOMOL cesse d’utiliser l’autorisation HubSpot révoquée. OOMOL supprime ou invalide les tokens d’autorisation HubSpot stockés selon son processus normal de suppression de connexion.
- Certains journaux, enregistrements de support, enregistrements de sécurité ou enregistrements liés à la facturation peuvent être conservés comme décrit dans la politique de confidentialité.
FAQ
OOMOL synchronise-t-il les données HubSpot en continu ?
Non. OOMOL ne synchronise pas et ne réplique pas les données HubSpot en arrière-plan en continu. Les données HubSpot sont consultées lorsqu’un utilisateur autorisé ou une action d’agent approuvée appelle un outil HubSpot.
Un agent peut-il utiliser HubSpot automatiquement après la connexion ?
Connecter HubSpot rend les outils HubSpot disponibles dans OOMOL, mais leur utilisation dépend toujours de l’agent, du workflow, du Skill et des permissions que vous choisissez. Les services basés sur des comptes exigent toujours votre autorisation.
OOMOL peut-il supprimer des fiches HubSpot ?
Le connecteur HubSpot actuel décrit dans ce guide prend en charge la recherche, la lecture, la création et la mise à jour de contacts, entreprises et transactions. Il n’inclut pas d’outil de suppression de fiche.
Puis-je connecter plusieurs comptes HubSpot ?
Utilisez OOMOL Console pour vérifier les options de connexion actuellement disponibles pour votre compte ou espace de travail. Si vous avez besoin d’aide avec plusieurs comptes HubSpot, contactez le support.
Ai-je besoin d’un compte HubSpot payant ?
La plupart des outils HubSpot d’OOMOL nécessitent un compte HubSpot capable d’autoriser les scopes CRM demandés. Certaines fonctionnalités HubSpot, accès aux objets, accès aux propriétés ou contrôles administrateur peuvent dépendre de votre plan HubSpot ou des paramètres de votre organisation.
Contacter le support
Si vous avez besoin d’aide pour ajouter, utiliser, tester ou supprimer l’app HubSpot, contactez le support OOMOL :
- Email : support@oomol.com
- Page de support : https://oomol.com/fr/support/
Veuillez inclure l’e-mail de votre compte OOMOL, le compte HubSpot connecté ou l’ID de portail si pertinent, l’action que vous essayiez d’effectuer et tout message d’erreur ou capture d’écran.