HubSpot

Le connecteur HubSpot appelle, dans une campagne Dialfire, les contacts ou les leads d'un segment HubSpot (liste). Après chaque appel, il réécrit le résultat dans HubSpot : l'appel avec son enregistrement, les champs modifiés, les réunions planifiées et les notes.

Cette page décrit les étapes propres à HubSpot. Pour les principes communs à tous les connecteurs (champs, horaires de synchronisation, messages d'erreur), consultez Comment fonctionnent les connecteurs.

Prérequis

  • Un compte Dialfire et un compte HubSpot.
  • Un utilisateur Dialfire disposant des droits d'administrateur.
  • Un utilisateur HubSpot qui peut lire et modifier les contacts et voir les segments. Pour lier des leads, il faut en outre un accès aux leads.
  • Facultatif, pour les mises à jour instantanées : Marketing Hub Professional ou Enterprise, ainsi que le droit "Edit workflows" (modifier les workflows) pour l'utilisateur HubSpot. Sans cela, le connecteur fonctionne exactement de la même manière, simplement de façon planifiée plutôt qu'instantanée.
  • Facultatif, pour le Customer Journey Report : un abonnement Professional ou Enterprise (événements personnalisés). Le Customer Journey Report lui-même nécessite Marketing Hub Enterprise.

Étape 1 : préparer un segment dans HubSpot

Créez un segment (liste) contenant les fiches que vous souhaitez appeler. Dans HubSpot, allez dans CRM → Segments → Create segment. Choisissez Contacts ou Leads comme objet.

  • Un segment actif (basé sur des filtres) se met à jour tout seul : les nouvelles fiches correspondantes arrivent automatiquement dans Dialfire, et les fiches qui ne correspondent plus sortent de la campagne.
  • Un segment statique ne change que lorsque vous ajoutez ou retirez vous-même des fiches.

Seuls les segments de contacts et de leads peuvent être liés. Les segments d'entreprises, de deals ou de tickets n'apparaissent pas dans la liste.

Étape 2 : connecter votre compte HubSpot

  1. Ouvrez connect.dialfire.com/connectors/hubspot ou installez l'application Dialfire depuis la HubSpot App Marketplace.
  2. Connectez-vous à Dialfire avec votre utilisateur administrateur.
  3. Sur l'écran de consentement de HubSpot, choisissez votre compte HubSpot et confirmez l'accès.

Autorisations facultatives sur l'écran de consentement : HubSpot présente certaines autorisations sous forme de cases à cocher qui ne sont pas cochées par défaut.

  • Pour lier des segments de leads, cochez les autorisations relatives aux leads.
  • Pour utiliser le Journey Report, cochez "access to send Custom Events" (accès à l'envoi d'événements personnalisés).

Sans ces cases cochées, tout le reste fonctionne. Vous pouvez accorder ces autorisations plus tard avec Grant permission (« accorder l'autorisation ») sur la page du connecteur. Vos liaisons sont conservées.

Étape 3 : lier un segment à une campagne

  1. À gauche, choisissez le segment HubSpot. La liste affiche le nom, le type et le nombre de fiches de chaque segment.
  2. À droite, choisissez le Modèle de campagne Dialfire (de base ou calendrier) ou -- clone existing Dialfire campaign -- (« copier une campagne Dialfire existante »).
  3. Saisissez le Titre de la campagne et cliquez sur .

Choix du segment HubSpot

Si des segments de leads manquent dans la liste, la connexion ne dispose pas encore de l'autorisation relative aux leads. La page l'indique et propose Grant permission.

Étape 4 : champs et numéro de téléphone

Ouvrez la liaison avec .

  • Champs à importer : les champs les plus courants sont présélectionnés (nom, numéros de téléphone, e-mail, adresse, entreprise, fonction, statut du lead, etc.). Utilisez le champ de recherche pour en trouver d'autres, y compris vos propres propriétés. Les champs HubSpot qui ne peuvent pas être modifiés (par exemple des valeurs calculées) sont marqués read-only (lecture seule) et ne peuvent qu'être importés.
  • Phone number field (« champ du numéro de téléphone », contacts) : choisissez la propriété HubSpot qui est composée, par exemple Phone Number ou Mobile Phone Number.
  • Where is the phone number? (« où se trouve le numéro de téléphone ? », leads) : un lead n'a pas de numéro de téléphone propre. Choisissez le lien vers le contact associé et le champ téléphone de ce contact. Dialfire reprend alors aussi le nom et l'adresse du contact. Tant que vous n'avez pas fait ce choix, la synchronisation d'une liaison de leads est suspendue.
  • Mark contacts with the same phone number as duplicates (« marquer comme doublons les contacts ayant le même numéro de téléphone ») : activé par défaut pour les contacts et désactivé pour les leads, car plusieurs leads peuvent appartenir à la même personne.

Champs et numéro de téléphone d'une liaison de contacts

Pour une liaison de leads, choisissez la provenance du numéro de téléphone :

Numéro de téléphone d'une liaison de leads

Les leads sans contact lié, ou dont le contact n'a pas de numéro de téléphone, sont importés mais ne peuvent pas être appelés. La liaison affiche un avis indiquant le nombre de ces fiches.

Fonctionnement de la synchronisation

Un badge sur chaque liaison indique le mode :

  • Real-time sync (« synchronisation en temps réel ») : Dialfire a créé un workflow HubSpot nommé "Send contacts of list '…' to Dialfire campaign '…'". Les contacts qui rejoignent le segment sont dans Dialfire en quelques secondes. Ne modifiez pas ce workflow.
  • Scheduled sync (« synchronisation planifiée ») : il n'y a pas de workflow. Les nouvelles fiches arrivent avec la synchronisation régulière (environ toutes les 10 minutes tant que la campagne est appelée, ou lorsque vous cliquez sur Synchroniser). Cliquez sur le badge pour en connaître la raison. Le plus souvent, il manque l'abonnement HubSpot requis ou le droit "Edit workflows". Les segments de leads utilisent toujours la synchronisation planifiée, car HubSpot ne propose pas de déclencheur instantané pour eux.

Liaison de contacts avec synchronisation en temps réel

Liaison de leads avec synchronisation planifiée

Un clic sur le badge explique le mode actuel :

Mode de synchronisation

Dans les deux modes :

  • Les modifications de fiches déjà présentes dans Dialfire sont appliquées la nuit (entre 1 h et 5 h) ou lorsque vous cliquez sur Synchroniser.
  • Les fiches qui quittent le segment sont retirées de la file d'appels. Cela se produit une fois que deux synchronisations l'ont confirmé, ou immédiatement après une synchronisation manuelle.
  • Les contacts supprimés dans HubSpot sont également retirés de la campagne.

Configurer vous-même le workflow en temps réel

Si Dialfire n'a pas pu créer le workflow, vous pouvez le créer vous-même. Cliquez sur le badge Scheduled sync. Le panneau affiche l'adresse du webhook avec Copy URL (« copier l'URL »). Ensuite, dans HubSpot :

  1. Automation → Workflows → Create workflow, choisissez Contact-based.
  2. Déclencheur d'inscription : List membership, puis choisissez votre segment.
  3. Onglet Re-enrollment : activez Allow contacts to re-enroll et choisissez Contact is a member of list.
  4. Cliquez sur +, puis sur Data ops → Send a webhook.
  5. Méthode POST, collez l'URL copiée, authentification None (l'URL contient la clé d'accès).
  6. Enregistrez et activez le workflow.

Ce que Dialfire inscrit dans HubSpot

Après chaque appel, lorsque le contact passe par la tâche Hubspot Push :

  • Appel : un appel intitulé "Call in Dialfire" sur le contact. Il comprend le sens de l'appel, la durée, les numéros de téléphone, l'agent, le commentaire de l'agent et le résultat. Le résultat est défini sur Connected, No answer ou Wrong number. Les enregistrements peuvent être écoutés directement dans HubSpot. Chaque appel n'est consigné qu'une seule fois.
  • Champs : les valeurs modifiées des champs sélectionnés. L'étape d'un lead peut aussi être modifiée de cette manière, si Pipeline stage est sélectionné comme champ.
  • Nouvelles fiches : un contact créé dans Dialfire est également créé dans HubSpot et ajouté au segment. Un nouveau lead est lié à son contact.
  • Réunion (campagne calendrier) : lorsque l'agent prend un rendez-vous, une réunion est créée sur le contact. Le propriétaire est le propriétaire du contact ou, à défaut, l'utilisateur HubSpot qui a connecté le compte.
  • Note : si la campagne remplit le champ hs_contact_note, une note est ajoutée au contact.

Facultatif : HubSpot Customer Journey Report

Les rapports de parcours de HubSpot ne comptent que les appels passés avec les outils d'appel propres à HubSpot. Dialfire peut donc également envoyer chaque appel sous forme d'événement personnalisé (custom event), que vous pouvez ensuite utiliser dans les rapports de parcours.

  1. Dans le connecteur, ouvrez HubSpot Journey Report → Set up.
  2. Dans HubSpot, allez dans Data Management → Event Management → Create an event → Create custom event, et utilisez le nom interne que le connecteur vous indique.
  3. Ajoutez les cinq propriétés listées dans le connecteur (résultat de l'appel, statut, sens, durée et campagne).
  4. Vérifiez l'autorisation dans le connecteur. S'il affiche Grant permission, autorisez à nouveau et cochez "access to send Custom Events".
  5. Pour chaque liaison, choisissez si ses appels sont signalés (Report this campaign's calls to the HubSpot Journey Report, « signaler les appels de cette campagne au HubSpot Journey Report »).

Configurer Dialfire pour vos appels

Chaque liaison crée une nouvelle campagne dans votre compte Dialfire. Connectez-vous à Dialfire et :

  1. Définissez l'identifiant de l'appelant pour vos appels sortants.
  2. Ajoutez vos agents dans le menu Utilisateurs.
  3. Vérifiez les paramètres d'appel et d'enregistrement des tâches.

Tâches de la nouvelle campagne

  1. Vérifiez le formulaire de contact (menu Campagne, vue Formulaire) et assurez-vous que les champs dont vos agents ont besoin sont visibles.

Formulaire de contact

Le modèle de campagne contient déjà la tâche Hubspot Push, qui envoie les résultats au CRM après chaque appel. Vous pouvez à tout moment adapter le flux de tâches et le formulaire à vos besoins.

Besoin d'aide ?

Vous découvrez Dialfire ? Consultez notre documentation ou contactez notre équipe de support.

Dépannage

SituationSolution
"HubSpot has withdrawn access for this account" (« HubSpot a révoqué l'accès pour ce compte »)L'application Dialfire a été désinstallée dans HubSpot, ou l'utilisateur qui l'a connectée a été supprimé. Cliquez sur Connect HubSpot account again (« reconnecter le compte HubSpot »). Les campagnes et les paramètres restent inchangés.
"The HubSpot authorization is not getting anywhere" (« l'autorisation HubSpot n'aboutit pas »)Vérifiez que l'application Dialfire est toujours installée dans HubSpot, puis cliquez sur Go to the HubSpot authorization (« aller à l'autorisation HubSpot »).
Des segments de leads manquentL'autorisation relative aux leads est manquante. Cliquez sur Grant permission, puis cochez les cases relatives aux leads sur l'écran de HubSpot.
"Synchronization is paused until you choose where the phone number comes from" (« la synchronisation est suspendue jusqu'à ce que vous choisissiez la provenance du numéro de téléphone »)Liaison de leads : choisissez le lien vers le contact et le champ téléphone (étape 4).
"HubSpot rate limit reached" (« limite de requêtes HubSpot atteinte »)HubSpot limite les requêtes pendant un moment. Attendez environ 20 secondes, puis cliquez sur Retry (« réessayer »).
Uniquement « Scheduled sync »Le temps réel nécessite Marketing Hub Professional/Enterprise et le droit « Edit workflows ». Vous pouvez aussi configurer le workflow vous-même (voir ci-dessus).