Webhooks

Les webhooks envoient un POST HTTPS à votre serveur chaque fois que quelque chose se produit dans Serpfull. Gérez-les dans Intégrations → Webhooks (propriétaires et administrateurs). Pour le format de la charge utile, les en-têtes et le code de vérification, consultez la référence API Webhooks.

Ajouter un point de terminaison

• Ouvrez Intégrations → Webhooks et appuyez sur Ajouter un point de terminaison.
• Entrez une URL https publique sur le port 443. Les adresses privées, internes, loopback, link-local et métadonnées cloud sont refusées (nous vérifions chaque adresse résolue par l’hôte, lors de l’enregistrement et à chaque livraison), et les redirections ne sont pas suivies.
• Ajoutez une description optionnelle, choisissez les sites web couverts (tous les sites, y compris les futurs, ou quelques-uns choisis) et cochez les événements à envoyer.
• Copiez le secret de signature affiché après l’enregistrement. Vous pouvez le révéler à nouveau depuis la carte du point de terminaison, ou le faire pivoter.

Plusieurs points de terminaison

Ajoutez autant de points de terminaison que votre forfait le permet (le meilleur forfait parmi vos sites) : Aucun forfait 2, Starter 3, Growth 5, Scale 10, Pro 25, Enterprise 50. Chacun a son propre secret, sites web et événements, et peut être désactivé sans être supprimé.

Par site web

Les événements concernant un site web ne vont qu’aux points de terminaison qui le couvrent. Désactiver l’intégration Webhooks pour un site met en pause ses événements partout sans toucher à vos points de terminaison. Les événements d’organisation (facturation) vont à tous les points de terminaison abonnés.

Tester, enregistrer et renvoyer

Envoyer un événement test met en file d’attente un test.ping vers ce point de terminaison. Le journal de livraison conserve 30 jours de tentatives avec l’événement, le code d’état ou l’erreur, la durée, le numéro de tentative et les corps de la requête et de la réponse (tronqués). Filtrez-le par point de terminaison, événement ou résultat, et appuyez sur Renvoyer pour envoyer à nouveau un événement avec un nouvel ensemble de tentatives.

Tentatives et désactivation

Répondez avec n’importe quel 2xx dans les 10 secondes. Sinon, nous retentons après 1 minute, 5 minutes, 30 minutes, 2 heures, 6 heures, 12 heures et 24 heures (8 tentatives, environ 45 heures). Répondez 410 Gone pour arrêter de retenter cet événement. Si un point de terminaison échoue pendant 3 jours (et au moins 10 tentatives consécutives), nous le désactivons, supprimons ses événements en file d’attente et notifions votre équipe dans l’application. L’intégration Webhooks affiche alors Besoin d’attention. Corrigez le récepteur et réactivez le point de terminaison.

Rotation du secret

Faire pivoter le secret vous donne un nouveau secret immédiatement. Pendant les 24 heures suivantes, chaque requête est signée avec le nouveau et l’ancien secret (deux valeurs v1), vous permettant de mettre à jour votre récepteur sans perdre d’événements.

Depuis un assistant

Le connecteur IA dispose de webhooks_list_endpoints, webhooks_create_endpoint, webhooks_update_endpoint, webhooks_delete_endpoint, webhooks_send_test, webhooks_list_deliveries et webhooks_redeliver. Les secrets ne sont affichés que dans le tableau de bord.