Ce que vous allez construire

Dans ce guide, vous allez créer un chatbot WhatsApp entièrement fonctionnel qui reçoit des messages via un webhook et répond intelligemment. Contrairement aux constructeurs drag-and-drop, cette approche vous donne un contrôle total sur la logique de conversation — connectez n'importe quel modèle d'IA, CRM ou base de données.

Prérequis

Avant de commencer, vous aurez besoin de :

  • Un compte SocialHook avec l'API WhatsApp Business connectée
  • Node.js 18+ et une compréhension basique d'Express
  • Une URL publique pour votre webhook (utilisez ngrok pour le développement local)

Étape 1 : Configurer votre serveur webhook

Créez d'abord un serveur Express simple qui recevra les payloads webhook de SocialHook. Chaque fois qu'un client envoie un message WhatsApp à votre numéro professionnel, SocialHook fera un POST d'un payload JSON vers ce point de terminaison.

Étape 2 : Vérifier les signatures des payloads

Vérifiez toujours que les requêtes entrantes proviennent réellement de SocialHook. Chaque livraison inclut un en-tête X-SocialHook-Signature contenant un hash HMAC-SHA256 du corps du payload, signé avec votre clé secrète.

Rejetez toute requête dont la signature ne correspond pas — cela protège votre serveur contre les faux appels webhook.

Étape 3 : Analyser le payload

Un payload de message WhatsApp typique ressemble à ceci :

{"platform":"whatsapp","event":"message.received","from":"+1555001234","message":{"type":"text","body":"Bonjour !"}}

Le champ platform sera toujours whatsapp pour les messages WhatsApp. Le champ event vous indique s'il s'agit d'un nouveau message ou du début d'une nouvelle conversation.

Étape 4 : Ajouter votre logique métier

Maintenant la partie amusante. Vous pouvez connecter n'importe quel service pour répondre aux messages. Pour un bot simple par mots-clés, vérifiez message.body pour les mots déclencheurs. Pour un bot propulsé par l'IA, transmettez le message à l'API LLM de votre choix et renvoyez la réponse.

Étape 5 : Déployer et tester

Une fois votre serveur opérationnel localement, déployez sur n'importe quel hébergeur Node.js — Railway, Render, Fly.io ou votre propre VPS. Mettez à jour l'URL de webhook SocialHook pour pointer vers votre point de terminaison de production, et envoyez un message de test depuis WhatsApp pour vérifier que tout fonctionne de bout en bout.