Webhooks entrants

Les webhooks permettent à yourang.ai de notifier votre système externe dès que quelque chose se passe, sans recourir au polling. Le modèle est simple : vous enregistrez une URL, yourang.ai y envoie une requête HTTP POST à chaque événement d'intérêt.

Pourquoi des webhooks plutôt que du polling

Sans webhooks, votre système devrait appeler l'API à répétition pour demander 'quelque chose de nouveau s'est-il passé ?'. C'est inefficace, coûteux et cela introduit des délais. Avec les webhooks, vous recevez la notification en quelques millisecondes après l'événement, avec le payload déjà prêt.

Événements disponibles

• Appel terminé (avec transcription, résumé, résultat)
• Nouvelle réservation
• Modification de réservation
• Annulation de réservation
• Nouvelle commande
• Mise à jour du statut de commande
• Nouveau contact créé
• Mise à jour des champs du contact
• Résultat de critère d'évaluation
• Workflow terminé

Configurer un webhook

1. 1

   Implémentez l'endpoint dans votre système

   Une URL publique HTTPS qui reçoit des POST. Elle doit répondre 200 OK lorsque l'événement a été accepté.

2. 2

   Enregistrez l'URL dans yourang.ai

   Allez dans Administration → API → Webhook, saisissez l'URL et sélectionnez les événements d'intérêt.

3. 3

   Vérifiez la signature

   Chaque payload est signé avec un secret partagé. Votre endpoint doit valider la signature pour garantir que le message provient bien de yourang.ai.

4. 4

   Testez avec des événements réels

   Le tableau de bord affiche le journal des dernières livraisons avec leur résultat (200 OK, erreurs). Utilisez ce journal pour le débogage.

Retry et fiabilité

Si votre endpoint répond par une erreur ou ne répond pas à temps, yourang.ai réessaye automatiquement en suivant une stratégie avec backoff exponentiel (ex. 30 secondes, 5 minutes, 1 heure, ...). Après plusieurs tentatives échouées, l'événement aboutit dans une dead letter queue pour intervention manuelle. Côté endpoint, il convient de répondre 200 OK rapidement et de traiter de manière asynchrone pour éviter les timeouts.