Configurações dos Webhooks de Assinaturas

É possível configurar webhooks para sincronizar dados de assinaturas entre a Guru e aplicativos externos. Esse recurso pode ser utilizado para enviar dados para o seu app ou sistema próprio.

Na Guru, você pode adicionar webhooks e ajustar as regras de envio, garantindo que os dados das assinaturas sejam transmitidos de forma segura, padronizada e conforme a necessidade do seu sistema externo.

Nessa página:

• Webhooks sobre uma assinatura

• Adicionar webhook de assinaturas

Antes de começar, você precisa…

• Ser usuário administrador ou ter permissão para realizar as ações a seguir.

Webhooks sobre uma Assinatura

Você pode usar o webhook de assinaturas (cobranças recorrentes) para receber uma notificação no sistema de destino toda vez que a assinatura for atualizada e esta atender às condições configuradas no webhook.

Essa função é útil quando você precisa tomar uma ação¹ conforme o status da assinatura em questão, por exemplo: quando a assinatura for ativada, é necessário liberar o acesso do cliente no seu aplicativo.

A seguir você encontra a lista de tipos (gatilhos) de envio do webhook de assinaturas:

(1) O webhook da Guru apenas envia as informações da assinatura. 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.

Adicionar Webhook de Assinaturas

Você pode configurar webhooks no admin da Guru através das seguintes operações: adicionar, atualizar, desativar e remover. Todas as ações efetuadas são registradas pela plataforma e podem ser consultadas na seção Auditoria.

Consulte o limite de integrações¹ ativas (categoria webhooks) para o plano contratado. Caso tenha atingido o limite disponível, basta realizar um upgrade para a categoria Plus 2 ou Plus 3.

(1) Durante o período de testes, é permitido um máximo de 2 webhooks ativos.

Etapas:

1 - Acesse o admin da Guru com seu usuário e senha.

2 - No menu lateral, clique em Configurações e, em seguida, Webhooks.

3 - Em Webhooks, clique em Assinaturas.

4 - No canto superior direito, clique em Adicionar Webhook.

5 - Preencha as informações:

Dados Básicos

1. Nome: nome do seu webhook;

2. URL: URL de destino obtida no sistema em questão (ou com o desenvolvedor responsável).

Regras de Envio:

1. Envios Simultâneos: número máximo de envios simultâneos que a Guru deve realizar - indique um valor adequado a fim de evitar sobrecarregar o servidor de destino;

2. Status: para quais status da assinatura o envio do webhook deve ser realizado - você pode selecionar mais de um.

Por exemplo: se configurar o webhook para 5 envios simultâneos, caso sejam feitos 6 envios em simultâneo, o sexto envio é colocado em fila de espera com um atraso (delay) de 10 segundos.

Funil para envio dos Webhooks:

• URL de destino + id do objeto (transação ou assinatura) -> máximo de um webhook por vez;

• URL de destino -> máximo de webhooks simultâneos configurados.

Filtragem de Registros

1. Filtrar por: marcar filtrar por todos, Marketplaces ou Produtos⁽¹⁾;

2. Ativo: mude o botão para a posição ligado.

^{(1) Ao escolher filtrar por “todos” ou “marketplaces”, qualquer produto novo criado será associado ao webhook automaticamente.}

Se filtrar por Marketplaces ou Todos, sempre que criar um novo produto que cumpra com os requisitos o mesmo será associado aos webhooks correspondentes.

Somente as assinaturas que atendem aos critérios de filtragem indicados serão enviadas pelo webhook.

6 - Clique em Enviar.

A partir deste momento, cada assinatura atualizada que atender aos critérios definidos será enviada para a URL de destino.

(1) Se necessário, você pode fazer o envio manual de uma assinatura já existente para o webhook em questão.

Mais Recursos