Webhooks

Entendendo o que são Webhooks

Webhooks são uma tecnologia que permite o recebimento de informações em tempo real entre dois sistemas diferentes sempre que um evento específico ocorre.

Na prática, um webhook oferece um meio de comunicação passiva, onde uma plataforma automaticamente envia dados para outra aplicação assim que determinadas condições são atendidas.

Essa ferramenta é extremamente útil para desenvolvedores e empresas que desejam personalizar e automatizar as interações entre diferentes sistemas e serviços online.

Com webhooks, é possível definir precisamente quais eventos em um sistema irão disparar ações específicas em outro, proporcionando uma integração mais dinâmica e responsiva.

Além disso, os webhooks são frequentemente referidos como Callbacks ou Reverse API, destacando sua capacidade de enviar dados para outras aplicações sem a necessidade de solicitações prévias do receptor.

Como Funcionam os Webhooks?

Webhooks são mecanismos que permitem a sistemas externos receber notificações automáticas sobre eventos que ocorrem em outro sistema.

O processo funciona da seguinte maneira:

1. Evento Disparador: quando um evento específico acontece em um sistema, este sistema prepara para enviar uma notificação.

2. Requisição HTTP POST: o sistema gera automaticamente uma requisição HTTP POST contendo informações detalhadas sobre o evento e envia para a URL previamente configurada no webhook.

3. Execução de Tarefas: o sistema receptor da notificação, ao receber esses dados, pode então executar uma série de tarefas conforme programado, dependendo do tipo de integração estabelecida e dos objetivos específicos dessa integração.

Este método de comunicação é eficaz por ser direto e permitir uma resposta imediata a eventos, facilitando interações dinâmicas entre plataformas distintas.

Configurando Webhooks na iSET

Para iniciar a configuração de webhooks na sua loja virtual iSET, siga estes passos:

1- Acesso ao Painel de Controle: primeiro, acesse o painel de controle da sua loja virtual.

2- Navegação até a Seção de Integrações: em seguida, clique em Integrações >> API & Webhooks.

3- Acessar a Configuração de Webhooks

Depois de navegar até a seção de API & Webhooks, clique em Webhooks para prosseguir com a configuração.

É essencial que a API REST esteja ativa para sua loja virtual. Uma API (Interface de Programação de Aplicações) funciona como um ponto de entrada e saída de dados, permitindo que outros sistemas interajam com sua loja de maneira eficiente.

APIs possibilitam que sistemas distintos, com diferentes propósitos e desenvolvidos por diferentes pessoas ou empresas, comuniquem-se de forma simples e direta.

Na tela Webhooks, você terá a opção de definir endereços específicos para cada tipo de ação que deseja ser notificado. É possível configurar mais de uma URL de serviço para cada grupo de ações, ampliando a flexibilidade e a capacidade de integração do seu sistema.

Pedidos

É recomendável que o endereço que receberá a requisição HTTP POST de notificação do evento seja um endereço que use SSL, ou seja, que inicie com https://.

Serão enviadas todas as alterações e criação de novos pedidos, seja pelo painel administrativo (manual) ou pelo catálogo.

A- Pedido/Checkout Iniciado: configure um webhook para ser notificado imediatamente quando um checkout é iniciado, ou seja, quando um pedido é registrado, mas não concluído.

Isso ajuda a monitorar e reagir a possíveis abandonos de carrinho.

B- Criação/Alteração de Pedido: insira a URL que receberá notificações sempre que um pedido for cadastrado ou sofrer alguma alteração.

Este webhook é essencial para manter o controle em tempo real sobre as operações de venda.

C- Pedido Removido: defina a URL para receber notificações quando um pedido for removido do sistema.

Isso é útil para atualizar registros ou sistemas de gestão que dependem da informação de pedidos ativos.

Adicionando Mais URLs: se necessário, você pode clicar no botão + para adicionar mais URLs de serviço para cada tipo de notificação, permitindo a integração com múltiplas ferramentas ou sistemas.

Produtos

Serão enviadas notificações quando um produto for criado ou alterado pelo painel administrativo.

A- Criação/Alteração de Produto: insira a URL que receberá notificações sempre que um produto for cadastrado ou modificado.

Essa configuração é crucial para sistemas que precisam acompanhar as atualizações do catálogo em tempo real.

B- Remoção de Produto: configure a URL para ser notificada quando um produto for removido do sistema. Isso ajuda a manter outros sistemas sincronizados com o status atual do inventário.

C- Alteração de Estoque: defina a URL para receber notificações sempre que ocorrer uma movimentação no estoque de um produto, seja por um novo pedido ou por uma alteração nas quantidades disponíveis.

Se necessário, clique no botão + para adicionar mais URLs para cada tipo de notificação, permitindo uma integração ainda mais completa com outras plataformas ou ferramentas.

Categorias

Serão enviadas notificações quando uma categoria for criada ou alterada pelo painel administrativo.

A- Criação/Alteração de Categoria: insira a URL para receber notificações sempre que uma categoria for cadastrada ou sofrer alguma alteração.

Esta configuração garante que você mantenha outros sistemas informados sobre atualizações na estrutura de categorias da sua loja.

B- Remoção de Categoria: configure a URL que será notificada quando uma categoria for removida do sistema.

Se optar por remover subcategorias relacionadas, a notificação será enviada apenas para a categoria principal, a categoria pai.

Você também pode clicar no botão + para adicionar outras URLS.

Clientes

1- Compra Iniciada: configure a URL para receber notificações sempre que uma compra for iniciada na loja virtual.

Este webhook é útil para acompanhar em tempo real o início de novas transações, permitindo ações imediatas relacionadas a processos de pagamento ou verificações de estoque.

Depois de fazer todas as configurações, clique em Salvar alterações.

Caso ainda tenha dúvida deixe um comentário ou fale com nosso atendimento.