Connecter Webhook à SEOryon
Pour les équipes avec leur propre stack. SEOryon envoie en POST un payload JSON signé en HMAC vers votre endpoint lors de la publication, la mise à jour, la suppression et la dépublication, et c'est votre code qui décide de la suite.
- Comment ça se connecte
- JSON signé en HMAC (oryon-v1) envoyé en POST vers votre endpoint
- Modifier après publication
- Oui, les mises à jour republient le même article
- Supprimer et dépublier
- Oui, depuis SEOryon
- Tableaux
- Non. SEOryon envoie à la place une liste à puces structurée.
Avant de vous connecter
Mettez ceci en place d'abord. C'est ce qui fait la différence entre une connexion qui passe au vert et une qui échoue dès la première publication.
- Un endpoint HTTPS actif qui vérifie la signature et agit sur les événements.
- Un endroit sûr pour stocker le secret de signature.
- Un développeur pour le mettre en place. Des extraits de code de receiver en Node, PHP et Python sont fournis.
Comment se connecter, étape par étape
Les mêmes étapes que SEOryon vous montre dans l'application. Celle-ci se déroule entièrement dans SEOryon, il n'y a donc rien à chercher dans une autre interface d'administration.
- 1
Dans SEOryon, ouvrez Settings, Integrations, Webhook et cliquez sur Generate pour créer votre secret de signature de 32 octets.
- 2
Copiez le prompt prêt à l'emploi dans Claude Code, Cursor ou Codex, qui construit le receiver. Le payload complet et la spec de signature ci-dessous sont intégrés au prompt, il n'y a donc rien d'autre à transmettre. L'écrire vous-même fonctionne tout aussi bien, en Node, PHP ou Python.
- 3
Indiquez à SEOryon l'URL de votre endpoint. Il envoie un événement de test et vérifie la réponse avant de marquer la connexion comme saine.
Le contrat de signature
- Secret de signature
- 32 octets, généré dans SEOryon et stocké par vous
- Signature
- HMAC-SHA256 du timestamp + "." + raw_request_body, utilisant le secret partagé
- En-têtes
- X-Oryon-Timestamp (secondes unix) et X-Oryon-Signature: v1=<hex>
- Vérifier par rapport à
- le corps brut, non parsé, de la requête
- Événements
- publish, update, delete, unpublish
Ce qui se passe quand vous cliquez sur Connecter
La connexion déclenche une véritable publication de test. SEOryon crée un brouillon, le vérifie, le supprime, et c'est seulement à ce moment-là qu'il marque la connexion comme saine, donc un badge connecté signifie que la publication fonctionne réellement.
Ce que vous pouvez faire une fois Webhook connecté
- Le payload complet : content_html et content_md, meta title et description, extrait, image mise en avant, étiquettes, URL canonique et langue.
- JSON-LD inclus : Article, plus FAQPage lorsque l'article comporte une FAQ visible, et le json_ld_graph connecté.
- Une mention d'auteur facultative.
- Publier, mettre à jour, supprimer et dépublier se synchronisent tous comme des événements distincts.
Ce qu'il faut savoir sur Webhook
La partie honnête. Chaque plateforme a ses limites, et vous devez en entendre parler par nous avant d'y être confronté.
Les tableaux sont désactivés pour un webhook générique. SEOryon ne peut pas contrôler la façon dont un receiver inconnu affiche le HTML, donc il envoie à la place une comparaison sous forme de liste à puces structurée.
Votre receiver doit vérifier le HMAC et agir sur les événements. Un receiver qui renvoie 200 sans rien faire discrètement paraît sain aux yeux de SEOryon, car il n'y a aucun moyen de le savoir de l'extérieur.
Les tableaux comparatifs ne se publient pas comme des tableaux sur Webhook, donc SEOryon envoie une liste à puces structurée à la place. Voir la matrice complète de support des tableaux.
À quoi ressemble la publication
Chaque article approuvé arrive à votre endpoint sous forme de payload JSON signé, avec le contenu, les métadonnées et les données structurées, prêt à être affiché par votre stack.
Le SEO sur Webhook
Les bonnes pratiques qui font la différence
Le payload contient tout ce dont un moteur de recherche a besoin. Assurez-vous que votre receiver l'utilise.
- Vérifiez la signature avant de faire confiance à un payload, puis agissez sur l'événement.
- Écrivez le meta title, la meta description et l'URL canonique du payload dans le head de votre template.
- Gérez aussi update, delete et unpublish, pas seulement publish, afin que les articles supprimés disparaissent réellement.
- Gardez des URL stables et faites correspondre sur le slug envoyé par SEOryon, car c'est ainsi que les mises à jour retrouvent le bon article.
- Affichez les blocs JSON-LD tels qu'ils arrivent, y compris FAQPage lorsque l'article comporte une FAQ visible.
Autres intégrations
Voyez-le sur votre propre site, gratuitement.
Démarrez l'essai gratuit de 3 jours et générez 3 vrais articles sur votre propre site avant de décider. Annulez avant le jour 3 et vous ne payez rien.
- Articles clé en main, chaque mois
- Construits sur vos vraies données SEO
- Publication directe vers votre CMS
- Conçus pour Google et la recherche IA
- Essai gratuit de 3 jours, annulable à tout moment