Integrar a sua loja com sistemas externos (como ERPs, CRMs ou ferramentas de automação) é essencial para escalar sua operação no piloto automático! No painel da wBuy, você encontra uma área dedicada para cadastrar Webhooks personalizados e gerar chaves de integração via REST API com controle total de permissões.
Para acessar, vá no menu lateral esquerdo (na seção Geral) e clique em Plataforma > API e webhooks.
Cadastrando e Gerenciando Webhooks
Os Webhooks servem para avisar automaticamente outros sistemas sempre que uma ação importante acontecer na sua loja.
Para configurar um novo envio automático, clique no botão Novo webhook e preencha os campos:
Tipo de notificação: Escolha qual evento da loja vai disparar o aviso (Clientes, Pedidos, Status de pedidos, Produtos, Estoque, Valores ou Carrinhos abandonados).
URL a ser notificada via POST JSON: Insira o endereço (URL começando com https://) fornecido pelo sistema externo que vai receber esses dados.
Após clicar em Gravar, o seu Webhook aparecerá na listagem principal, onde você pode ativá-lo, desativá-lo, editar as informações ou excluí-lo a qualquer momento.
Importante: Cada URL cadastrada poderá ser acionada até 5 vezes com intervalo de 5 minutos cada em caso de falhas. Em caso de resposta diferente de 200 ou 201 em todas as tentativas, a URL será desativada automaticamente pelo sistema.
Documentação e Monitoramento (Logs)
Se a sua equipe técnica precisar consultar os formatos dos dados enviados ou auditar se uma integração está funcionando corretamente, clique no botão Opções (ao lado de Novo webhook):
Documentação Webhooks: Abre diretamente a documentação técnica oficial da wBuy na seção de Webhooks, mostrando os métodos e exemplos de pacotes de dados (payloads) enviados em cada operação.
Logs da API e Logs do Webhook: Redireciona para a área de Estatísticas mostrando o histórico detalhado das requisições realizadas. Na tela de Logs da API, por exemplo, você consegue visualizar a Data, a Ação (método como [GET] ou [PUT] e o endpoint acessado), além do IP e da PK (Chave Pública) que fez a chamada, permitindo identificar exatamente qual sistema ou serviço externo realizou a comunicação.
Atenção: Os registros de logs com mais de 5 dias serão automaticamente deletados pelo sistema.
Integração REST API
Para que sistemas externos consigam consultar ou alterar dados da sua loja, você precisa gerar credenciais de acesso. Clique em Opções > Integração REST API.
Uma janela lateral se abrirá listando todas as suas credenciais criadas, além de botões no rodapé para Acessar documentação completa da API e consultar o Código LID da sua loja.
Regra de Limite de Requisições: Para manter a estabilidade e segurança da plataforma, são permitidas 100 requisições por credencial dentro de um intervalo de 60 segundos (independentemente do endpoint chamado). Ao atingir esse limite, a API retornará o código HTTPS 429, informando "Too Many Requests".
Como Criar uma Nova Chave de API
Dentro da janela de Integração REST API, clique no botão vermelho Criar chave de API.
Validação de Segurança (2FA): Antes de liberar a criação, o sistema solicitará o código de autenticação de dois fatores (do seu app Google Authenticator ou enviado para o seu e-mail, caso não use o aplicativo).
Identificação: Dê um nome claro para identificar onde essa chave será usada (ex: Integração ERP, Chave Teste, Sistema de Frete).
Métodos permitidos: Escolha exatamente quais módulos essa chave poderá acessar e quais ações ela poderá executar: GET (Ler dados), POST (Criar dados), PUT (Alterar dados) ou DELETE (Excluir dados).
IPs permitidos: Informe a lista de IPs dos servidores externos autorizados a usar essa chave (colocando 1 IP por linha).
Dica de Ouro: Você pode usar a caixinha Marcar / Desmarcar todos logo abaixo da lista de módulos. Se quiser criar uma chave bem restrita, desmarque todos de uma vez e selecione apenas os endpoints necessários!
Embora o campo de IPs permitidos possa ser deixado em branco para aceitar chamadas de qualquer IP, recomendamos fortemente preencher os IPs autorizados sempre que possível para garantir o controle máximo de segurança sobre os dados da sua loja.
