Integrationsanleitung

Rank Prompt Webhooks einrichten

Schluss mit Polling. Rank Prompt ruft deinen Endpunkt auf, sobald ein Bericht oder ein geplanter Lauf fertig ist oder fehlschlägt, mit einer signierten Nutzlast, der dein Server vertrauen kann.

Kostenlos starten Funktion ansehen
Webhooks

Rank Prompt liest

  • Der Antwortcode deines Endpunkts

Rank Prompt sendet

  • Event-Typ und ID
  • Nutzlast des Berichts oder Laufs
  • HMAC-Signatur
  • Zustellungs-ID
Rank Prompt

Was es macht

  • Sendet report.completed, report.failed, schedule.run.completed und schedule.run.failed an deinen Endpunkt, pro Marke.
  • Signiert jede Zustellung per HMAC, damit du belegen kannst, dass sie von Rank Prompt kommt.
  • Wiederholt eine fehlgeschlagene Zustellung nach 30 Sekunden, 2 Minuten, 10 Minuten, 1 Stunde, 6 Stunden und 24 Stunden.
  • Rotiert das Signatur-Secret ohne Ausfall und deaktiviert einen Endpunkt nach 20 Fehlschlägen in Folge.
  • Postet auch an Slack oder Discord: Wähle den Zieltyp, und jedes Ereignis kommt als Nachricht an, geschrieben für den Kanal.
  • Abonniert für einen Marken-Endpunkt auch die Artikel-Ereignisse: article.published, article.updated und article.unpublished.
  • Sendet auf Wunsch eine Testzustellung, signiert wie eine echte, mit Antwort und Dauer direkt angezeigt.

Bevor du startest

Tarif Ab Starter

  • Einen öffentlichen HTTPS-Endpunkt auf deinem Server, der schnell mit einem 2xx-Code antwortet.
  • Einen sicheren Ort für das Signatur-Secret, etwa deinen Secret-Manager.
  • Bis zu 5 aktive Endpunkte pro Marke.
Einrichtung

Webhooks: Einrichtung in 4 Schritten

  1. Schritt 1

    Entwickler, Webhooks öffnen

    Öffne in Rank Prompt Entwickler, wähle den Tab Webhooks und die Marke.

    Der Tab Webhooks der Entwickler-API-Seite mit der Markenauswahl und der Schaltfläche Neuer Webhook.

  2. Schritt 2

    Deinen Endpunkt hinzufügen

    Klicke auf Neuer Webhook, gib die https-URL ein und wähle die Events, die er erhalten soll.

  3. Schritt 3

    Das Signatur-Secret sichern

    Kopiere das Secret auf deinen Server. Jede Zustellung trägt X-RP-Signature mit einem Zeitstempel und einer v1-Signatur; berechne sie über den rohen Body neu und vergleiche.

  4. Schritt 4

    Zustellungen verarbeiten

    Antworte schnell mit einem 2xx und erledige danach die Arbeit. Nutze X-RP-Event-Id, um eine Wiederholung zu ignorieren, die du schon verarbeitet hast.

Fehlerbehebung

Webhooks: Fehler und Lösungen

Das sind die Meldungen, die die App zeigt, Wort für Wort, und was jeweils hilft.

  • Das Maximum von 5 aktiven Webhooks pro Marke wurde erreicht.

    Deaktiviere oder lösche einen Endpunkt, den du nicht mehr nutzt, oder schicke mehrere Event-Typen an einen Endpunkt.

  • Wir haben den Webhook für Mercari (Signiertes JSON, b3f1c2d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d) nach 20 aufeinanderfolgenden fehlgeschlagenen Zustellungen deaktiviert. Behebe den Endpunkt und aktiviere ihn wieder, um die Events fortzusetzen.

    Sorge dafür, dass der Endpunkt wieder mit 2xx antwortet, und aktiviere ihn im Tab Webhooks wieder. Verworfene Zustellungen lassen sich dort erneut senden.

Alle Integrationen

FAQ

Häufige Fragen: Webhooks

Noch Fragen? Schreib unserem Team

Welche Events kann ich abonnieren?

report.completed, report.failed, schedule.run.completed und schedule.run.failed, dazu article.published, article.updated und article.unpublished, pro Marke. Mit Agency Plus kann der Kontoinhaber zusätzlich Endpunkte auf Kontoebene für lead.created, lead.report_ready, lead.report_failed und lead.claimed anlegen, unter Developers, Webhooks, Konto (/developers?tab=webhooks&scope=account).

Was passiert, wenn mein Endpunkt ausfällt?

Die Zustellung wird sechsmal über etwa einen Tag wiederholt: nach 30 Sekunden, 2 Minuten, 10 Minuten, 1 Stunde, 6 Stunden und 24 Stunden. Nach 20 Fehlschlägen in Folge wird der Endpunkt deaktiviert, bis du ihn wieder einschaltest.

Wie prüfe ich eine Zustellung?

Berechne den HMAC aus Zeitstempel und rohem Body mit deinem Signatur-Secret neu und vergleiche ihn mit der Signatur in X-RP-Signature. Die Entwicklerdokumentation enthält Code dafür.

Welchen Tarif brauche ich?

Webhooks starten mit Starter für $49 im Monat oder kommen mit einem eigenständigen API-Tarif.

Kann ich Ereignisse an Slack oder Discord senden?

Ja. Wähle Slack oder Discord als Zieltyp und füge die Incoming-Webhook-URL des Kanals ein: Jedes Ereignis kommt als Nachricht für diesen Kanal an, in der Sprache des Inhabers.

Wie teste ich einen Endpunkt?

Klicke beim Endpunkt auf Test senden. Der Test ist wie eine echte Zustellung signiert, trägt test: true, zählt nie zur automatischen Deaktivierung und zeigt Antwort und Dauer deines Endpunkts. Ein Replay aus dem Zustellprotokoll sendet eine neue Zustellung mit neuer Delivery-ID und derselben Event-ID und demselben Body wie die erste.

Veröffentliche ich so Artikel in Zapier oder Make?

Nein, dafür gibt es das Webhook-Ziel: Es schickt beim Veröffentlichen den ganzen Artikel signiert und hält fest, wo er live ging. Die Webhooks hier melden deinen Tools, dass etwas passiert ist.

In wenigen Minuten startklar

Erstelle ein kostenloses Konto, folge den Schritten oben und sieh, was die Verbindung deiner KI-Sichtbarkeit bringt.

Kostenlos starten Preise ansehen