Webhook-Publishing

Voraussetzungen

So funktioniert die Webhook-Veröffentlichung

Der Webhook ist eine Zwei-Wege-Integration: ALLMEDIA schickt den Beitrag, der Kunden-Workflow veröffentlicht ihn und meldet das Ergebnis zurück.

Steht ein Beitrag zur Veröffentlichung an, sendet ALLMEDIA.AI einen POST-Request an die hinterlegte Webhook-URL. Nach der Verarbeitung muss der Workflow einen POST-Request an die im Paket mitgelieferte webhookUrl zurücksenden — erst dann gilt der Beitrag als veröffentlicht.

1 Verbindung anlegen

1. Kanalverbindungen öffnen

   Einstellungen → Veröffentlichung → Kanalverbindungen

2. Neue Verbindung starten

   Rechts oben auf „Kanal verbinden“ klicken, im Suchfeld Webhook eingeben und die Kachel Webhook — „Benutzerdefinierte Webhook-Integration“ anklicken.

   

3. Namen vergeben

   Im Feld Name einen sprechenden Namen eintragen, z. B. n8n Blog-Publishing. Der Name erscheint später im Kanal-Workflow.

4. Webhook-URL eintragen

   Im Pflichtfeld Webhook URL die Ziel-Adresse eintragen, an die die Beiträge gesendet werden — zum Beispiel https://n8n.example.com/webhook/allmedia-publish.

   

5. Format der Übertragung wählen

   Bestimmt, in welcher Form der Text übergeben wird:

   Option	Wann verwenden
   HTML (empfohlen)	Wird von Newsletter-Editoren und den meisten CMS korrekt dargestellt.
   Markdown (Originaltext)	Voreinstellung. Wenn der Zielworkflow Markdown selbst weiterverarbeitet.
   Reiner Text	Für Ziele ohne Formatierung, z. B. einfache Benachrichtigungen.

   

2 Experten-Einstellungen (optional, aber empfohlen)

Aufklappen über „Experten-Einstellungen“. Sobald etwas hinterlegt ist, zeigt der Abschnitt das Kennzeichen Konfiguriert.

1. API-Key-Authentifizierung

   Der ausgewählte API-Key wird als Header x-allmedia-api-key bei allen Webhook-Aufrufen mitgesendet. Damit kann der Workflow prüfen, dass die Anfrage wirklich von ALLMEDIA.AI kommt.

   Über „Neuen Key erstellen“ wird direkt hier ein Key angelegt (z. B. Webhook API Key (standard)). Er erscheint danach einmalig im Klartext, etwa amk_wh_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.

   Nur jetzt sichtbar. Den Key sofort sicher ablegen (Passwortmanager) — er kann nicht erneut angezeigt werden. Derselbe Key wird auch für den Callback zurück ins System benötigt.

   

2. Custom Headers

   Optionale HTTP-Header, die bei allen Webhook-Aufrufen mitgesendet werden — etwa Authorization: Bearer …, wenn der Zielendpoint eine eigene Authentifizierung verlangt. Header-Name und Wert eintragen und mit + hinzufügen.

3. Health-Check-Adresse

   Eigene Adresse für die wiederkehrende Erreichbarkeitsprüfung, z. B. https://n8n.example.com/webhook/health, dazu die Methode (Standard GET).

   Sie wird täglich automatisch geprüft und beim Verbindungstest mitgeprüft. Antwortet die Adresse mit einem Status unter 400, gilt die Verbindung als in Ordnung. Über „Health-Check-cURL kopieren“ lässt sich der passende Befehl zum Testen kopieren.

4. SEO & schema.org

   Optionale Zusatzfelder im gesendeten Paket:

   SEO-Felder mitsenden — ergänzt focus_keyword, meta_title und meta_description.
   FAQ-Auszeichnung — Nicht mitsenden (Standard) oder schema.org FAQPage.

   Die Felder werden zusätzlich im Paket übertragen; pro Beitrag kann davon abgewichen werden.

   

3 Verbindung testen und speichern

1. Verbindungstest ausführen

   Auf „Verbindung testen“ klicken. Der Test sendet ein Testpaket mit "debugMode": true an die konfigurierte Adresse — es wird kein echter Beitrag veröffentlicht.

   {
     "debugMode": true,
     "postId": "test-post-uuid",
     "title": "Testbeitrag",
     "content": "..."
   }

