Webhooks

Base path: /v1/webhooks Os webhooks são endpoints que recebem eventos de sistemas externos (WhatsApp, Stripe, etc.) e os processam internamente.

Os endpoints abaixo representam a estrutura planejada. A implementação detalhada será gerada durante o desenvolvimento.

Método	Endpoint	Descrição
`POST`	`/v1/webhooks/whatsapp`	Receber eventos do WhatsApp Business API
`GET`	`/v1/webhooks/whatsapp`	Verificação do webhook (challenge)

Eventos Processados

Evento	Ação no Sistema
`message.received`	Registra mensagem no histórico, aciona triagem IA
`message.delivered`	Atualiza status de entrega da mensagem
`message.read`	Atualiza status de leitura da mensagem
`message.failed`	Registra falha de entrega

Stripe

Método	Endpoint	Descrição
`POST`	`/v1/webhooks/stripe`	Receber eventos do Stripe

Eventos Processados

Evento	Ação no Sistema
`invoice.paid`	Confirma pagamento, ativa/renova assinatura
`invoice.payment_failed`	Registra falha, notifica administrador
`customer.subscription.deleted`	Desativa conta do mandato
`customer.subscription.updated`	Atualiza plano do mandato

Os webhooks devem implementar validação de assinatura (signature verification) para garantir que os eventos recebidos são autênticos e não foram forjados.

Monitoramento

Introdução à API

Endpoints

Webhooks

Webhooks

WhatsApp

Eventos Processados

Stripe

Eventos Processados

​Webhooks

​WhatsApp

​Eventos Processados

​Stripe

​Eventos Processados

Webhooks

WhatsApp

Eventos Processados

Stripe

Eventos Processados