Webhooks
Webhooks são o canal de comunicação em tempo real da plataforma. Eles representam tanto a forma como ouvimos o mundo exterior quanto a forma como falamos com as aplicações dos nossos clientes.
Webhooks de Entrada (Ingestão)
Muitos Drivers funcionam baseados em Webhooks. Fornecemos endpoints seguros e únicos para cada Instalação aceitar dados de provedores como Stripe ou Shopify.
- Validação de Assinatura: Verificamos criptograficamente cada request para garantir que veio do provedor real.
- Fila de Alta Performance: Recebemos o webhook e respondemos
200 OKinstantaneamente, processando o payload de forma assíncrona para evitar timeouts.
Webhooks de Saída (Entrega)
É assim que entregamos os Eventos processados e Payloads normalizados para o sistema do cliente.
- Política de Retry Robusta: Em caso de falha (status 5xx ou timeout), realizamos tentativas por até 24 horas com estratégia de exponential backoff.
- Controle de Fluxo (Circuit Breaker Manual): Se o seu sistema estiver sobrecarregado, você pode pausar o envio de webhooks temporariamente através da API (endpoint
installations/update). - Visibilidade Total: Logs completos de cada tentativa, incluindo request, response e status code, estão disponíveis na interface da aplicação (App UI) para depuração.