Documentação de Webhooks

Os webhooks da área de membros Naturaloz enviam eventos em JSON para URLs externas cadastradas no painel admin, usando rotas públicas sem o prefixo /public.

Campos de cadastro

Campo	Descrição
`name`	Nome interno do webhook.
`target_url`	Endpoint externo de recebimento.
`events`	Lista separada por vírgula dos eventos assinados.
`is_active`	Ativa ou desativa o disparo.

Payload base

{
  "event_id": "evt_20260421_0001",
  "event_name": "access.granted",
  "occurred_at": "2026-04-21T13:40:00-03:00",
  "source": "naturaloz-members",
  "data": {}
}

Payload exemplo

{
  "event_id": "evt_20260421_0002",
  "event_name": "comment.approved",
  "occurred_at": "2026-04-21T14:10:00-03:00",
  "source": "naturaloz-members",
  "data": {
    "comment_id": 501,
    "lesson_id": 121,
    "customer_id": 1,
    "status": "approved",
    "root_comment_id": 501,
    "depth": 0
  }
}

Resposta esperada

O endpoint receptor deve retornar 2xx para confirmar o recebimento. Falhas 4xx e 5xx devem ser tratadas com retry e registro de log.