📡 Ajouter un webhooks Ugosign (multi-endpoints)

🎯 Objectif

Cet article explique comment configurer un nouvel endpoint webhook sur Ugosign pour recevoir des notifications en temps réel (CRM, ERP, GED) lors d'événements spécifiques.

📝 Prérequis

• Être super-administrateur.
• Disposer d'une URL de destination (endpoint) capable de recevoir des requêtes HTTP POST publiques.
• S'assurer que votre serveur retourne un code HTTP 2XX.

📍 Étapes

1. Accéder au menu d'intégration

1. Cliquez sur le nom de votre entreprise situé en haut à droite.

2. Sélectionnez l'onglet "Intégrations", puis cliquez sur la section "Webhook".

2. Créer un nouvel endpoint

1. Sur la page de gestion des webhooks, cliquez sur le bouton "Ajouter un endpoint".

2. Dans le formulaire qui s'ouvre, saisissez l'URL de destination de votre serveur (ex: https://votre-domaine.com/api/ugosign/hooks).
3. Validez la création. L'endpoint est immédiatement fonctionnel.

✅ Résultat attendu

Votre nouvel endpoint est actif et commence à recevoir les notifications webhook pour les événements configurés. La sécurité des échanges est assurée par le secret HMAC-SHA256 dédié à cette URL.

💡 Bon à savoir

• Sécurité granulaire : Chaque endpoint possède son propre secret, permettant une gestion indépendante des clés de signature.
• Validation technique : Pour être considéré comme valide, votre endpoint doit retourner un code de statut HTTP 2XX (ex: 200, 201, 204) en moins de 5 secondes.
• Limites : Une organisation peut configurer un maximum de 5 endpoints uniques.
• Gestion des erreurs : Si votre endpoint échoue 5 fois de suite, il sera automatiquement désactivé pour protéger l'intégrité des données.

🔗 Ressources associées

• 📡 Consulter les logs d'un appel webhook

Partagez cet article: https://app.ugosign.com/help-center/topic/how-webhooks-work