Aller au contenu principal
Technique WhatsApp API 6 min de lecture

Les webhooks WhatsApp dans l'immobilier : ce qu'il faut savoir

Webhook WhatsApp API immobilier : exploitez les événements temps réel pour automatiser visites, relances locataires et notifications de transaction.

Un webhook WhatsApp est une notification HTTP que Meta envoie instantanément à votre serveur lorsqu'un événement survient sur votre numéro WhatsApp Business : message reçu, bouton cliqué, statut de livraison mis à jour. Dans l'immobilier, secteur où chaque interaction avec un prospect ou un locataire peut conditionner une transaction ou un renouvellement de bail, ces événements sont un levier d'automatisation concret. Agences, plateformes de gestion locative, promoteurs, portails immobiliers : comprendre les webhooks, c'est passer d'une communication manuelle à une communication scalable.

Ce que les webhooks WhatsApp apportent à l'immobilier

L'immobilier souffre d'une asymétrie de communication : les agents jonglent entre dizaines de prospects, les locataires attendent des réponses rapides, et les administrateurs de biens gèrent des masses de sollicitations récurrentes. Les webhooks permettent de répondre à ce volume sans multiplier les effectifs.

Les événements les plus utiles dans le secteur :

  • button : "Je confirme la visite" — Le prospect valide son créneau. Votre CRM immobilier met à jour le rendez-vous automatiquement.
  • button : "Je ne peux plus" — Le prospect annule. Le créneau est libéré, une alternative peut être proposée immédiatement.
  • messages : texte libre — Un locataire signale une panne, une fuite, un problème. Le webhook déclenche une notification à votre équipe technique.
  • read — La notification de loyer a été lue. Vous pouvez espacer ou arrêter votre séquence de relance.
  • failed — Le message n'a pas été délivré. Numéro incorrect ou compte inactif : une alerte interne permet d'investiguer avant que la situation ne dégénère.
  • delivered — Le rappel de signature d'état des lieux est arrivé. Sans réponse dans les 2h, vous déclenchez un second canal.

Pour les éditeurs de logiciels de gestion immobilière ou les portails de mise en relation, l'API WhatsApp Business de Whakup permet d'intégrer ces événements directement dans votre plateforme. Whakup est Meta Tech Provider certifié : vos clients agences n'ont pas à obtenir eux-mêmes une accréditation Meta.

Architecture webhook pour une plateforme immobilière

L'intégration suit une architecture événementielle standard, avec quelques particularités liées au multi-tenant immobilier :

Étapes clés

  1. Votre plateforme expose un endpoint HTTPS public. Meta l'appelle pour valider la configuration via une requête GET avec un token de vérification.
  2. Chaque payload webhook est signé (HMAC-SHA256). Votre backend valide la signature avant traitement.
  3. L'endpoint retourne HTTP 200 immédiatement. Le traitement métier est asynchrone (file de messages).
  4. Les événements sont dédupliqués sur le wamid (identifiant unique du message).

Gestion multi-tenant

Une plateforme qui sert plusieurs agences ou administrateurs de biens doit router les webhooks vers le bon tenant. L'architecture Whakup permet d'associer chaque numéro WhatsApp Business à une entité distincte. Chaque agence a ses propres conversations, ses propres webhooks, sa propre identité de marque.

Fiabilité

Un webhook non reçu (endpoint indisponible) peut manquer une confirmation de visite ou une alerte de sinistre. Prévoyez un monitoring de disponibilité et une stratégie de replay des événements manqués.

Pour un cadre de décision sur l'architecture d'intégration, consultez Build vs Buy pour l'API WhatsApp et le guide complet de l'API WhatsApp Business.

Cas d'usage concrets : de l'événement à l'action métier

