Configurações dos Webhooks de Vendas

É possível configurar webhooks para sincronizar dados de vendas 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, tais como: URL de destino, status para envio, produtos ou marketplaces aos quais deseja associar o webhook e o número de envios simultâneos.

Nessa página:

• Webhooks sobre uma venda (pedido)

• Adicionar webhook de vendas

Antes de começar, você precisa…

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

Webhooks sobre uma Venda (pedido)

Você pode usar o webhook de vendas para receber uma notificação no sistema de destino toda vez que a venda 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 venda em questão, por exemplo: se a venda está cancelada (cartão não aprovado), seu time de recuperação de vendas deve contatar o cliente.

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

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

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 Vendas.

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 venda 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 um webhook por vez;

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

Filtragem de Registros

De acordo com o tipo de webhook, pode filtrar por: Todos, Marketplaces ou Produtos.

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

2. Enviar na atualização da transportadora: se deseja que o webhook também seja enviado quando é recebida alguma atualização da transportadora, mude o botão para a posição ligado;

3. 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 vendas que atendem aos critérios de filtragem indicados serão enviadas pelo webhook.

É possível ativar a opção “Enviar na atualização da transportadora” para enviar atualização do webhook sempre que receber dados de uma transportadora, como, por exemplo, código de rastreio ou alterações no estado de envio.

6 - Clique em Enviar.

A partir deste momento, cada venda 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 venda já existente para o webhook em questão.

Mais Recursos