Pourquoi brancher les webhooks sur votre site

Le client a réservé sur votre site. Il rafraîchit sa boîte mail toutes les deux minutes. De votre côté, quelqu’un doit encore « penser à le rappeler ». C’est exactement le moment où une bonne intention devient une mauvaise expérience.

Les webhooks Opticar envoient automatiquement un événement à votre serveur quand quelque chose change dans une réservation. Votre site (ou votre CRM) peut alors confirmer le client sans attendre.

Pourquoi c’est stratégique (pas seulement technique)

• Confirmation plus rapide → moins d’annulations anxieuses
• Moins de tâches manuelles pour l’équipe
• Parcours professionnel digne d’une agence qui scale
• Base pour WhatsApp / e-mail transactionnels propres

Événements utiles au quotidien

• booking.created — une demande vient d’arriver
• booking.status_changed — acceptée, refusée, ou autre statut
• booking.payment_status_changed — acompte / paiement mis à jour

Exemple concret : vous acceptez dans Opticar → webhook → votre site envoie « Réservation confirmée, rendez-vous demain 10 h à l’aéroport ».

Sécurité : ne sautez pas cette étape

Vérifiez toujours la signature X-Opticar-Signature (HMAC-SHA256) avec le secret configuré. Ignorez les appels non signés. Répondez rapidement en 2xx pour éviter les retries inutiles.

Mise en place en 4 étapes

1. Exposez une URL HTTPS stable sur votre serveur
2. Configurez l’endpoint webhook côté Opticar / intégration
3. Validez la signature
4. Déclenchez e-mail / WhatsApp / mise à jour de page de confirmation

Tutoriel complet : Webhooks. Prérequis : Premiers pas API.

Erreurs fréquentes

• URL en HTTP ou qui change à chaque déploiement
• Traitement long avant de répondre 200 (faites le travail en asynchrone si besoin)
• Pas de journal des événements reçus (difficile à déboguer)
• Confondre « demande créée » et « réservation acceptée » dans le message client

Un site qui confirme tout seul, c’est un commercial qui ne dort jamais. Branchez les webhooks après la disponibilité et les réservations API — dans cet ordre. Votre développeur vous dira merci. Vos clients aussi.