Integrationsanleitung
Artikel per Webhook an jedes Tool veröffentlichen
Läuft deine Website auf einer Plattform, mit der Rank Prompt sich nicht direkt verbindet, schickt ein Webhook-Ziel jeden Artikel vollständig und signiert an eine URL, die du kontrollierst: Zapier, Make, n8n oder dein eigener Code.
Rank Prompt liest
- Statuscode deines Endpoints
- published_url
- post_id
Rank Prompt sendet
- Titel und Slug
- HTML und Markdown
- SEO-Titel und Beschreibung
- Tags und Bilder
- JSON-LD
- Signatur-Header
Rank Prompt Was es macht
- Schickt den ganzen Artikel in einer Anfrage: Titel, Slug, HTML, Markdown, SEO-Titel und Beschreibung, Tags, Bilder, JSON-LD und die Marke.
- Sendet
article.publishedbeim Veröffentlichen,article.updatedmit derselbenpost_idbeim erneuten Veröffentlichen undarticle.unpublished, wenn du den Artikel entfernst. - Veröffentlicht sofort oder zum geplanten Datum.
- Signiert jede Anfrage mit
X-RP-Signatureund kann einen eigenen Header für Catch Hooks mitschicken, die einen prüfen. - Hält die
published_urlfest, die dein Endpoint antwortet, damit Seiten-Tracking und Zitationsberichte dem Artikel folgen.
Was sie nicht kann
- Entwürfe werden nicht gesendet: Ein Webhook kann keinen aufbewahren.
- Eine Anfrage trägt höchstens 4 MB.
- Rank Prompt schreibt nicht selbst in die Website; was nach der Anfrage passiert, bestimmt dein Workflow.
Bevor du startest
Tarif Ab Starter
- Eine https-URL, die auf einen POST mit 2xx antwortet: ein Catch Hook in Zapier, Make oder n8n oder dein eigener Endpoint.
- Einen Ort für das Signatur-Secret, falls dein Endpoint die Signatur prüft.
Webhook-Ziel: Einrichtung in 5 Schritten
-
Schritt 1
Öffne Integrationen, Content veröffentlichen
Öffne in Rank Prompt Integrationen und den Tab Content veröffentlichen. Klicke auf der Karte Weitere Plattformen auf +, wähle Webhook und klicke auf Weiter.
-
Schritt 2
URL einfügen und Secret sichern
Füge die Webhook-URL ein. Behalte das Signatur-Secret, das Rank Prompt erstellt hat, oder erzeuge ein neues, und kopiere es in deinen Endpoint. Füge einen Eigenen Header hinzu, wenn dein Catch Hook einen prüft; sein Wert wird verschlüsselt gespeichert und nie wieder angezeigt.
-
Schritt 3
Format wählen
Unter Format fügt JSON-LD im HTML die strukturierten Daten in den HTML-Text ein, und Front Matter im Markdown beginnt das Markdown mit YAML (Titel, Slug, Datum, Tags, Bild) für Static Site Generators.
-
Schritt 4
Verbinden und den Testartikel zuordnen
Klicke auf Webhook verbinden. Rank Prompt sendet zuerst ein signiertes
article.test, die URL muss also antworten, und dein No-Code-Tool kann die Felder daran zuordnen. -
Schritt 5
Antworte, wo der Artikel live ist
Antwortet dein Endpoint mit 2xx und JSON mit
published_url(optionalpost_id), wird diese URL als Adresse des Artikels festgehalten. Ohne sie gilt der Artikel als veröffentlicht, aber ohne URL.
Webhook-Ziel: Fehler und Lösungen
Das sind die Meldungen, die die App zeigt, Wort für Wort, und was jeweils hilft.
-
Die Webhook-URL muss mit https:// beginnen, weil der Artikel und seine Signatur darüber übertragen werden.
Nutze die https-Adresse deines Endpoints.
-
Diese URL löst nicht zu einer öffentlichen Adresse auf.
Nutze eine aus dem Internet erreichbare Adresse, keine lokale oder private.
-
Unter dieser URL hat nichts geantwortet (404). Prüfe die Adresse und ob der Workflow dahinter eingeschaltet ist.
Prüfe die Adresse und ob der Zap, das Szenario oder der Workflow eingeschaltet ist.
-
Der Webhook hat auf einen Testartikel mit 500 geantwortet.
Dein Endpoint hat den Test abgelehnt. Behebe das und verbinde erneut.
-
Ein eigener Header braucht einen Namen und einen Wert.
Fülle beides aus oder lass beides leer.
-
Die Webhook-URL zeigt jetzt auf einen anderen Host, daher muss der Wert des eigenen Headers neu eingegeben werden: Er wird nie an einen Host gesendet, für den er nicht eingegeben wurde.
Gib den Wert des Headers erneut ein oder lass beide Header-Felder leer.
-
Ein Webhook empfängt nur veröffentlichte Artikel und kann keinen Entwurf behalten. Veröffentliche den Artikel oder plane ihn.
Veröffentliche den Artikel sofort oder wähle ein Datum.
-
Dieser Artikel ist größer als die 4 MB, die eine Webhook-Anfrage tragen kann. Entferne die im Text eingebetteten Dateien und versuche es erneut.
Entferne die im Artikeltext eingebetteten Dateien und veröffentliche erneut.
Was ist der Unterschied zu den Rank Prompt Webhooks?
Ein Webhook-Ziel ist ein Ort, an dem Artikel veröffentlicht werden. Die Webhooks unter Developers melden deinen Tools, wenn Berichte und geplante Läufe fertig sind, und können an Slack oder Discord posten.
Wie prüfe ich, dass eine Anfrage von Rank Prompt kommt?
X-RP-Signature enthält t, einen Zeitstempel, und v1, einen HMAC-SHA256 aus Zeitstempel, Punkt und rohem Body, erzeugt mit deinem Signatur-Secret. Berechne ihn neu und vergleiche. X-RP-Event nennt das Ereignis.
Kann ich so auf Framer oder einem anderen CMS veröffentlichen?
Ja, über jedes Tool, das einen Webhook annimmt und in dieses CMS schreibt, etwa Zapier, Make oder n8n, oder über deinen eigenen Endpoint.
Welchen Tarif brauche ich?
Webhook-Ziele gibt es ab Starter für $49 im Monat, und einen Artikel an eines zu senden kostet keine Credits. Die Erstellung des Artikels kostet 10 Credits pro Artikel.
In wenigen Minuten startklar
Erstelle ein kostenloses Konto, folge den Schritten oben und sieh, was die Verbindung deiner KI-Sichtbarkeit bringt.