LetsBot Menu
Commencer Français Langue

Meta Business Partner Société immatriculée au Royaume-Uni

Langue

Guide de configuration · HubSpot

Guide de configuration de l'intégration HubSpot + WhatsApp

Ce guide vous accompagne pas à pas dans l'installation et la configuration de l'application LetsBot dans HubSpot, jusqu'à l'envoi de votre premier message WhatsApp automatisé déclenché par les événements de votre CRM.

La configuration prend environ cinq minutes et ne nécessite aucun code. Cette page est publique et ne demande aucune connexion.

1. Avant de commencer

  • Un compte LetsBot. Vous pouvez commencer par un essai gratuit de 14 jours, sans carte bancaire.
  • Un numéro WhatsApp Business connecté dans LetsBot, car les messages sont envoyés via l'API WhatsApp Business officielle.
  • Un compte HubSpot sur lequel vous avez le droit d'installer des applications (administrateur du compte).
  • Des numéros de téléphone valides au format international sur vos contacts HubSpot, pour que l'application puisse identifier le destinataire.

2. Installer l'application et connecter HubSpot

La connexion s'effectue via OAuth HubSpot. On ne vous demande jamais de copier-coller une clé API.

  1. Connectez-vous au panneau LetsBot. letsbot.net/login
  2. Ouvrez la section Intégrations, puis choisissez HubSpot.
  3. Cliquez sur le bouton Connecter HubSpot. Vous êtes redirigé vers l'écran d'autorisation OAuth de HubSpot.
  4. Choisissez le compte à connecter, puis vérifiez les autorisations et approuvez-les.
  5. Vous revenez automatiquement au panneau LetsBot une fois la connexion établie, avec les principaux déclencheurs déjà activés et prêts à être personnalisés.

3. Autorisations demandées, et pourquoi

L'application ne demande que les autorisations réellement nécessaires à ses fonctionnalités. En voici la liste complète :

Portée Pourquoi elle est nécessaire
crm.objects.contacts.read Lire les propriétés des contacts (nom, téléphone, e-mail) pour identifier le destinataire et remplir les variables du message.
crm.objects.contacts.write Créer un contact lorsqu'un message WhatsApp arrive d'un numéro inconnu, et enregistrer les réponses sous forme de notes dans la chronologie du contact.
crm.objects.deals.read Lire les propriétés des opportunités (nom, étape, montant, date de clôture) et le contact associé, pour alimenter les déclencheurs d'opportunité.
tickets Lire les propriétés des tickets (objet, contenu) et le contact associé, pour alimenter le déclencheur de ticket.

L'application ne modifie jamais vos opportunités ni vos tickets et ne supprime jamais aucun enregistrement. Les seules écritures qu'elle effectue sont la création d'un contact lorsqu'un message arrive d'un numéro inconnu, et l'ajout d'une note de conversation dans la chronologie de ce contact.

4. Choisir un événement déclencheur

Chaque événement est indépendant : vous n'activez que ce dont vous avez besoin et pouvez désactiver le reste à tout moment. Aucun message n'est jamais envoyé pour un événement que vous n'avez pas activé vous-même.

Événement Type d'abonnement HubSpot Événement
Contact créé contact.creation Envoie un message de bienvenue dès qu'un nouveau contact est ajouté dans HubSpot.
Étape du cycle de vie du contact modifiée contact.propertyChange Envoie un message lorsque le contact passe à une nouvelle étape du cycle de vie (par exemple, Marketing Qualified Lead).
Opportunité créée deal.creation Envoie un message au contact associé à l'opportunité dès sa création.
Étape de l'opportunité modifiée deal.propertyChange Envoie une mise à jour lorsque l'opportunité passe à une autre étape de votre pipeline.
Ticket créé ticket.creation Informe le client sur WhatsApp que son ticket a bien été reçu et qu'il est en cours de traitement.

5. Rédiger le message ou choisir un modèle

Pour chaque événement, vous pouvez rédiger un message texte rapide ou choisir un modèle WhatsApp enrichi prenant en charge les boutons, les listes et les médias. Les données HubSpot sont insérées dans le message grâce aux variables suivantes :

Variable Valeur
{CONTACT_FIRSTNAME} Prénom du contact
{DEAL_NAME} Nom de l'opportunité
{DEAL_STAGE} Étape de l'opportunité
{DEAL_AMOUNT} Montant de l'opportunité
{TICKET_SUBJECT} Objet du ticket
{TICKET_CONTENT} Contenu du ticket

Les messages sont disponibles en arabe et en anglais. Si la langue du contact est définie dans LetsBot, la version correspondante est envoyée ; sinon, la version anglaise est utilisée par défaut.

6. Activer et tester

  1. Activez l'interrupteur à côté de l'événement configuré, puis enregistrez.
  2. Dans HubSpot, créez un véritable enregistrement de ce type — par exemple un nouveau contact — avec votre propre numéro de téléphone.
  3. Un message WhatsApp vous parvient en quelques secondes. Vous pouvez suivre le statut de livraison dans le journal des messages de LetsBot.

7. Réponses enregistrées dans HubSpot

Lorsqu'un client répond sur WhatsApp, LetsBot enregistre la réponse sous forme de note dans la chronologie du contact dans HubSpot, afin que tout le contexte de la conversation reste sur la fiche client. Si la réponse provient d'un numéro que vous n'avez pas encore, un contact est créé automatiquement et la note y est rattachée.

8. Dépannage

Le message n'est pas arrivé

  • Vérifiez que l'interrupteur de l'événement est activé et enregistré.
  • Vérifiez que le contact HubSpot possède un numéro de téléphone valide au format international ; sans cela, le destinataire ne peut pas être identifié.
  • Vérifiez que votre numéro WhatsApp Business est connecté et apparaît en ligne dans LetsBot.

Les déclencheurs d'opportunité ou de ticket ne fonctionnent pas

Les déclencheurs d'opportunité et de ticket dépendent d'un contact associé, car le message est envoyé à une personne et non à un enregistrement. Associez l'opportunité ou le ticket à un contact disposant d'un numéro de téléphone, puis réessayez.

La connexion a été interrompue

Cela se produit si l'application a été désinstallée depuis HubSpot ou si l'autorisation a été révoquée. Reconnectez-vous depuis le panneau LetsBot en cliquant à nouveau sur Connecter HubSpot.

9. Déconnexion et désinstallation

Vous pouvez vous déconnecter à tout moment depuis le panneau LetsBot avec le bouton de déconnexion, ou en supprimant l'application dans les paramètres des applications connectées de votre compte HubSpot. Dès la déconnexion, tous les messages automatisés s'arrêtent immédiatement et l'application ne conserve plus aucun accès à vos données.

10. Données et confidentialité

Toutes les données transitent par une connexion chiffrée et les jetons d'accès sont stockés chiffrés. LetsBot ne lit dans HubSpot que les champs nécessaires pour personnaliser le message et identifier le destinataire, et vos données ne sont jamais partagées avec des tiers.

Besoin d'aide pour la configuration ? Notre support IA répond 24/7 dans toutes les langues, et notre équipe humaine est disponible en arabe et en anglais pour vous aider à finaliser la connexion et à envoyer votre premier message.

Connecter maintenant

La configuration prend environ cinq minutes et ne nécessite aucun code.