Configuración de Webhooks
Configura webhooks para recibir notificaciones en tiempo real sobre los eventos de tu operación.
Qué son los Webhooks
Los webhooks son llamadas HTTP que notifican a tu sistema cuando ocurren eventos en N1. Ejemplos de eventos: nuevo pedido recibido, actualización del estado de entrega, cambio de stock. En lugar de consultar periódicamente, tu sistema recibe las notificaciones en tiempo real.
Campos de Configuración
Al configurar un webhook defines:
- URL del Webhook: el endpoint que recibirá los eventos (debe ser accesible por HTTPS)
- Secreto del Webhook: clave secreta para validar la autenticidad de las peticiones. Puede generarse automáticamente o definirla tú
- URL de Login de la App: URL de acceso de tu aplicación (opcional)
- Correo de Bienvenida: interruptor para enviar o no el correo de bienvenida
- Activo/Inactivo: interruptor para habilitar o deshabilitar el webhook
Probar la Conexión
El botón Probar Conexión envía un evento de prueba a tu URL. Úsalo para validar que el endpoint responde correctamente y que tu sistema procesa el contenido esperado.
Registros del Webhook
La tabla de registros muestra el historial de eventos enviados:
- Fecha y hora
- Estado (éxito o fallo)
- ID del pedido (cuando aplica)
- Respuesta del servidor
Usa los registros para diagnosticar fallos y confirmar que los eventos se están entregando.
Prueba siempre la conexión del webhook después de configurar la URL, para asegurarte de que los eventos llegan correctamente.