Was sendet der pantra.io-Webhook genau?

Bei jeder Veröffentlichung sendet pantra.io einen POST-Request mit einem JSON-Body an deine Webhook-URL. Der Body enthält die Felder event, publish, title, slug, html, excerpt, meta_description, og_image_url und tags. Dein System entscheidet, wie es diese Daten weiterverarbeitet.

Wofür eignet sich der generische Webhook?

Der Webhook ist die flexible Brücke für alles, was keine fertige Integration hat: eigene Systeme, ein selbst gebautes CMS, statische Site-Generatoren oder Automatisierungsplattformen. Zapier und Make binden sich ebenfalls über diesen Webhook an, sodass du damit praktisch jedes Zieltool erreichst.

Was bedeutet das Feld publish im Payload?

Das Feld publish ist ein Wahrheitswert, der angibt, ob der Artikel direkt live gehen soll (true) oder als Entwurf behandelt werden soll (false). Dein Empfänger kann darauf reagieren, zum Beispiel indem er den Beitrag nur bei publish true sofort veröffentlicht.

Integrationen/Webhook

Generischer Webhook für dein eigenes System

pantra.io sendet bei jeder Veröffentlichung einen JSON-POST an deine URL, optional mit HMAC-SHA256 signiert. Die flexible Brücke zu jedem eigenen CMS, zu Zapier und zu Make.

TL;DR

Der generische Webhook ist die flexible Brücke zu jedem System. Bei jeder Veröffentlichung sendet pantra.io einen POST mit JSON (Felder: event, publish, title, slug, html, excerpt, meta_description, og_image_url, tags), optional signiert mit HMAC-SHA256 im Header X-Pantra-Signature. Du legst eine Webhook-URL im Zielsystem an, trägst sie samt optionalem Secret in pantra.io ein, testest und verbindest. Dein Empfänger kann optional die finale Live-URL zurückgeben.

Was macht der generische Webhook?

Der Webhook sendet bei jeder Veröffentlichung einen HTTP-POST mit einem JSON-Body an eine URL deiner Wahl. Damit kannst du den fertigen GEO-Content in jedes eigene System schieben, das POST-Requests entgegennimmt. Er ist auch die technische Basis für die Zapier- und die Make-Integration.

Ein Webhook ist der einfachste Weg, zwei Systeme zu verbinden: Sobald ein Ereignis eintritt, hier eine Veröffentlichung, ruft pantra.io deine URL auf und übergibt die Daten im Body. Dein System entscheidet dann selbst, was damit passiert.

Das macht den Webhook zur universellen Option: für ein selbst gebautes CMS, für statische Site-Generatoren oder als Brücke zu Automatisierungsplattformen wie Zapier und Make.

Wie sieht das JSON-Payload aus?

Der Body ist ein JSON-Objekt mit den Feldern event, publish, title, slug, html, excerpt, meta_description, og_image_url und tags. Das Feld html enthält den fertigen Artikel, das Feld publish steuert, ob er live gehen oder als Entwurf behandelt werden soll.

POST-Payload von pantra.io

POST https://dein-system.ch/hooks/pantra
Content-Type: application/json
X-Pantra-Signature: sha256=6f2b...ac91   // nur wenn Secret gesetzt

{
  "event": "post.published",
  "publish": true,
  "title": "Wie du in ChatGPT sichtbar wirst",
  "slug": "wie-du-in-chatgpt-sichtbar-wirst",
  "html": "<h2>Kurzantwort</h2><p>...</p>",
  "excerpt": "Kurzer Anriss des Artikels.",
  "meta_description": "Meta-Beschreibung unter 160 Zeichen.",
  "og_image_url": "https://cdn.pantra.io/og/abc.png",
  "tags": ["geo", "chatgpt", "sichtbarkeit"]
}

Die einzelnen Felder im Überblick:

eventArt des Ereignisses, zum Beispiel post.published.

publishWahrheitswert: soll der Artikel live gehen (true) oder als Entwurf behandelt werden (false)?

titleDer Titel des Artikels.

slugDer URL-freundliche Kurzname für den Beitrag.

htmlDer fertige Artikelinhalt als HTML, inklusive Antwort-Kapseln und FAQ.

excerptEin kurzer Anriss oder Teaser des Artikels.

meta_descriptionDie Meta-Beschreibung für die Suchmaschinen-Vorschau.

og_image_urlDie URL des Vorschaubildes für Social- und Link-Previews.

tagsEine Liste von Schlagworten zum Artikel.

Wie stelle ich sicher, dass der Request echt ist?

Hinterlege ein Signatur-Secret. Dann signiert pantra.io jeden Request mit HMAC-SHA256 und legt die Signatur in den Header X-Pantra-Signature im Format sha256=... . Dein Empfänger berechnet dieselbe Signatur über den Rohbody und vergleicht die Werte. Stimmen sie überein, ist der Request authentisch.

Die Signaturprüfung ist optional, aber empfohlen, wenn dein Endpunkt öffentlich erreichbar ist. So verhinderst du, dass fremde Requests deinen Publish-Flow auslösen. Das Secret kennst nur du und pantra.io.

Webhook in pantra.io einrichten

In vier Schritten ist der Webhook verbunden.

Webhook-URL im Zielsystem erzeugen

Lege in deinem Zielsystem eine Adresse an, die POST-Requests entgegennimmt. Das kann ein eigener Endpunkt, ein Serverless-Handler oder ein Catch-Hook einer Automatisierungsplattform sein.

In pantra.io Webhook wählen

Gehe in pantra.io in das GEO-Setup zum Abschnitt Wo dein Content erscheint und wähle Webhook als Ziel.

URL und optionales Secret eintragen

Trage deine Webhook-URL ein. Optional hinterlegst du ein Signatur-Secret, damit pantra.io jeden Request mit HMAC-SHA256 signiert.

Testen und verbinden

Klicke auf Testen. pantra.io sendet einen Test-POST an deine URL. War die Antwort erfolgreich, bestätige mit Verbinden.

Kann mein System die Live-URL zurückmelden?

Ja. Dein Empfänger kann optional ein JSON mit dem Feld url zurückgeben, also die finale Live-URL des veröffentlichten Artikels. pantra.io speichert diese URL und nutzt sie zum Beispiel für interne Verlinkung und für die Erfolgsmessung.

Optionale Antwort deines Systems

// Optionale Antwort deines Systems (HTTP 200)
{
  "url": "https://deine-domain.ch/blog/wie-du-in-chatgpt-sichtbar-wirst"
}

Brücke zu Zapier und Make

Du musst keinen eigenen Endpunkt bauen. Über den Webhook binden sich auch Zapier und Make an. Beide bieten einen Catch-Hook, dessen URL du einfach in pantra.io einträgst.