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.