Configuração de Webhooks

Configure webhooks para receber notificações em tempo real sobre eventos da sua operação.

O que são Webhooks

Webhooks são callbacks HTTP que notificam seu sistema quando eventos ocorrem na N1. Exemplos de eventos: novo pedido recebido, atualização de status de entrega, alteração de estoque. Em vez de fazer polling, seu sistema recebe as notificações em tempo real.

Campos de Configuração

Ao configurar um webhook, você define:

• Webhook URL: o endpoint que receberá os eventos (deve ser acessível via HTTPS)
• Webhook Secret: chave secreta para validar a autenticidade das requisições. Pode ser gerada automaticamente ou definida por você
• App Login URL: URL de login do seu aplicativo (opcional)
• Welcome Email: toggle para enviar ou não email de boas-vindas
• Ativo/Inativo: toggle para habilitar ou desabilitar o webhook

Testar Conexão

O botão Test Connection envia um evento de teste para sua URL. Use-o para validar que o endpoint está respondendo corretamente e que seu sistema processa o payload esperado.

Logs de Webhook

A tabela de logs exibe o histórico de eventos enviados:

• Data e hora
• Status (sucesso ou falha)
• Order ID (quando aplicável)
• Resposta do servidor

Use os logs para diagnosticar falhas e garantir que eventos estão sendo entregues.

Sempre teste a conexão do webhook após configurar a URL para garantir que eventos estão sendo recebidos corretamente.