- Catégorie
- API
- Sens
- Envoi d’événements
- Format
- JSON signé en HMAC-SHA256
- Adresses
- Jusqu’à 25 par organisation
- Relances
- Jusqu’à 6 tentatives, sur plus d’une journée
- Mise en route
- Une adresse HTTPS et un secret
- Offres
- Offre Enterprise
- Éditeur
- Upsellr
01Ce que font les webhooks
Le signal qui fait avancer vos outils.
- 01
Un événement à chaque fin de traitement
Terminé, en échec ou arrêté : à la fin de chaque traitement d’enrichissement ou de génération, Upsellr envoie l’événement avec le détail du traitement.
- 02
Signé, pour être vérifié
Chaque envoi porte un identifiant, un horodatage et une signature HMAC-SHA256 calculée avec votre secret : votre outil vérifie qu’il vient bien d’Upsellr.
- 03
Relancé tant qu’il n’est pas reçu
Sans réponse 2xx en 10 secondes, Upsellr relance après 1 minute, 5 minutes, 30 minutes, 4 heures puis 24 heures.
- 04
Un journal de chaque envoi
Statut, code HTTP, nombre de tentatives et contenu : chaque livraison se consulte pendant 7 jours, et un envoi en échec se relance en un clic.
- 05
Enchaînez vos outils
Publiez, prévenez une équipe ou lancez un export dès que les fiches sont prêtes : le webhook donne le signal, votre outil fait la suite.
- 06
Gardez la main
Désactivez une adresse, changez son secret ou supprimez-la : ses relances en attente sont annulées.
02Mise en route
Branché en quelques minutes.
- 01
Ouvrez les paramètres de l’organisation
Section API et webhooks, réservée aux propriétaires et aux administrateurs.
- 02
Ajoutez une adresse
Une URL en HTTPS, accessible depuis internet.
- 03
Copiez le secret
Il ne s’affiche qu’une fois et sert à vérifier la signature de chaque envoi.
- 04
Vérifiez la signature
Recalculez la signature HMAC-SHA256 de l’horodatage et du contenu, et refusez un envoi trop ancien.
- 05
Répondez vite
Une réponse 2xx en moins de 10 secondes, puis traitez la suite de votre côté.
03Événements
Les événements envoyés.
| Événement | Envoyé | Relancé si besoin |
|---|---|---|
| Traitement terminé (workflow.run.completed) | Oui | Oui |
| Traitement en échec (workflow.run.failed) | Oui | Oui |
| Traitement arrêté (workflow.run.stopped) | Oui | Oui |
Compatibilité et prérequis
- L’offre Enterprise
- Une adresse HTTPS publique, sur le port 443
- Un rôle propriétaire ou administrateur
- Une réponse 2xx en moins de 10 secondes
- Conseil : dédupliquez sur l’identifiant de l’événement
Vous gardez la main
Fiables par conception.
- Signés en HMAC-SHA256, avec un secret propre à chaque adresse
- Livrés au moins une fois : dédupliquez sur l’identifiant de l’événement
- Relancés jusqu’à 6 fois, sur plus d’une journée
- Envoyés en HTTPS, vers des adresses publiques uniquement
04Questions
Questions sur les webhooks Upsellr.
Les webhooks sont-ils inclus dans mon offre ?
Ils sont réservés à l’offre Enterprise, comme l’API.
Quels événements sont envoyés ?
La fin d’un traitement d’enrichissement ou de génération : terminé, en échec ou arrêté. Chaque événement contient le détail du traitement.
Comment vérifier qu’un envoi vient d’Upsellr ?
Recalculez la signature HMAC-SHA256 de l’horodatage et du contenu avec votre secret, comparez-la à l’en-tête X-Upsellr-Signature, et refusez un envoi de plus de 5 minutes.
Que se passe-t-il si mon serveur ne répond pas ?
Sans réponse 2xx en 10 secondes, Upsellr relance après 1 minute, 5 minutes, 30 minutes, 4 heures puis 24 heures. Un envoi en échec se relance aussi à la main depuis le journal.
Puis-je recevoir deux fois le même événement ?
Oui, c’est possible : la livraison est garantie au moins une fois, sans ordre garanti. Dédupliquez sur l’identifiant de l’événement.
Combien de temps le journal est-il conservé ?
7 jours, avec le statut, le code HTTP, le nombre de tentatives et le contenu de chaque envoi.
Combien d’adresses puis-je déclarer ?
Jusqu’à 25 par organisation, chacune avec son propre secret, que vous pouvez renouveler.
Un test dans l’éditeur de workflows envoie-t-il un événement ?
Non. Seuls les vrais traitements envoient des événements.
Votre prochain produit
mérite mieux qu’un copier-coller.
Confiez ses premiers produits à votre équipe IA.
Marcus
Amazon