Pular para o conteúdo

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 OK instantaneamente, 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.