Webhooks: notificações em tempo real

O que são webhooks?

Webhooks são notificações HTTP enviadas pela plataforma quando eventos importantes acontecem. Ideal para integrar com n8n, Zapier, Make ou seu próprio sistema.

Eventos disponíveis

• purchase.created — Compra criada (bilhetes reservados)
• purchase.approved — Compra aprovada (pagamento confirmado)
• purchase.cancelled — Compra cancelada
• participant.created — Novo participante cadastrado
• raffle.finished — Sorteio encerrado/finalizado

Formato do payload

{
  "event": "purchase.approved",
  "timestamp": "2024-01-15T14:30:00Z",
  "data": {
    "id": "pur_abc123",
    "amount": 150.00,
    "currency": "BRL",
    "customer": {
      "name": "João Silva",
      "email": "joao@exemplo.com",
      "phone": "+5511999999999"
    },
    "raffle": {
      "id": "raf_def456",
      "name": "Sorteio de Natal"
    },
    "tickets": [
      { "number": "0001" },
      { "number": "0002" }
    ]
  }
}

Como configurar

Na aba "Webhook" das integrações, copie sua URL de webhook exclusiva e configure-a no seu sistema de automação. A URL tem o formato:

https://api.sorteios.app/webhooks/org_abc123