Zinn® Ads puede enviar sus eventos a sus propios endpoints de webhook, de modo que Zapier, Make o su propio sistema puedan actuar sobre ellos en el momento en que ocurran. Los eventos son ads.finding.opened, ads.change.applied, ads.alert.started.
Configúrelo
- En el panel de control, abra Canales de notificación y añada un endpoint de webhook. Debe ser una dirección HTTPS. Creamos un secreto de firma para él y se lo mostramos una sola vez.
- Verifique el endpoint: le enviamos una solicitud de prueba, y debe responder con un estado 2xx.
- Abra Zinn® Ads, busque Webhooks para Zapier, Make y sus propios sistemas, marque los eventos que dicho endpoint debe recibir y elija Guardar eventos. Enviar una prueba envía un ejemplo.
Qué se recibe
Cada entrega es un POST en formato JSON. Incluye los encabezados X-Zinn-Event (el nombre del evento) y X-Zinn-Delivery (un id por entrega: descarte una entrega que ya haya procesado), así como X-Zinn-Signature: sha256=<hex>, un HMAC-SHA256 de <X-Zinn-Timestamp>.<raw body> generado con el secreto de su endpoint. Compruebe la firma y rechace una marca de tiempo antigua antes de confiar en el cuerpo. La estructura de cada evento está publicada en nuestra especificación OpenAPI bajo webhooks.
Cuando su endpoint está fuera de servicio
Una entrega fallida se reintenta 5 veces más, tras 1, 5, 25, 125, 625 minutos, y cada intento queda registrado en el historial de entregas del endpoint. No se envía nada a un endpoint que no esté verificado, y un conjunto vacío de eventos desactiva Zinn® Ads para dicho endpoint.
Guía paso a paso
Controle Zinn® Ads desde MCP y asistentes de IA en zinnads.com explica el proceso con capturas de pantalla reales. Todas las guías de Zinn® Ads: zinnads.com/kb.