Os Webhooks permitem que o CaptiveWeb envie notificações em tempo real para qualquer URL quando eventos importantes acontecem.

1. Configurar Webhook

  1. Acesse Integrações → Webhooks

    No painel, vá em Configurações → Integrações → Webhooks.

  2. Adicione a URL

    Informe a URL HTTPS que receberá as notificações.

  3. Selecione os eventos

    Escolha quais eventos ativarão o webhook.

  4. Salve e teste

    Clique em "Testar webhook" para enviar um evento de teste.

2. Eventos disponíveis

EventoQuando dispara
user.registeredNovo usuário se cadastra no portal
session.startedSessão Wi-Fi iniciada (autenticação ok)
session.endedSessão Wi-Fi encerrada
payment.confirmedPagamento confirmado
payment.expiredPlano vencido
voucher.usedVoucher utilizado

3. Exemplo de payload

{
  "event": "user.registered",
  "timestamp": "2026-05-04T14:30:00Z",
  "location_id": "loc_abc123",
  "data": {
    "user_id": "usr_xyz789",
    "name": "João Silva",
    "email": "joao@email.com",
    "phone": "+5511999999999",
    "mac_address": "AA:BB:CC:DD:EE:FF"
  }
}
ℹ️
SegurançaValide o header X-CaptiveWeb-Signature para garantir que o webhook veio do CaptiveWeb. A assinatura é um HMAC-SHA256 do payload com sua chave secreta.