· 5 min · TextMeFlow Team

Notifications WhatsApp depuis les deals et formulaires HubSpot

Les workflows HubSpot peuvent appeler un webhook externe dès qu'un deal change d'étape, qu'un formulaire est soumis ou qu'un lead est attribué à un commercial. La plupart des équipes pointent ce webhook vers Slack ou l'e-mail. Le diriger vers WhatsApp met le message sous les yeux de la seule personne qu'il concerne vraiment (le commercial, le lead ou le client), dans un canal qu'elle consulte en quelques minutes, et non quand elle rouvrira sa boîte de réception.

C'est un simple schéma webhook vers API : pas d'application du marketplace HubSpot, pas d'abonnement supplémentaire, juste une action de workflow et un petit récepteur.

Pourquoi ne pas utiliser directement le canal WhatsApp de HubSpot

L'intégration WhatsApp native de HubSpot (via l'Inbox) est conçue pour des conversations bidirectionnelles avec les contacts et repose sur la WhatsApp Business Platform officielle de Meta, avec son propre processus d'approbation et de templates. C'est un autre outil pour un autre usage. Ici, il s'agit de notifications transactionnelles à sens unique, comme « deal passé à Devis envoyé », « nouveau lead qui vous est attribué » ou « formulaire soumis par X », envoyées via l'API de messages de TextMeFlow, qui ne nécessite aucune validation de template par Meta. Utilisez le canal natif de HubSpot pour les conversations WhatsApp de vos agents avec les clients ; utilisez ce schéma pour les alertes internes et les confirmations simples.

Étape 1 : ajouter une action webhook à un workflow HubSpot

Dans HubSpot, ouvrez Automation → Workflows et modifiez (ou créez) un workflow inscrit sur le déclencheur voulu : un deal qui entre dans une étape précise, une soumission de formulaire ou le changement d'une propriété de contact. Ajoutez une action Webhook :

  • Méthode : POST
  • URL : le endpoint de votre récepteur (voir plus bas)
  • Corps de la requête : choisissez « Custom » et mappez les propriétés HubSpot dont vous avez besoin : nom du deal, montant, téléphone du propriétaire, téléphone du contact

Les webhooks de workflow HubSpot ne se déclenchent que sur les niveaux Professional et Enterprise ; sur Starter, utilisez plutôt une connexion Zapier ou Make vers HubSpot et passez directement à l'action TextMeFlow dans cette automatisation, avec le même mappage de champs.

Étape 2 : construire un petit récepteur

Votre récepteur prend le corps du POST de HubSpot, décide de ce que le message doit dire et appelle TextMeFlow. Une version Node/Express minimale :

import express from 'express';
const app = express();
app.use(express.json());

app.post('/hubspot-deal-hook', async (req, res) => {
  const { dealname, amount, owner_phone } = req.body;

  await fetch('https://api.textmeflow.eu/v1/messages', {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${process.env.TEXTMEFLOW_TOKEN}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      to: owner_phone,
      text: `Le deal "${dealname}" (${amount} €) vient de passer à Devis envoyé. Relancez aujourd'hui.`,
    }),
  });

  res.sendStatus(200);
});

La même structure fonctionne pour un récepteur PHP ou Python : des SDK TextMeFlow existent pour les deux, et n'importe quel client HTTP convient puisque c'est une API REST standard.

Étape 3 : gérer le format des numéros de téléphone

C'est là que la plupart des installations HubSpot vers WhatsApp échouent discrètement. Les propriétés de téléphone HubSpot sont du texte libre : +32 470 12 34 56, 0470123456 et 32470123456 peuvent cohabiter dans le même champ selon la personne qui l'a saisi. Normalisez au format E.164 (+ et chiffres uniquement, indicatif du pays inclus) avant d'appeler l'API, et rejetez ou signalez tout ce qui ne peut pas être analysé plutôt que d'abandonner la notification en silence :

function toE164(raw, defaultCountry = '32') {
  const digits = raw.replace(/[^\d]/g, '');
  if (raw.startsWith('+')) return '+' + digits;
  if (digits.startsWith('00')) return '+' + digits.slice(2);
  if (digits.startsWith('0')) return `+${defaultCountry}${digits.slice(1)}`;
  return `+${digits}`;
}

Pour le cas du propriétaire du deal, récupérez si possible le numéro dans le profil de l'utilisateur HubSpot plutôt que dans une propriété de deal en texte libre : il y a bien moins de risques qu'il soit mal formé ou absent.

Étape 4 : ne notifiez pas à chaque modification de propriété

Les workflows HubSpot se réinscrivent ou se redéclenchent lors de mises à jour de propriétés plus souvent qu'on ne le pense : un montant de deal arrondi, une réaffectation de propriétaire, un champ de formulaire rempli automatiquement par une intégration HubSpot peuvent tous déclencher le même webhook. Ajoutez une branche de filtre dans le workflow pour que le webhook ne se déclenche que sur les transitions d'étape ou les noms de formulaire pour lesquels vous voulez réellement un message WhatsApp, et rendez le récepteur lui-même idempotent (dédoublonnez sur hs_object_id + nouvelle étape) afin qu'une nouvelle tentative de HubSpot n'envoie pas deux fois.

À quoi cela sert

Bons usages : un commercial prévenu dès qu'un deal de forte valeur atteint une étape avancée, un lead qui reçoit une confirmation WhatsApp instantanée après avoir rempli un formulaire de contact, un responsable de compte alerté quand une propriété de risque de renouvellement bascule. Mauvais usage : l'envoi en masse à une liste HubSpot. C'est de la communication marketing, qui exige consentement et gestion de templates que ce schéma n'offre pas ; passez par un véritable outil de campagne et réservez ce schéma aux notifications individuelles déclenchées par un événement, ce qui vous tient aussi à l'écart du score de risque anti-spam de TextMeFlow.

Démarrer gratuitement avec TextMeFlow : 50 messages par mois, sans limite de durée, largement de quoi connecter et tester un workflow HubSpot avant de choisir une offre payante.

Envie d'envoyer des messages WhatsApp via API ?

Gratuit pour toujours jusqu'à 50 messages/mois. Scannez un QR et envoyez votre premier message en 5 minutes.

Gratuit pour toujours