Les webhooks WhatsApp dans la restauration : ce qu'il faut savoir

Un webhook WhatsApp API dans la restauration est un mécanisme technique qui notifie votre système en temps réel dès qu'un événement se produit côté WhatsApp — confirmation de réservation par un client, commande de plat à emporter, annulation, ou réponse à une enquête de satisfaction. Pour les éditeurs de solutions de caisse, de gestion de restaurant ou de click-and-collect, c'est l'infrastructure qui rend WhatsApp réellement exploitable en conditions de service.

Ce que les webhooks apportent aux flux de la restauration

La restauration fonctionne en temps réel : un couvert confirmé à 13h00 doit être préparé à 13h15. Les webhooks suppriment le délai entre l'action du client sur WhatsApp et la mise à jour de vos systèmes.

Réservations et confirmations de table Un client répond "Confirmer" au rappel de réservation envoyé la veille. Le webhook capture la réponse en secondes, met à jour le plan de salle dans votre logiciel de gestion, et libère l'opérateur d'un rappel téléphonique. Si le client répond "Annuler", le webhook libère le couvert et peut déclencher une notification aux clients en liste d'attente.

Click-and-collect et livraison Un client envoie sa commande de midi via WhatsApp (texte libre ou boutons). Le webhook capture le message, le route vers la cuisine via le bon de commande digital. À la fin de préparation, un statut de message déclenche automatiquement une notification "Votre commande est prête".

Enquêtes post-repas 30 minutes après le passage en caisse, un template de satisfaction est envoyé. Les webhooks de réponse (note sur 5, commentaire texte) alimentent directement le tableau de bord de l'enseigne.

Événements webhook clés pour les plateformes F&B

Événement	Type payload	Application restauration
Réponse bouton	messages (type interactive, button_reply)	Confirmation/annulation réservation, choix menu
Message texte	messages (type text)	Commande libre, instruction de livraison
Image	messages (type image)	Photo d'un plat pour réclamation, preuve de livraison
Statut delivered	statuses	Vérifier la réception du rappel de réservation
Statut read	statuses	Suivi de lecture du bon de livraison
Statut failed	statuses + errors	Numéro invalide : alerte à l'hôtesse d'accueil
Opt-out	messages	Désabonnement du programme de fidélité

Pour les chaînes de restauration rapide, les boutons interactifs + webhooks remplacent avantageusement les SMS à sens unique : le client interagit, le webhook route vers le bon établissement via le phone_number_id.

Intégration avec les outils de caisse et de gestion de restaurant

La plupart des logiciels de caisse et de gestion de restaurant (Lightspeed, Zelty, Addition, ou solutions propriétaires) exposent une API interne. L'architecture d'intégration webhook suit ce schéma :

1. Réception webhook : votre endpoint HTTPS reçoit le payload Meta, répond 200 immédiatement.
2. Queue asynchrone : le payload est publié dans une file (Redis Streams, RabbitMQ) pour traitement découplé.
3. Worker de mapping : extrait la donnée utile (texte de commande, choix du bouton, wa_id du client) et appelle l'API de votre logiciel de caisse ou de votre module de réservation.
4. Confirmation au client : si le traitement réussit, le worker déclenche l'envoi d'un message de confirmation via l'API WhatsApp (gratuit dans la fenêtre de session de 24h).
5. Gestion d'erreur : si l'API caisse est indisponible (rush du midi), le message va en dead-letter queue avec alerte pour traitement manuel.

Pour les éditeurs multi-restaurants (franchises, groupes de restauration), la gestion multi-tenant est indispensable : chaque restaurant a son propre numéro WhatsApp et ses propres règles de gestion. Le phone_number_id dans le payload permet le routing automatique vers le bon tenant.

Conformité et gestion des données clients

La restauration collecte des données simples mais sensibles : numéros de téléphone, préférences alimentaires, historique de commandes. Points de vigilance :

• Consentement opt-in : recueillez le consentement WhatsApp explicitement (lors de la réservation, à la caisse, via QR code) avant tout envoi. L'opt-out via webhook doit déclencher la suppression immédiate des files d'envoi actives.
• Vérification HMAC : validez la signature X-Hub-Signature-256 sur chaque requête entrante pour écarter les faux webhooks.
• Hébergement EU : pour les restaurants français, les données clients doivent rester en Europe. Choisissez un fournisseur API WhatsApp avec infrastructure EU.
• Durée de rétention : les données de commande et les numéros de téléphone ne doivent pas être conservés indéfiniment dans les logs webhook. Automatisez la purge selon votre politique RGPD.

FAQ

Les webhooks WhatsApp peuvent-ils gérer les commandes de plusieurs tables simultanément en heure de pointe ?

Oui, à condition que votre architecture soit asynchrone. Votre endpoint webhook répond 200 immédiatement à chaque requête Meta et publie dans une queue. Des workers parallèles consomment ensuite en simultané. Le goulot d'étranglement ne vient pas du webhook mais de votre capacité à traiter les messages en parallèle côté plateforme.

Comment distinguer une confirmation de réservation d'une commande click-and-collect dans le même webhook ?

Le contexte se gère à deux niveaux : le phone_number_id (si vous utilisez des numéros dédiés par type de service) ou un identifiant de contexte dans le template d'origine. Quand vous envoyez un template de rappel de réservation, vous pouvez inclure un context ou utiliser le champ referral pour taguer la conversation. À réception du webhook, votre worker lit ce contexte pour identifier le flux métier approprié.

WhatsApp est-il adapté pour les commandes en temps réel type click-and-collect avec des menus de 50 articles ?

Pour les menus complexes, les boutons interactifs (limités à 3 boutons ou 10 éléments de liste) peuvent être insuffisants. L'approche recommandée est d'utiliser WhatsApp pour l'initiation de la commande et la confirmation, tout en renvoyant le client vers un lien de commande en ligne pour la sélection détaillée. WhatsApp reste le canal de notification et de suivi, pas nécessairement l'interface de commande complète.

Quel est le coût d'envoi d'une confirmation de réservation via WhatsApp API ?

Si la confirmation est envoyée dans la fenêtre de 24h suivant le dernier message du client, elle est gratuite côté Meta. Si c'est un template envoyé hors session (ex. rappel J-1 sans message préalable), c'est un message utility facturé ~0,0336 € pour un numéro français (0,0248 € frais Meta + 0,0088 € Whakup). Un rappel de réservation à 0,03 € comparé à un appel téléphonique : l'économie est évidente.

---

Pour déployer les webhooks WhatsApp dans votre solution de restauration ou votre plateforme F&B, consultez l'API WhatsApp Whakup. Whakup est Meta Tech Provider certifié, propose l'embedded signup pour vos clients restaurateurs, l'hébergement EU et le support technique dédié aux éditeurs.

Consultez également notre guide des templates WhatsApp par catégorie pour configurer vos notifications de réservation et notre article sur le meilleur BSP WhatsApp en France pour comparer les options du marché.