É possível configurar webhooks para sincronizar dados de pedidos 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 dos pedidos sejam transmitidos de forma segura, padronizada e conforme a necessidade do seu sistema externo.
Nessa página:
-
Webhooks sobre um pedido
-
Adicionar webhook de pedidos
Antes de começar, você precisa…
-
Ser usuário administrador ou ter permissão para realizar as ações a seguir.
Webhooks sobre um pedido
Você pode usar o webhook de pedidos para receber uma notificação no sistema de destino toda vez que o pedido for atualizado e atender às condições configuradas no webhook.
Essa função é útil quando você precisa tomar uma ação1 conforme o status do pedido em questão, por exemplo: se o pedido está cancelado (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 pedidos:
|
Tipo |
Enviado quando… |
|---|---|
|
Abandonado |
O pedido foi atualizado e possui o status |
|
Aguardando Pagamento |
O pedido foi atualizado e possui o status |
|
Aprovado |
O pedido foi atualizado e possui o status |
|
Atrasado |
O pedido foi atualizado e possui o status |
|
Bloqueado |
O pedido foi atualizado e possui o status |
|
Boleto Impresso |
O pedido foi atualizado e possui o status |
|
Cancelado |
O pedido foi atualizado e possui o status |
|
Completo |
O pedido foi atualizado e possui o status |
|
Em análise |
O pedido foi atualizado e possui o status |
|
Em Recuperação |
O pedido foi atualizado e possui o status |
|
Expirado |
O pedido foi atualizado e possui o status |
|
Reclamado |
O pedido foi atualizado e possui o status |
|
Reembolsado |
O pedido foi atualizado e possui o status |
|
Reembolso Sol. |
O pedido foi atualizado e possui o status |
|
Rejeitado |
O pedido foi atualizado e possui o status |
|
Trial |
O pedido foi atualizado e possui o status |
(1) O webhook da Guru apenas envia as informações do pedido. 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 Pedidos
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ções1 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 Pedidos.
4 - No canto superior direito, clique em Adicionar Webhook.
5 - Preencha as informações:
Dados Básicos
-
Nome: nome do seu webhook;
-
URL: URL de destino obtida no sistema em questão (ou com o desenvolvedor responsável).
Regras de Envio:
-
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;
-
Status: para quais status do pedido 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 pedido) -> máximo de um webhook por vez;
-
URL de destino -> máximo de webhooks simultâneos configurados.
Filtragem de Registros
-
Filtrar por: marcar filtrar por
todosouProdutos(1); -
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;
-
Ativo: mude o botão para a posição ligado.
(1) Ao escolher filtrar por “todos”, qualquer produto novo criado será associado ao webhook automaticamente.
Se filtrar por Todos, sempre que criar um novo produto que cumpra com os requisitos o mesmo será associado aos webhooks correspondentes.
Somente os pedidos que atendem aos critérios de filtragem indicados serão enviados 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 pedido atualizado que atender aos critérios definidos será enviado para a URL de destino.
(1) Se necessário, você pode fazer o envio manual de um pedido já existente para o webhook em questão.
Mais Recursos