Documentation Webhook

Guide complet pour intégrer et utiliser les webhooks de FIAB Gestion

🎯 Vue d'ensemble

Comprendre le système de webhook de FIAB Gestion

Qu'est-ce qu'un webhook ?

Un webhook permet à FIAB Gestion d'envoyer automatiquement des notifications à votre serveur lorsque certaines actions se produisent, notamment quand une livraison passe au statut "livrée".

Fonctionnement

Déclenchement automatique : Quand une livraison passe à l'état "livrée"
Déclenchement manuel : Via le bouton "📤 Envoyer" dans l'interface
Conditions requises : URL webhook configurée + (email OU téléphone client remplis)
Retry automatique : 3 tentatives maximum avec délai progressif
Timeout : 120 secondes maximum par tentative

💡 Note importante

Vous pouvez maintenant configurer vous-même votre webhook depuis votre Dashboard dans l'onglet "Mon profil" → "Configurer webhook".

📊 Format des Données

Structure du payload envoyé par le webhook

{
  "entrepriseId": "uuid-de-votre-compte",
  "entreprise": "Nom de votre compte",
  "numeroSuivi": "VOTRE-123456",
  "emailClient": "[email protected]",
  "telephoneClient": "+229 01 23 45 67",
  "statut": "livre",
  "dateLivraison": "2025-01-15T10:30:00.000Z",
  "informations": "Livraison de colis",
  "timestamp": "2025-01-15T10:30:00.000Z"
}

✅ Réponse Attendue

Ce que votre endpoint doit retourner

"Envoyé"

Votre endpoint doit répondre avec exactement ce texte (sans guillemets) pour que le webhook soit considéré comme réussi.