HubSpot

Connecter HubSpot permet de transformer chaque demande de devis en contact à relancer, sans que personne ait à recopier les informations à la main.

Attention

HubSpot nécessite deux valeurs, pas une : un Portal ID et un HubSpot access token. Il faut aussi cocher trois autorisations (scopes) sur l’application privée qui émet le jeton. Si l’un ou l’autre manque, la connexion semble configurée mais n’envoie rien ; l’étape 1 couvre les deux.

Note

HubSpot est proposé avec le forfait PRO. Klaviyo, Mailchimp et Shopify sont les intégrations proposées avec le forfait FREE. Consultez Comparatif des forfaits.

Si votre forfait ne l’inclut pas, la liste Third-party integration affiche un bouton Upgrade désactivé à la place de l’icône des paramètres, avec un cadenas à côté. Sélectionner le cadenas explique de quel forfait la fonctionnalité a besoin et renvoie vers Pricing plans dans l’application. Cela vient de votre forfait, pas d’une panne.

Étape 1 : récupérer votre Portal ID et votre jeton d’accès dans HubSpot

HubSpot n’émet plus de clés API classiques. Vous créez à la place une application privée dans votre compte HubSpot, qui vous fournit un jeton d’accès. Le Portal ID est distinct : il identifie votre compte HubSpot lui-même.

1. Trouver votre Portal ID

   Votre Portal ID (aussi appelé ID de compte ou hub ID) identifie le compte HubSpot dans lequel l’application écrit. Le guide de HubSpot : Check your current account.

   Le même lien est repris dans l’application, dans le texte d’aide Find your Portal ID sous le champ.

2. Créer une application privée avec les bonnes autorisations

   Créez l’application privée dans votre compte HubSpot. Le guide de HubSpot vous explique comment faire : Private apps.

   Avant de terminer sa création, cochez au moins ces trois autorisations :

   • forms
   • crm.objects.contacts.write
   • crm.schemas.contacts.write

   L’application affiche les trois mêmes autorisations sous le champ du jeton, ce qui vous permet de les comparer plus tard avec votre application privée.

   

   Capture d’écran à ajouter. L’écran des autorisations de l’application privée HubSpot avec forms, crm.objects.contacts.write et crm.schemas.contacts.write cochés.

3. Copier son jeton d’accès

   HubSpot affiche le jeton une fois l’application privée créée. Copiez-le et gardez-le en lieu sûr pendant que vous terminez la configuration.

Danger

Les autorisations sont la cause discrète des échecs. Un jeton créé sans forms, crm.objects.contacts.write et crm.schemas.contacts.write est un jeton parfaitement valide : Enable reste activé, l’application enregistre sans broncher, et HubSpot refuse chaque contact envoyé. Si les contacts n’arrivent jamais, vérifiez d’abord les autorisations.

Attention

L’application connecte les demandes de devis à un formulaire HubSpot, et non à une liste de contacts. Créez ce formulaire dans HubSpot avant de commencer : la liste déroulante ne peut proposer que des formulaires qui existent déjà.

Étape 2 : connecter HubSpot dans l’application

1. Ouvrir l’onglet Integrations

   Dans votre admin Shopify, ouvrez SA Request a Quote, sélectionnez Advanced settings, puis ouvrez l’onglet Integrations.

2. Sélectionner HubSpot

   Sous Third-party integration, sélectionnez HubSpot, décrit dans l’application par « Seamlessly connect your submissions to your data ».

   La page HubSpot s’ouvre, avec un fil d’Ariane Third-party pour revenir à la liste.

   

   Choisissez le service, puis ouvrez ses paramètres.

3. Activer Enable

   Activez Enable, la première commande de la page. Rien n’est envoyé à HubSpot tant que ce n’est pas fait.

4. Coller les deux identifiants

   Les deux champs se trouvent juste sous Enable, dans cet ordre :

   1. Portal ID : collez l’ID de compte récupéré à l’étape 1. Son texte d’aide est Find your Portal ID.
   2. HubSpot access token : collez le jeton de l’application privée récupéré à l’étape 1. Son texte d’aide est Find or generate your access token et, en dessous, l’application affiche les autorisations dont le jeton a besoin : forms, crm.objects.contacts.write et crm.schemas.contacts.write.

   Le champ s’appelle HubSpot access token, et non « API key » : c’est le jeton qu’émet une application privée.

   Renseignez les deux. L’application ne récupère vos formulaires HubSpot qu’une fois qu’elle a la paire complète ; une page avec seulement le jeton reste donc bloquée, sans rien à choisir. Si la liste déroulante n’apparaît pas après la saisie, sélectionnez Merge fields à côté du champ du jeton pour que l’application relance la récupération.

   

   HubSpot a besoin de deux valeurs, qui ne sont pas interchangeables.

