Zinn® Ads kann seine Ereignisse an Ihre eigenen Webhook-Endpunkte senden, sodass Zapier, Make oder Ihr eigenes System im Moment ihres Auftretens darauf reagieren können. Die Ereignisse lauten ads.finding.opened, ads.change.applied, ads.alert.started.
Einrichtung
- Öffnen Sie im Dashboard Benachrichtigungskanäle und fügen Sie einen Webhook-Endpunkt hinzu. Es muss sich um eine HTTPS-Adresse handeln. Wir erstellen ein Signiergeheimnis dafür und zeigen es Ihnen einmalig an.
- Verifizieren Sie den Endpunkt: Wir senden eine Testanfrage an ihn, die mit einem 2xx-Status beantwortet werden muss.
- Öffnen Sie Zinn® Ads, suchen Sie Webhooks für Zapier, Make und Ihre eigenen Systeme, haken Sie die Ereignisse an, die dieser Endpunkt empfangen soll, und wählen Sie Ereignisse speichern. Test senden sendet ein Beispiel.
Was empfangen wird
Jede Zustellung ist ein JSON-POST. Die Header X-Zinn-Event (der Ereignisname) und X-Zinn-Delivery (eine ID pro Zustellung: verwerfen Sie eine Zustellung, die Sie bereits verarbeitet haben) werden mitgesendet, ebenso wie X-Zinn-Signature: sha256=<hex>, ein HMAC-SHA256 von <X-Zinn-Timestamp>.<raw body>, der mit dem Geheimnis Ihres Endpunkts erstellt wurde. Überprüfen Sie die Signatur und weisen Sie einen alten Zeitstempel ab, bevor Sie dem Inhalt vertrauen. Die Struktur jedes Ereignisses ist in unserer OpenAPI-Spezifikation unter webhooks veröffentlicht.
Wenn Ihr Endpunkt offline ist
Eine fehlgeschlagene Zustellung wird nach 1, 5, 25, 125, 625 Minuten noch 5 weitere Male wiederholt, und jeder Versuch wird im Zustellungsprotokoll des Endpunkts aufgeführt. An einen Endpunkt, der nicht verifiziert ist, wird nichts gesendet, und eine leere Auswahl an Ereignissen schaltet Zinn® Ads für diesen Endpunkt aus.
Schritt-für-Schritt-Anleitung
Zinn® Ads über MCP und KI-Assistenten steuern auf zinnads.com führt Sie mit Screenshots der realen Benutzeroberfläche durch den Ablauf. Alle Zinn® Ads-Anleitungen: zinnads.com/kb.