Webhook mit SEOryon verbinden
Für Teams mit eigenem Stack. SEOryon sendet per POST ein HMAC-signiertes JSON-Payload an deinen Endpunkt, bei Veröffentlichen, Aktualisieren, Löschen und Veröffentlichung zurücknehmen, und dein Code entscheidet, was als Nächstes passiert.
- So funktioniert die Verbindung
- HMAC-signiertes JSON (oryon-v1), per POST an deinen Endpunkt gesendet
- Nach der Veröffentlichung bearbeiten
- Ja, Aktualisierungen veröffentlichen denselben Beitrag erneut
- Löschen und zurückziehen
- Ja, aus SEOryon heraus
- Tabellen
- Nein. SEOryon sendet stattdessen eine strukturierte Aufzählungsliste.
Bevor du dich verbindest
Richte das zuerst ein. Das ist der Unterschied zwischen einer Verbindung, die grün wird, und einer, die bei der ersten Veröffentlichung scheitert.
- Ein live erreichbarer HTTPS-Endpunkt, der die Signatur prüft und auf die Events reagiert.
- Ein sicherer Ort, um das Signing Secret zu speichern.
- Ein Entwickler, der es einrichtet. Receiver-Codebeispiele in Node, PHP und Python werden bereitgestellt.
So verbindest du dich, Schritt für Schritt
Dieselben Schritte, die dir SEOryon in der App zeigt. Das läuft komplett in SEOryon ab, es gibt also nichts in einem anderen Adminbereich zu suchen.
- 1
Öffne in SEOryon Settings, Integrations, Webhook und klicke auf Generate, um dein 32-Byte-Signing-Secret zu erstellen.
- 2
Kopiere den fertigen Prompt in Claude Code, Cursor oder Codex, und er baut den Receiver. Das vollständige Payload und das Signatur-Spec unten sind bereits in den Prompt eingebaut, es gibt also sonst nichts zu übergeben. Es selbst zu schreiben funktioniert genauso gut, in Node, PHP oder Python.
- 3
Richte SEOryon auf deine Endpunkt-URL. Es sendet ein Test-Event und prüft die Antwort, bevor die Verbindung als funktionsfähig markiert wird.
Der Signaturvertrag
- Signing Secret
- 32 Byte, in SEOryon generiert und von dir gespeichert
- Signatur
- HMAC-SHA256 aus timestamp + "." + raw_request_body, unter Verwendung des gemeinsamen Secrets
- Headers
- X-Oryon-Timestamp (Unix-Sekunden) und X-Oryon-Signature: v1=<hex>
- Prüfen gegen
- den rohen, ungeparsten Request Body
- Events
- publish, update, delete, unpublish
Was passiert, wenn du auf Verbinden klickst
Beim Verbinden läuft eine echte Testveröffentlichung. SEOryon erstellt einen Entwurf, prüft ihn, löscht ihn, und markiert die Verbindung erst danach als funktionsfähig, sodass ein Badge Verbunden bedeutet, dass die Veröffentlichung wirklich funktioniert.
Was du tun kannst, sobald Webhook verbunden ist
- Das vollständige Payload: content_html und content_md, Meta-Titel und -Beschreibung, Excerpt, Beitragsbild, Tags, Canonical-URL und Sprache.
- JSON-LD enthalten: Article, plus FAQPage, wenn der Artikel eine sichtbare FAQ hat, und der verbundene json_ld_graph.
- Eine optionale Autorenzeile.
- Veröffentlichen, Aktualisieren, Löschen und Veröffentlichung zurücknehmen werden alle als separate Events synchronisiert.
Was du über Webhook wissen solltest
Der ehrliche Teil. Jede Plattform hat ihre Grenzen, und die solltest du von uns hören, bevor du sie zu spüren bekommst.
Tabellen sind bei einem generischen Webhook deaktiviert. SEOryon kann nicht kontrollieren, wie ein unbekannter Receiver HTML rendert, daher sendet es stattdessen einen strukturierten Aufzählungslisten-Vergleich.
Dein Receiver muss den HMAC prüfen und auf die Events reagieren. Ein Receiver, der 200 zurückgibt und im Stillen nichts tut, wirkt für SEOryon funktionsfähig, weil sich das von außen nicht erkennen lässt.
Vergleichstabellen werden auf Webhook nicht als Tabellen veröffentlicht, SEOryon sendet stattdessen eine strukturierte Aufzählungsliste. Die vollständige Tabellen-Support-Matrix ansehen.
So sieht die Veröffentlichung aus
Jeder freigegebene Artikel kommt an deinem Endpunkt als signiertes JSON-Payload an, mit Inhalt, Metadaten und strukturierten Daten, bereit zum Rendern durch deinen Stack.
SEO auf Webhook
Best Practices, die wirklich etwas bewirken
Das Payload enthält alles, was eine Suchmaschine braucht. Stelle sicher, dass dein Receiver es nutzt.
- Prüfe die Signatur, bevor du einem Payload vertraust, und reagiere dann auf das Event.
- Schreibe Meta-Titel, Meta-Beschreibung und Canonical-URL aus dem Payload in den head deines Templates.
- Behandle auch Aktualisieren, Löschen und Veröffentlichung zurücknehmen, nicht nur Veröffentlichen, damit entfernte Beiträge wirklich verschwinden.
- Halte URLs stabil und gleiche sie mit dem von SEOryon gesendeten Slug ab, denn so finden Aktualisierungen den richtigen Beitrag.
- Rendere die JSON-LD-Blöcke so, wie sie ankommen, einschließlich FAQPage, wenn der Artikel eine sichtbare FAQ enthält.
Weitere Integrationen
Sieh es auf deiner eigenen Website, kostenlos.
Starte den 3-tägigen Gratistest und generiere 3 echte Artikel auf deiner eigenen Website, bevor du dich entscheidest. Kündige vor Tag 3 und du zahlst nichts.
- Fertige Artikel, monatlich
- Basiert auf deinen echten SEO-Daten
- Veröffentlicht direkt in dein CMS
- Gebaut für Google und KI-Suche
- 3 Tage kostenlos testen, jederzeit kündbar