Envie eventos do Zinn® Ads para o Zapier, o Make e seus próprios sistemas

O Zinn® Ads pode enviar seus eventos para seus próprios endpoints de webhook, permitindo que o Zapier, o Make ou seu próprio sistema ajam sobre eles no momento em que acontecem. Os eventos são ads.finding.opened, ads.change.applied, ads.alert.started.

Como configurar

1. No painel, abra Canais de notificação e adicione um endpoint de webhook. Ele deve ser um endereço HTTPS. Criaremos um segredo de assinatura para ele e o exibiremos a você apenas uma vez.
2. Verifique o endpoint: nós enviamos a ele uma solicitação de teste, e ele deve responder com um status 2xx.
3. Abra o Zinn® Ads, localize Webhooks para Zapier, Make e seus próprios sistemas, marque os eventos que esse endpoint deve receber e escolha Salvar eventos. O botão Enviar um teste envia um exemplo.

O que é recebido

Cada envio é um POST em formato JSON. Os cabeçalhos X-Zinn-Event (o nome do evento) e X-Zinn-Delivery (um ID por envio: descarte um envio que você já tenha processado) vêm com ele, assim como o X-Zinn-Signature: sha256=<hex>, um HMAC-SHA256 de <X-Zinn-Timestamp>.<raw body> gerado com o segredo do seu endpoint. Verifique a assinatura e rejeite um carimbo de data/hora antigo antes de confiar no corpo. A estrutura de cada evento está publicada em nossa especificação OpenAPI sob webhooks.

Quando seu endpoint estiver fora do ar

Um envio com falha é tentado novamente mais 5 vezes, após 1, 5, 25, 125 e 625 minutos, e cada tentativa é listada no registro de envios do endpoint. Nada é enviado para um endpoint que não esteja verificado, e um conjunto vazio de eventos desativa o Zinn® Ads para esse endpoint.

Guia passo a passo

O artigo Controlar o Zinn® Ads a partir do MCP e assistentes de IA no zinnads.com explica todo o processo com capturas de tela reais. Todos os guias do Zinn® Ads: zinnads.com/kb.