HubSpot
Connexion native OAuth en un clic. Chaque appel Rosa crée un Engagement Call dans HubSpot, lié au Contactdu numéro appelant (créé si nouveau). Lookup live à l'appel pour reconnaître vos clients et afficher leurs deals.
⚡ Temps total : 2 minutes
Aller au dashboard pour connecterPrérequis
- Un compte Rosa actif
- Un compte HubSpot (gratuit ou payant — toutes éditions supportées)
- Droit administrateur sur le compte HubSpot (pour l'autorisation OAuth)
Étapes
Allez dans le dashboard Rosa
Ouvrez Paramètres → CRM. Vous voyez une grille "Connexions natives" avec les CRM disponibles.
Cliquez sur « Connecter HubSpot »
Vous serez redirigé vers la page HubSpot où vous devrez choisir le portail à connecter (si vous gérez plusieurs portails).
Autorisez les permissions
HubSpot vous demande d'autoriser Rosa à :
crm.objects.contacts.read— lire les contacts (pour le lookup)crm.objects.contacts.write— créer / mettre à jour les contactscrm.objects.deals.read— lire les deals (pour afficher les contrats à Rosa)
Aucune écriture sur les deals. Rosa ne crée pas de deals à votre place.
Retour au dashboard automatique
Vous êtes redirigé vers Rosa avec un message "HubSpot connecté ✅". La carte HubSpot affiche maintenant le nom de votre portail et "Connecté".
Testez avec un appel
Appelez votre numéro Rosa depuis un téléphone. À la fin de l'appel (1-2 min après), allez dans HubSpot → CRM → Activités → Appels. Vous devez voir un nouvel engagement Call avec le résumé, l'intention, et le RDV s'il y en a un.
Ce qui est créé dans HubSpot
Pour chaque appel terminé :
- Contact: si le numéro n'existe pas, Rosa crée un contact avec téléphone, prénom/nom, email, adresse (ce qu'elle a capturé pendant l'appel).
hs_lead_status = NEW - Engagement Call associé au contact, avec :
- Titre :
Appel Rosa : [intent] ([urgence]) - Description : résumé complet + RDV + tarif évoqué + lien vers la fiche Rosa
- Direction : INBOUND · Statut : COMPLETED · Durée : en ms
- Timestamp : heure de fin d'appel
- Titre :
Reconnaissance des clients existants (lookup)
Quand un client connu appelle, Rosa interroge HubSpot par téléphone en temps réel (POST /crm/v3/objects/contacts/search). Si trouvé, Rosa :
- L'appelle par son prénom
- Voit ses deals (= contrats potentiels en cours) pour orienter la conversation
- Évite de redemander adresse, email, etc.
Le numéro doit être stocké dans la propriété standard phone ou mobilephone. Format E.164 recommandé (+33...).
Dépannage
L'appel ne remonte pas dans HubSpot
- Vérifiez dans Rosa → Paramètres → CRM que la carte HubSpot affiche "Connecté" (pas d'erreur)
- Attendez 2-3 min après la fin de l'appel (Rosa analyse puis push)
- Dans HubSpot, filtrez les Activités sur les 24h, type "Appel"
- S'il y a une erreur affichée, déconnectez puis reconnectez HubSpot
Le contact n'est pas reconnu au lookup
Vérifiez que le numéro stocké dans HubSpot est au format +33...(E.164). HubSpot stocke souvent les numéros tels que saisis ("06 12 34 56 78"), ce qui ne matche pas. Solution : nettoyer les numéros existants ou exporter/réimporter au format E.164.
Erreur 401 — token expiré
Rosa rafraîchit automatiquement les tokens HubSpot (validité 6h). Si vous voyez cette erreur, c'est que le refresh_token a été révoqué côté HubSpot (changement de mot de passe, désinstallation d'app). Reconnectez HubSpot depuis le dashboard.
Alternative : passer par Zapier
Si vous préférez ne pas utiliser la connexion native (ex : workflow Zapier déjà en place pour d'autres événements), vous pouvez utiliser le webhook générique Rosa →guide Zapier/Make. Vous garderez plus de contrôle, au prix d'une config Zapier à maintenir.
Prêt à connecter ?
Allez dans votre dashboard pour activer la connexion HubSpot en un clic.