Отправляйте события Zinn® Ads в Zapier, Make и собственные системы

Zinn® Ads может отправлять свои события на ваши собственные конечные точки веб-хуков, чтобы Zapier, Make или ваша собственная система могли реагировать на них сразу после их возникновения. Этими событиями являются ads.finding.opened, ads.change.applied, ads.alert.started.

Настройка

1. В панели управления откройте Каналы уведомлений и добавьте конечную точку веб-хука. Это должен быть адрес HTTPS. Мы создадим для нее секрет подписи и покажем его вам один раз.
2. Подтвердите конечную точку: мы отправим на нее один тестовый запрос, и она должна ответить статусом 2xx.
3. Откройте Zinn® Ads, найдите Веб-хуки для Zapier, Make и ваших собственных систем, отметьте события, которые должна получать эта конечная точка, и выберите Сохранить события. Функция Отправить тест отправляет один пример.

Что отправляется

Каждая доставка представляет собой запрос JSON POST. С ним передаются заголовки X-Zinn-Event (имя события) и X-Zinn-Delivery (один идентификатор на доставку: отклоняйте доставку, если вы уже ее обработали), а также X-Zinn-Signature: sha256=<hex> — HMAC-SHA256 от <X-Zinn-Timestamp>.<raw body>, созданный с использованием секрета вашей конечной точки. Проверьте подпись и отклоните старую метку времени, прежде чем доверять телу запроса. Структура каждого события опубликована в нашей спецификации OpenAPI в разделе webhooks.

Если ваша конечная точка недоступна

Неудачная доставка повторяется еще 5 раз через 1, 5, 25, 125, 625 минут, и каждая попытка фиксируется в журнале доставок конечной точки. На неподтвержденную конечную точку ничего не отправляется, а пустой набор событий отключает Zinn® Ads для этой конечной точки.

Пошаговое руководство

Материал Управление Zinn® Ads с помощью MCP и ИИ-ассистентов на zinnads.com подробно описывает весь процесс со снимками реальных экранов. Все руководства по Zinn® Ads: zinnads.com/kb.