Configuration et livraison - Resocom

Configuration

Un administrateur génère la clé de signature (whsec_…) — voir Authentification.
Renseignez l’adresse de réception (URL HTTPS de votre serveur) sur chaque workflow concerné, dans l’onglet Diffusion de sa page.
Utilisez le bouton de test de ce même onglet : il envoie un événement verification.test et affiche le code de réponse de votre serveur.

Contrat de livraison

Garantie	Détail
Sémantique	Au moins une fois — dédupliquez par `eventId`.
Réponse attendue	Code 2xx en moins de 5 secondes.
Reprises	30 s, 5 min, 30 min, 2 h, 12 h, 24 h — 7 tentatives au total.
Signature	Recalculée à chaque tentative (horodatage frais).
Contenu	Identifiants et statuts uniquement — jamais de données du document.

Traitez le webhook de façon asynchrone : accusez réception (2xx) immédiatement, puis traitez. Un traitement long qui dépasse 5 secondes sera compté comme un échec et rejoué.

Journal et rejeu

Le journal des livraisons (Administration → Entreprise → Intégrations) montre chaque envoi, ses tentatives et le dernier code de réponse, et permet de renvoyer un événement — le rejeu conserve le même eventId, votre déduplication le neutralise donc sans double traitement.