Os Webhooks permitem automatizar a comunicação entre o Zydon e seus outros sistemas: sempre que um evento acontece na plataforma (um pedido e criado, um cliente se cadastra, etc.), o Zydon envia uma notificação HTTP para a URL que você configurar.
Pré-requisitos
Acesso ao Zydon Admin com permissão de administrador.
Ter um endpoint (URL) no seu sistema externo pronto para receber as requisições.
Onde encontrar
No menu lateral do Zydon Admin, clique em Configurações e depois em Webhooks.
Categorias de eventos
No menu lateral da tela de Webhooks, os eventos disponíveis estão organizados em 5 categorias:
-
Pedidos: Pedido Criado (dispara quando um novo pedido e criado), Pedido Atualizado (quando o pedido e editado - status, itens, entrega, pagamento), Pedido Calculado (quando o total do pedido e recalculado - frete, descontos, tributos, promoções) e Calculo de Preço de Produto (solicita ao seu sistema os valores de venda do item - preço base, descontos comerciais, politicas e tabelas).
-
Novo cliente: Novo Registro, disparado sempre que um novo cliente e cadastrado na plataforma. Útil para sincronizar dados com seu CRM, iniciar fluxos de aprovação ou enviar e-mails de boas-vindas.
-
Formas de entrega: Calcular Forma de Entrega (solicita ao sistema externo as opções de envio disponíveis para o pedido) e Enviar Formas de Entrega (envia as formas de entrega calculadas e selecionadas).
-
Agente IA: Enviar Mensagem, disparado sempre que uma mensagem e enviada pelo agente de IA.
-
Webhooks criados: lista consolidada de todos os webhooks personalizados que você já configurou, independente da categoria de evento.
Como configurar um webhook
Dentro de qualquer categoria, cada evento exibe um card com sua descrição. Clique em Clique aqui para adicionar (ou em Editar, se já houver um webhook configurado) para abrir a janela Editar webhook e preencher:
-
URL de endpoint: endereço do seu sistema externo que vai receber a requisição.
-
Máximo de retentativas: quantas vezes o Zydon deve tentar reenviar a requisição em caso de falha.
-
Timeout em segundos: tempo máximo de espera pela resposta do seu sistema antes de considerar a chamada como falha.
-
Método HTTP: GET, POST ou outro método aceito pelo seu endpoint.
-
Cabeçalho: pares de Chave e Valor enviados junto da requisição (ex.: chaves de autenticação). Clique em + Adicionar para incluir quantos precisar.
Depois de preencher, clique em Salvar.
Ultimas requisicoes
Clique em Ultimas requisicoes, no card de qualquer evento configurado, para abrir o historico de chamadas daquele webhook. Voce vera, para cada requisicao, o status (Enviado ou Falhou), o tempo de resposta em milissegundos e a data/hora do disparo.
Clique em qualquer requisicao da lista para ver o detalhe completo, dividido em duas abas: Requisicao (Headers enviados e Payload em formato JSON navegavel, com busca) e Resposta (o que o seu sistema externo respondeu).
Use essa tela para diagnosticar rapidamente por que uma integracao esta falhando, sem precisar recorrer aos logs do seu proprio sistema.