Événement Action déclenchée Valeur métier
Bouton "Confirmer visite" Mise à jour agenda agent + rappel J-1 Réduction des no-shows
Bouton "Annuler visite" Libération créneau + proposition d'alternative Optimisation du planning
Message "J'ai une fuite" Ticket de maintenance créé automatiquement Réactivité locataire
Statut read sur quittance Arrêt de la relance automatique Réduction des envois inutiles
Statut failed sur relance loyer Alerte gestionnaire + tentative SMS Continuité du recouvrement
Bouton "Je suis intéressé" (annonce) Lead qualifié ajouté au CRM + notification agent Accélération du traitement des leads
Message libre hors flux Routage vers agent humain Gestion des demandes complexes

Ce dernier cas est important : tous les prospects et locataires ne répondent pas à des boutons structurés. Le webhook messages capte les réponses libres et les route intelligemment — vers un bot NLU, vers l'agent responsable du dossier, ou vers une boîte de triage.

Tarification et volume dans l'immobilier

Un gestionnaire de 500 biens génère en moyenne 2 à 3 interactions WhatsApp par bien par mois : rappel d'échéance, quittance, relance si impayé. Soit environ 1 000 à 1 500 messages par mois.

À 0,0336 €/message utility pour la France (0,0088 € Whakup + 0,0248 € Meta), le coût mensuel est de l'ordre de 35 à 50 €. Pour un portail de mise en relation qui envoie des notifications de matching à des acheteurs ou locataires potentiels, le coût dépend du volume mais reste bien en dessous du coût d'un canal téléphonique ou d'un mailing physique.

Pour les détails tarifaires et les calculs par catégorie de message, consultez le guide des prix de l'API WhatsApp Business 2026.

FAQ

Les webhooks WhatsApp peuvent-ils déclencher la création automatique d'un ticket de maintenance ?

Oui. Le webhook messages capte le message du locataire, votre worker l'analyse (mot-clé, NLU, ou simple règle de routage) et appelle l'API de votre outil de ticketing pour créer un ticket. L'opération est transparente pour le locataire.

Comment gérer un prospect qui ne répond pas à WhatsApp ?

Le webhook delivered sans read après 24h, ou le webhook failed, signale un contact non réactif. Votre plateforme peut basculer automatiquement vers un autre canal (email, SMS) ou notifier l'agent pour un suivi manuel.

Peut-on envoyer des documents (contrats, états des lieux) via WhatsApp et savoir s'ils ont été ouverts ?

Vous pouvez envoyer un document PDF via l'API WhatsApp. Le statut read indique que le message a été ouvert. En revanche, il n'indique pas si le fichier joint a été téléchargé. Pour une preuve de lecture opposable (ex : état des lieux signé), WhatsApp ne remplace pas une solution de signature électronique certifiée.

L'API Whakup supporte-t-elle les notifications de matching immobilier à grande échelle ?

Oui, avec une nuance importante : les notifications proactives hors fenêtre de conversation doivent utiliser des templates approuvés par Meta. Pour des envois marketing (nouvelles annonces correspondant aux critères d'un acheteur), la catégorie marketing s'applique, à environ 0,08 €/message. Pour des notifications transactionnelles liées à une relation existante, la catégorie utility est plus adaptée et moins coûteuse.


Les webhooks WhatsApp donnent à votre plateforme immobilière un système nerveux événementiel : chaque interaction prospect ou locataire est captée, chaque notification est tracée, chaque absence de réponse est gérée. Découvrez l'API WhatsApp de Whakup et déployez une communication immobilière automatisée, scalable et conforme.

#technique api whatsapp#webhook whatsapp api#immobilier
Stéphane Haouzi
Stéphane HaouziHead of Growth

Head of Growth chez Whakup, Stéphane pilote la stratégie d'acquisition et les partenariats en Afrique francophone. Expert en marketing digital et expansion marché.

🚀

Prêt à passer à l'action ?

Essayez Whakup gratuitement pendant 15 jours. Aucune carte bancaire requise.

Démarrer l'essai gratuit