Webhooks

Os webhooks são uma forma de integração entre sistemas que permite o envio automático de informações de um aplicativo para outro em tempo real, sempre que um evento específico acontece. Essa ferramenta automatiza processos e conecta a plataforma a outras soluções que você utiliza no seu negócio, garantindo uma comunicação instantânea entre sistemas sempre que ocorrem ações importantes, como uma nova venda, atualização de status ou cancelamento de assinatura, sem a necessidade de consultas manuais ou processos adicionais.

Na Guru, você pode configurar webhooks de acordo com as necessidades da sua operação, definindo quais dados deseja enviar, para onde enviá-los e em que situações. Além disso, você pode:

• Criar múltiplos webhooks e configurá-los para enviar dados de assinaturas, e-tickets e vendas para seu app ou sistema próprio; e

• Configurar as regras para envio dos seus webhooks, como URL de destino, status para envio, produtos ou marketplaces aos quais deseja associar o webhook e número de envios simultâneos.

Após a configuração, o disparo acontece de forma automática assim que o evento ocorrer, mantendo suas integrações ativas, seus sistemas sincronizados e os fluxos operacionais funcionando sem intervenção manual.

Esse recurso é útil quando você precisa atualizar dados em outro sistema e/ou tomar uma ação conforme o status da assinatura, do e-ticket ou da venda em questão. Ele garante que o sistema de destino receba todas as informações necessárias de forma segura e organizada.

Como funciona o webhook

Quando uma assinatura, um e-ticket ou uma venda são atualizados, a Guru envia¹ uma requisição do tipo POST para a URL configurada contendo todos os dados relacionados ao elemento que sofreu a alteração.

Os dados são enviados em formato JSON e devem ser lidos e interpretados corretamente pela aplicação de destino. Consulte a documentação para desenvolvedores para saber mais.

O webhook apenas envia as informações. O sistema ou aplicação de destino é responsável por interpretar e tomar as ações necessárias de acordo com as informações recebidas no post.

Importante: a quantidade de webhooks enviados por cliente será simultaneamente de 40.

Podem ocorrer vários envios de uma mesma assinatura, um e-ticket ou venda mesmo que o status não tenha sido alterado, pois a mesma pode sofrer diferentes atualizações vindas do processador de pagamento.

Campos do checkout Guru enviados no Webhook:

• src no checkout = trackings.source no webhook;

• sck no checkout = trackings.checkout_source no webhook;

• utm_X no checkout = trackings.utm_X no webhook.

Tópicos Relacionados