Como criar webhooks na Meloja

Os webhooks permitem que a Meloja envie automaticamente eventos da sua loja para outras ferramentas e sistemas sempre que alguma ação acontecer, como a criação de um pedido, a aprovação de um pagamento ou um carrinho abandonado.

Com esse recurso, é possível integrar a sua loja com plataformas de automação, CRMs, ERPs, sistemas próprios e diversos outros serviços.

Como criar um webhook

1. No menu lateral, acesse Configurações.
2. Clique em Webhooks.
3. Clique no botão Novo webhook.

Na tela de cadastro, informe:

• Nome: apenas para identificação interna do webhook.
• URL de destino: endereço HTTPS que receberá os eventos enviados pela Meloja.
• Eventos: escolha quais eventos deseja receber.

Atualmente estão disponíveis os seguintes eventos:

• Pedido criado
• Pedido pago
• Carrinho abandonado

Depois, clique em Salvar.

O que acontece após criar o webhook?

Sempre que um dos eventos selecionados ocorrer na sua loja, a Meloja enviará automaticamente uma requisição para a URL configurada contendo todas as informações daquele evento.

Cada webhook pode ser configurado para receber apenas os eventos que forem necessários para sua integração.

Como acompanhar os envios

Na lista de webhooks, clique em Ver envios para acessar o histórico.

Nessa tela você poderá visualizar:

• URL configurada.
• Status do webhook.
• Eventos configurados.
• Data do último envio com sucesso.
• Data da última falha, caso exista.
• Histórico completo de todos os envios realizados.

Também é possível verificar:

• Data e hora de cada envio.
• Evento enviado.
• Status da entrega.
• Quantidade de tentativas realizadas.
• Código HTTP retornado pelo servidor.

Como enviar um evento de teste

Na tela de envios existe o botão Enviar teste.

Ele envia um evento de exemplo para a URL configurada, permitindo verificar se a integração está funcionando corretamente antes de receber eventos reais da loja.

Como visualizar os detalhes de um envio

Ao clicar em qualquer envio do histórico, será aberta uma janela com todas as informações da requisição, incluindo:

• Headers enviados pela Meloja.
• Payload completo em formato JSON.
• Resposta retornada pelo servidor.
• Mensagem de erro, caso tenha ocorrido alguma falha.

Essas informações facilitam a identificação de problemas durante a integração.

Como reenviar um evento

Caso algum envio tenha falhado, basta abrir os detalhes do evento e clicar no botão Reenviar.

A Meloja fará uma nova tentativa de envio utilizando exatamente os mesmos dados do evento original.

Informações importantes

• A URL informada deve utilizar HTTPS.
• URLs locais e endereços IP privados não são aceitos.
• Utilize webhooks apenas com ferramentas confiáveis e que estejam de acordo com a política de privacidade da sua loja, pois os eventos podem conter informações de pedidos, clientes e carrinhos.