5. Choisir le formulaire HubSpot

   Ouvrez Select a HubSpot form to integrate et choisissez le formulaire qui doit recevoir les demandes de devis. Tant que vous n’avez rien choisi, le champ affiche « Please select a HubSpot form ».

   Si l’application affiche « It looks like you don’t have any HubSpot forms », c’est que le formulaire n’existe pas encore, que l’un des deux identifiants est incorrect, ou qu’il manque l’autorisation forms au jeton. Corrigez cela avant de continuer : la correspondance des champs reste masquée tant qu’aucun formulaire n’est sélectionné.

6. Faire correspondre les champs de votre formulaire

   Les lignes de correspondance n’apparaissent qu’une fois le Portal ID, le HubSpot access token et le formulaire tous définis. Les lignes proviennent du formulaire HubSpot que vous venez de choisir : ce sont donc ses propres champs et non une liste fixe ; choisissez d’abord le formulaire, les lignes suivent.

   Lisez chaque ligne de gauche à droite :

   • À gauche : le champ HubSpot, grisé car vous ne pouvez pas le renommer.
   • Au milieu : la façon dont la valeur est fournie : has no value, is dynamic value by (la valeur provient du formulaire de devis) ou is fixed value by (le même texte est envoyé pour chaque devis).
   • À droite : le champ du formulaire de devis que vous envoyez, ou le texte fixe que vous avez saisi.

   Vous choisissez donc la valeur du formulaire de devis, à droite, pour renseigner le champ HubSpot indiqué à gauche, et jamais l’inverse.

   La ligne de l’e-mail est celle à ne pas ignorer : sans elle, il n’y a aucun contact à créer. Si votre formulaire recueille des Company information, faites aussi correspondre le nom de l’entreprise, pour que l’équipe commerciale voie qui fait la demande. Si un champ est obligatoire dans le formulaire HubSpot et que vous le laissez sans correspondance, l’application signale la ligne et refuse d’enregistrer.

   

7. Enregistrer

   Sélectionnez Save. Rien n’est conservé tant que vous n’avez pas enregistré, et une page non enregistrée n’envoie rien.

   Tant que des modifications ne sont pas enregistrées, l’application affiche une barre d’enregistrement avec Save et Discard changes ; Discard changes annule tout ce que vous avez saisi sur la page. Un message Changes saved confirme l’enregistrement.

Note

Mailchimp présente le même tableau de correspondance des champs en gros plan. Suivez-le uniquement pour la correspondance : Mailchimp n’a besoin que d’une clé API et choisit une liste, alors que HubSpot a aussi besoin du Portal ID et choisit un formulaire.

Étape 3 : tester

Envoyez une vraie demande de devis depuis votre vitrine, puis vérifiez dans HubSpot que le nouveau contact est bien là. Confirmez que les champs que vous avez mis en correspondance sont bien arrivés, et pas seulement l’adresse e-mail.

Attention

Ne sautez pas le test. Une connexion peut sembler active tout en ne fournissant rien d’utile si les champs sont mal mis en correspondance, et vous ne le remarquerez qu’au moment d’utiliser les données.

Est-ce le bon outil ?

Le bon choix si les devis sont traités par une équipe commerciale plutôt que par le marketing.

Si vous n’utilisez pas déjà HubSpot, ne l’adoptez pas uniquement pour cela : Zapier connecte les données de devis à presque tout, et Créer un client Shopify après l’envoi garde tout dans Shopify avec le forfait FREE.

Si les contacts n’arrivent pas

• Vérifiez les autorisations de votre application privée. forms, crm.objects.contacts.write et crm.schemas.contacts.write doivent toutes être accordées. Un jeton sans elles s’enregistre sans erreur et ne livre rien. C’est la cause la plus courante.
• Vérifiez que Enable est toujours activé. Rien n’est envoyé s’il est désactivé.
• Vérifiez le Portal ID en plus du jeton. Un jeton correct avec un Portal ID manquant ou mal saisi laisse la connexion à moitié établie : l’application ne peut pas charger vos formulaires, donc rien n’est envoyé.
• Vérifiez que le jeton est toujours valide. Renouveler un jeton dans HubSpot interrompt la connexion jusqu’à ce que vous colliez le nouveau. Les jetons enregistrés sont masqués ; collez-en donc un nouveau en cas de doute.
• Vérifiez que vous avez choisi le bon formulaire. Les contacts arrivent peut-être à un endroit où vous ne regardez pas.
• Vérifiez que la ligne de l’e-mail est mise en correspondance. Sans elle, il n’y a aucun contact à créer.

Toujours bloqué ? Écrivez à [email protected].

Étapes suivantes

• Présentation des intégrations : les autres outils que vous pouvez connecter
• Créer un formulaire B2B : recueillez des informations sur l’entreprise utiles à envoyer vers un CRM
• Comparatif des forfaits : ce qu’inclut le forfait PRO