Zinn® Ads kan zijn gebeurtenissen naar uw eigen webhook-eindpunten verzenden, zodat Zapier, Make of uw eigen systeem er direct op kan reageren zodra ze plaatsvinden. De gebeurtenissen zijn ads.finding.opened, ads.change.applied, ads.alert.started.
Stel het in
- Open in het dashboard Meldingskanalen en voeg een webhook-eindpunt toe. Dit moet een HTTPS-adres zijn. We maken er een ondertekeningsgeheim voor aan en tonen dit eenmalig aan u.
- Verifieer het eindpunt: we sturen er één testverzoek naartoe, en het moet antwoorden met een 2xx-status.
- Open Zinn® Ads, zoek Webhooks voor Zapier, Make en uw eigen systemen, vink de gebeurtenissen aan die dat eindpunt moet ontvangen en kies Gebeurtenissen opslaan. Verzend een test stuurt één voorbeeld.
Wat er binnenkomt
Elke levering is een JSON POST. De headers X-Zinn-Event (de naam van de gebeurtenis) en X-Zinn-Delivery (één id per levering: negeer een levering die u al hebt verwerkt) worden meegeleverd, evenals X-Zinn-Signature: sha256=<hex>, een HMAC-SHA256 van <X-Zinn-Timestamp>.<raw body> gemaakt met het geheim van uw eindpunt. Controleer de handtekening en weiger een oude tijdstempel voordat u de body vertrouwt. De structuur van elke gebeurtenis is gepubliceerd in onze OpenAPI-specificatie onder webhooks.
Wanneer uw eindpunt offline is
Een mislukte levering wordt nog 5 keer opnieuw geprobeerd, na 1, 5, 25, 125, 625 minuten, en elke poging wordt vermeld in het leveringslogboek van het eindpunt. Er wordt niets verzonden naar een eindpunt dat niet is geverifieerd, en een lege reeks gebeurtenissen schakelt Zinn® Ads uit voor dat eindpunt.
Stapsgewijze handleiding
Bedien Zinn® Ads vanuit MCP en AI-assistenten op zinnads.com doorloopt het proces met schermafbeeldingen van de echte schermen. Elke Zinn® Ads-handleiding: zinnads.com/kb.