Webhooks

Webhooks senden bei jedem Ereignis in Serpfull einen HTTPS-POST an Ihren Server. Verwalten Sie sie unter Integrationen → Webhooks (Eigentümer und Administratoren). Für das Nutzlastformat, Header und Verifizierungscode siehe die Webhooks API-Referenz.

Endpunkt hinzufügen

• Öffnen Sie Integrationen → Webhooks und drücken Sie Endpunkt hinzufügen.
• Geben Sie eine öffentliche HTTPS-URL auf Port 443 ein. Private, interne, Loopback-, Link-Local- und Cloud-Metadaten-Adressen werden abgelehnt (wir prüfen jede Adresse, auf die der Host aufgelöst wird, beim Speichern und bei jeder Zustellung erneut), und Weiterleitungen werden nicht verfolgt.
• Fügen Sie eine optionale Beschreibung hinzu, wählen Sie die abgedeckten Websites aus (alle Websites, einschließlich zukünftiger, oder ausgewählte) und markieren Sie die zu sendenden Ereignisse.
• Kopieren Sie das nach dem Speichern angezeigte Signatur-Geheimnis. Sie können es erneut in der Endpunkt-Karte anzeigen oder rotieren.

Mehrere Endpunkte

Fügen Sie so viele Endpunkte hinzu, wie Ihr Plan erlaubt (der beste Plan über Ihre Websites hinweg): Kein Plan 2, Starter 3, Growth 5, Scale 10, Pro 25, Enterprise 50. Jeder hat sein eigenes Geheimnis, Websites und Ereignisse und kann deaktiviert werden, ohne gelöscht zu werden.

Pro Website

Ereignisse zu einer Website gehen nur an Endpunkte, die diese abdecken. Das Deaktivieren der Webhooks-Integration für eine Website pausiert deren Ereignisse überall, ohne Ihre Endpunkte zu beeinflussen. Organisationsevents (Abrechnung) gehen an jeden Endpunkt, der dafür abonniert ist.

Testen, protokollieren und erneut zustellen

Testereignisse senden eine test.ping an diesen Endpunkt. Das Zustellungsprotokoll speichert 30 Tage lang Versuche mit Ereignis, Statuscode oder Fehler, Dauer, Versuchszahl sowie Anforderungs- und Antwortkörpern (gekürzt). Filtern Sie nach Endpunkt, Ereignis oder Ergebnis und drücken Sie Erneut zustellen, um ein Ereignis mit neuen Versuchen erneut zu senden.

Wiederholungen und Deaktivierung

Antworten Sie mit einem beliebigen 2xx innerhalb von 10 Sekunden. Andernfalls wiederholen wir nach 1 Minute, 5 Minuten, 30 Minuten, 2 Stunden, 6 Stunden, 12 Stunden und 24 Stunden (8 Versuche, ca. 45 Stunden). Antworten Sie mit 410 Gone, um das Wiederholen dieses Ereignisses zu stoppen. Wenn ein Endpunkt 3 Tage lang (und mindestens 10 Versuche in Folge) fehlschlägt, schalten wir ihn aus, verwerfen seine Warteschlange und benachrichtigen Ihr Team in der App. Die Webhooks-Integration zeigt dann „Benötigt Aufmerksamkeit“. Beheben Sie den Empfänger und schalten Sie den Endpunkt wieder ein.

Rotation des Geheimnisses

Geheimnis rotieren gibt Ihnen sofort ein neues Geheimnis. Für die nächsten 24 Stunden wird jede Anfrage mit dem neuen und dem alten Geheimnis signiert (zwei v1-Werte), sodass Sie Ihren Empfänger aktualisieren können, ohne Ereignisse zu verlieren.

Von einem Assistenten

Der KI-Connector verfügt über webhooks_list_endpoints, webhooks_create_endpoint, webhooks_update_endpoint, webhooks_delete_endpoint, webhooks_send_test, webhooks_list_deliveries und webhooks_redeliver. Geheimnisse werden nur im Dashboard angezeigt.