2. Alternative: manuell per cURL prüfen

   Über „cURL kopieren“ bzw. „Health-Check-cURL kopieren“ lassen sich die Befehle für beide Adressen kopieren. Der API-Schlüssel wird dabei nie eingesetzt, sondern nur als Platzhalter $ALLMEDIA_API_KEY ausgegeben.

   curl -X GET 'https://n8n.example.com/webhook/health'

3. Speichern

   Mit „Speichern“ abschließen. Die Verbindung erscheint in der Liste der Kanalverbindungen.

4 Verbindung einem Kanal zuweisen

Eine Kanalverbindung allein veröffentlicht noch nichts — sie muss im Workflow eines Kanals als Veröffentlichungsziel hinterlegt werden.

1. Kanal öffnen

   Einstellungen → Inhalte & Kanäle → Kanäle → gewünschten Kanal anklicken

2. Workflow-Modus öffnen

   Oben auf „Workflow“ klicken.

3. Veröffentlichung setzen

   In der Station „Veröffentlichung“ auf „Ändern“ klicken und die Webhook-Verbindung auswählen.

   

4. Testbeitrag durchlaufen lassen

   Einen Testbeitrag über den Kanal veröffentlichen und prüfen, ob der Workflow das Paket erhält und den Callback zurücksendet.

Ausgehender Request — was ALLMEDIA sendet

Wenn ein Beitrag zur Veröffentlichung ansteht, sendet ALLMEDIA.AI einen POST-Request an die Webhook-URL.

Headers

content-type: application/json
x-allmedia-global-api-key: global_xxx...     // nur zur Verifizierung, dass die Anfrage von ALLMEDIA.AI kommt
x-allmedia-workspace-id: b9b49b09-e583-4f84-8b06-c3e75f22576e

Body (JSON)

{
  "postId": "post-uuid",
  "title": "Mein Blogpost",
  "content": "Der Inhalt des Posts...",
  "channelId": "channel-uuid",
  "channelType": "facebook",
  "channelTitle": "Marketing Facebook Page",
  "workspaceId": "b9b49b09-e583-4f84-8b06-c3e75f22576e",
  "scheduledAt": "2024-01-15T10:00:00Z",
  "media": [
    {
      "id": "uuid",
      "url": "https://....supabase.co/storage/v1/object/public/media/...",
      "type": "image",
      "mimeType": "image/jpeg"
    }
  ],
  "webhookUrl": "https://....supabase.co/functions/v1/publishing-callback"
}

Das Feld media ist ein Array und kann mehrere Mediendateien enthalten. webhookUrl ist die Adresse, an die der Callback gesendet werden muss.

Optionale SEO- und schema.org-Felder

Sind die entsprechenden Experten-Einstellungen aktiv, enthält das Paket zusätzlich:

{
  "seo": {
    "focus_keyword": "content marketing",
    "meta_title": "Content Marketing 2026",
    "meta_description": "Kurzbeschreibung für Suchmaschinen"
  },
  "schema_org": {
    "@context": "https://schema.org",
    "@type": "FAQPage",
    "mainEntity": [
      { "@type": "Question", "name": "Frage?", "acceptedAnswer": { "@type": "Answer", "text": "Antwort." } }
    ]
  }
}

Callback — was zurückgemeldet werden muss

Headers

content-type: application/json
x-allmedia-api-key: am_xxxx...

{
  "postId": "uuid",
  "success": true,
  "publishedUrl": "https://facebook.com/posts/123456",
  "platform": "facebook",
  "externalId": "123456"
}

{
  "postId": "uuid",
  "success": false,
  "error": "Error description"
}

cURL-Beispiel

curl -X POST \
  'https://....supabase.co/functions/v1/publishing-callback' \
  -H 'content-type: application/json' \
  -H 'x-allmedia-api-key: am_xxxx...' \
  -d '{
    "postId": "post-uuid",
    "success": true,
    "publishedUrl": "https://example.com/post/123"
  }'

API-Key beschaffen

1. In ALLMEDIA zu Einstellungen → API Keys gehen (oder direkt im Webhook-Dialog unter Experten-Einstellungen → „Neuen Key erstellen“).
2. Einen neuen API-Key erstellen.
3. Den Key sicher speichern — er wird nur einmal angezeigt.

Feldreferenz

Fehlerbehebung