Eventos para seus sistemas

1. Quando usar

Use quando quiser notificar um sistema externo no momento em que uma conversão ou submissão de formulário nativo acontece no Brodalink.

• Business e Premium
• Não disponível em Free/Pro
• Não é conector HubSpot/Salesforce nativo

2. Como configurar

No app: Eventos → criar endpoint HTTPS → selecionar eventos → copiar o segredo de assinatura (só na criação) → Testar.

• Desativar ou revogar quando necessário
• Ver log de entregas por endpoint

3. Eventos suportados

Dois eventos outbound estão disponíveis. Cada endpoint pode assinar um ou ambos.

• conversion.created — conversão registrada (form nativo ou ingest externo)
• form.submission.created (v1) — submissão aceita em formulário nativo
• Sem respostas de campos, email, telefone, IP ou referrer em form.submission.created

4. Privacidade

Os payloads são allowlisted. Nunca incluem nome, email, telefone, respostas de campos, IP, user-agent bruto, cookies, secrets ou query string de referrer.

• form.submission.created: ids, atribuição (campaign/link/placement), UTM agregado, timestamps
• conversion.created: ids e contexto de atribuição — sem valores de campos do form

5. Segurança

Valide X-Brodalink-Signature e X-Brodalink-Timestamp com o segredo do endpoint. Prefer HTTPS. Segredo aparece só na criação.

• Auto-desativa após falhas repetidas
• Kill switch V2_FLAG_WEBHOOKS=false

6. Entrega, retry e idempotência

A primeira tentativa é imediata (assíncrona — não bloqueia o fluxo do usuário). Falhas agendam nextRetryAt; um worker processa novas tentativas com backoff. Use o idempotencyKey implícito (eventType:resourceId) para deduplicar no seu lado.

• Máximo de tentativas configurado no servidor
• Status e HTTP code persistidos por tentativa
• Falha de entrega não impede conversão/submissão no Brodalink

conversion.created (exemplo)

Envelope legado — sem campo version no topo.

{
  "eventType": "conversion.created",
  "occurredAt": "2026-08-22T18:00:00.000Z",
  "data": {
    "id": "conv_123",
    "type": "form_submission",
    "campaignId": "camp_1",
    "linkId": "link_1",
    "formId": "form_1",
    "formSubmissionId": "sub_1",
    "captureSource": "native_form",
    "occurredAt": "2026-08-22T18:00:00.000Z"
  }
}

form.submission.created v1 (exemplo)

Sem PII — apenas metadados operacionais.

{
  "eventType": "form.submission.created",
  "version": 1,
  "occurredAt": "2026-08-22T18:00:00.000Z",
  "data": {
    "id": "sub_1",
    "formId": "form_1",
    "campaignId": "camp_1",
    "linkId": "link_1",
    "placementId": "plc_1",
    "placementType": "inline",
    "clickEventId": "clk_1",
    "utmSource": "google",
    "utmMedium": "cpc",
    "utmCampaign": "launch",
    "occurredAt": "2026-08-22T18:00:00.000Z"
  }
}