Dans cette histoire
Emplacement : Paramètres → Avancé → Connecter d'autres applications
Ouvrez cette page : admin.<your-site>/settings/integrations/webhooks (remplacez <your-site> par l'adresse de votre site). Si vous ne la voyez pas dans le menu, activez Afficher tous les paramètres sur la page Paramètres.
Avant de commencer
- Seul le propriétaire du site peut ajouter des webhooks.
- L'adresse de réception doit commencer par https:// et être accessible sur l'Internet public.
Étapes à suivre
- Ouvrez Paramètres → Avancé → Connecter d'autres apps → Webhooks.
- Appuyez sur Ajouter un webhook.
- Saisissez un Nom, par exemple Zapier, et l'Adresse qui reçoit les messages.
- Sous Envoyer un message quand, cochez les événements : Un article est publié, Un article en ligne est modifié, Un article est retiré, Un rectificatif est ajouté, Un article est rétracté, Nouveau commentaire, Un abonnement change.
- Appuyez sur Ajouter un webhook.
- Copiez le secret de signature. Vous ne le verrez qu'une seule fois. Appuyez sur C'est noté.
- Essayez Envoyer un test.
Bon à savoir
- Chaque message est signé. Vérifiez l'en-tête « Keynate-Signature » pour vous assurer qu'il provient bien de votre site.
- Votre système répond avec un code d'état 2xx pour confirmer la réception du message.
- Les messages en échec sont réessayés pendant 24 heures maximum. Un webhook qui échoue pendant 3 jours est désactivé. Corrigez le récepteur, puis appuyez sur Reprendre.
- Vous pouvez Mettre en pause, Reprendre, ou effectuer une Nouveau secret. L'ancien secret continue de signer pendant une durée que vous choisissez.
- La liste indique l'état de chaque webhook : Opérationnel, Pas encore utilisé, Ne fonctionne pas, En pause, Désactivé.
- Ouvrez un message envoyé pour consulter les tentatives et appuyez sur Renvoyer.
Problèmes fréquents
- « L'adresse doit commencer par https://."
- « Donnez un nom au webhook. »
- « Choisissez au moins un événement. »
- « Vous avez atteint le nombre maximal de webhooks autorisés. Supprimez d'abord un webhook que vous n'utilisez plus. »
Questions
Questions fréquemment posées
À quoi ressemble un message ?
Un court texte JSON contenant le type d'événement et l'article concerné.
Que se passe-t-il si mon récepteur est indisponible ?
Les messages en échec sont réessayés pendant 24 heures maximum.