Webhooks — Receba notificações em tempo real

Webhooks da plataforma

Webhooks permitem que a P8W notifique seus sistemas externos automaticamente quando eventos ocorrem, eliminando a necessidade de polling.

Eventos disponíveis

Usuários

• user.created — Novo usuário cadastrado.
• user.updated — Dados do usuário alterados.
• user.deleted — Usuário excluído.
• user.login — Login realizado.
• user.password.changed — Senha alterada.

Pagamentos

• invoice.created — Nova fatura gerada.
• invoice.paid — Pagamento confirmado.
• invoice.overdue — Fatura vencida.
• subscription.created — Nova assinatura.
• subscription.cancelled — Assinatura cancelada.

CRM e Marketing

• contact.created — Novo contato adicionado.
• deal.stage.changed — Negócio mudou de estágio.
• campaign.sent — Campanha enviada.
• form.submitted — Formulário preenchido.

Sistema

• plugin.activated — Plugin ativado.
• plugin.deactivated — Plugin desativado.
• tenant.created — Novo tenant criado.

Configurar um webhook

1. Acesse Configurações → Integrações → Webhooks.
2. Clique em "+ Novo Webhook".
3. Informe a URL de destino (HTTPS obrigatório em produção).
4. Selecione os eventos que deseja receber.
5. Opcionalmente, configure um header de autenticação personalizado.
6. Envie um evento de teste para verificar a integração.
7. Ative o webhook.

Verificação de assinatura

Cada webhook inclui o header X-Webhook-Signature com hash HMAC-SHA256. Verifique essa assinatura no seu servidor para garantir que a requisição veio da P8W e não foi alterada.

Retentativas

Se o seu endpoint retornar erro (status ≥ 400) ou timeout, a P8W reenvia automaticamente:

• 1ª tentativa: imediatamente.
• 2ª tentativa: após 5 minutos.
• 3ª tentativa: após 30 minutos.
• 4ª tentativa: após 2 horas.
• 5ª tentativa: após 24 horas.

Após 5 falhas consecutivas, o webhook é desativado automaticamente com notificação ao administrador.