Intégration HubSpot

• Connexion HubSpot par OAuth
• Synchronisation des contacts de HubSpot vers demeterrr
• Synchronisation des contacts de demeterrr vers HubSpot
• Renvoi des scores NPS et CSAT vers les contacts HubSpot
• Synchronisation manuelle depuis la page Intégrations

1. Allez dans Paramètres > Intégrations.
2. Trouvez HubSpot et cliquez sur Connecter HubSpot.
3. Complétez l'authentification OAuth dans HubSpot et revenez dans demeterrr.
4. Confirmez que la carte affiche Connecté.

Après le retour OAuth réussi, demeterrr lance une synchronisation initiale.

Depuis le flux d'intégration actuel :

• L'état connecté affiche lastSyncAt et connectedAt.
• Vous pouvez déclencher une synchronisation manuelle avec Synchroniser maintenant.
• La synchronisation des contacts supporte les directions from_hubspot, to_hubspot ou bidirectional dans l'API de synchronisation.

Si vous voulez que les utilisateurs HubSpot déclenchent un sondage sans ouvrir demeterrr :

1. Créez une clé API demeterrr avec la portée sequences:execute.
2. Dans les flux de travail HubSpot, ajoutez une action webhook ou code personnalisé.
3. Appelez :

POST /api/v1/sequences/:id/execute

1. Envoyez les champs du contact dans le corps de la requête (email requis).

Exemple de corps :

{
  "contacts": [
    {
      "email": "client@exemple.com",
      "firstName": "Marie",
      "lastName": "Tremblay",
      "phone": "+15551234567"
    }
  ]
}

En-tête d'authentification :

Authorization: Bearer dem_...

1. Ouvrez Paramètres > Intégrations.
2. Sur la carte HubSpot, cliquez sur Déconnecter.
3. Confirmez l'action.

La déconnexion arrête la synchronisation et le renvoi des scores.

Si la connexion échoue immédiatement, votre déploiement est peut-être manquant :

• HUBSPOT_CLIENT_ID
• HUBSPOT_CLIENT_SECRET

Si vous êtes redirigé avec une erreur, reconnectez-vous et vérifiez :

• Vous êtes connecté à la bonne organisation
• L'état OAuth est valide (pas de session expirée)
• L'URL de rappel correspond à votre domaine d'application

Si la synchronisation manuelle échoue :

• Reconnectez HubSpot
• Réessayez avec une portée CRM initiale plus petite
• Vérifiez le statut de l'intégration et les mises à jour de lastSyncAt

• Intégration Salesforce
• Intégration Zapier
• Clés API