Business OS recebe webhooks de provedores externos (Stripe, Pluggy). Pra integrações de saída (notificar seu sistema quando algo muda), use polling no POST /me ou considere o Cerebro Agent (que pode chamar webhooks externos via tool call).
Stripe (entrada)
Endpoint público: POST /webhook/stripe. Verificação via HMAC-SHA256 no header Stripe-Signature. Eventos processados:
checkout.session.completed· ativa assinaturacustomer.subscription.updated· atualiza plan/statuscustomer.subscription.deleted· cancela e volta pra freeinvoice.payment_failed· marca past_due
Pluggy (entrada)
Endpoint público: POST /webhook/pluggy. Verificação via HMAC-SHA256 · secret no header X-Pluggy-Signature. Eventos sincronizam transações e contas com o vault local.
Integração de saída · próximos passos
Webhooks de saída (Business OS → seu sistema) estão no roadmap. Por enquanto, use:
- Polling em endpoints específicos (ex:
POST /me/financas/transactions) - Cerebro Agent com tool call HTTP (descreva pro agente: "quando X acontecer, chame URL Y")
- MCP escrita + monitoramento do vault no seu lado
Veja também