Probar un webhook
Cómo usar el botón de prueba de Mosce ERP para verificar la conectividad de un endpoint, interpretar el resultado y revisar el historial de entregas.
Antes de esperar un evento real, Mosce ERP te permite enviar un payload de prueba a tu endpoint y ver el resultado de forma sincrónica: código HTTP de respuesta, latencia y cualquier mensaje de error. Este artículo cubre el flujo de prueba y cómo usar el historial de entregas para diagnosticar problemas.
Tiempo de lectura: ~4 min
Cuándo usar esto
- Acabas de registrar un webhook y quieres confirmar que tu servidor recibe eventos correctamente.
- Cambiaste la URL del endpoint o el servidor y quieres verificar la nueva configuración.
- Un webhook falló y quieres diagnosticar qué está pasando sin esperar al próximo evento real.
Antes de empezar
- Ya tienes un webhook configurado con una URL HTTPS. Ver Configurar un webhook.
- Tu servidor receptor está activo y escuchando en la URL registrada.
- Necesitas el permiso
tenant:webhook.
Paso a paso - enviar una prueba
Paso 1 - Abrir el webhook
- Ve a Configuración → Integraciones → Webhooks.
- Haz clic en el webhook que quieres probar.
Paso 2 - Usar el botón "Probar endpoint"
- En la pantalla de detalle del webhook, haz clic en Probar endpoint.
- Mosce ERP envía de inmediato un payload de prueba a tu URL y espera la respuesta.
- El resultado aparece en pantalla en menos de 10 segundos.
Paso 3 - Interpretar el resultado
El resultado de la prueba muestra:
| Campo | Descripción |
|---|---|
| Estado | success si tu servidor respondió con 2xx; failed en cualquier otro caso |
| Código de respuesta HTTP | El código exacto que devolvió tu servidor (200, 201, 400, 500, etc.) |
| Latencia | Tiempo en milisegundos entre el envío y la respuesta del servidor |
| Mensaje de error | Solo si la prueba falló: descripción del error (timeout, conexión rechazada, etc.) |
Resultado exitoso: código 200 (o cualquier 2xx) con latencia baja. Tu endpoint está correctamente configurado.
Resultado fallido: revisa la sección de errores comunes a continuación.
El payload de prueba
El evento de prueba tiene tipo webhook.test y un payload mínimo:
{
"type": "webhook.test",
"timestamp": "2026-05-09T14:30:00Z",
"data": {
"message": "Este es un evento de prueba de Mosce ERP"
}
}El payload incluye los mismos encabezados que un evento real, incluyendo X-Helix-Signature con la firma correcta. Puedes verificar la firma en tu servidor durante la prueba - si la verificación falla para el evento de prueba, también fallará para eventos reales. Ver Seguridad y verificación de firma.
Tu servidor debe responder con HTTP 2xx para que la prueba se marque como exitosa. Si tu servidor rechaza el evento de prueba (por ejemplo, porque filtra por tipo de evento), devuelve 200 de todas formas y maneja la lógica internamente.
Historial de entregas
El historial de entregas muestra las últimas entregas de este webhook, con el estado y detalles de cada intento.
Para ver el historial:
- Abre el webhook desde Configuración → Integraciones → Webhooks.
- Haz clic en Historial de entregas.
El historial muestra por defecto las últimas 10 entregas. Puedes filtrar por estado (pendiente, entregado, fallido, agotado) para encontrar las entregas que necesitas revisar.
Para cada entrega en el historial puedes ver:
- El tipo de evento.
- El timestamp de cada intento.
- El código de respuesta de cada intento.
- Un botón de Reenviar para volver a intentar la entrega manualmente.
Errores comunes
| Síntoma | Causa probable | Solución |
|---|---|---|
Estado failed con "Connection refused" | El servidor no está activo en la URL registrada | Verifica que tu servidor esté corriendo y escuchando en el puerto correcto |
Estado failed con código 401 | Tu servidor rechaza la solicitud por firma inválida | Verifica la lógica de verificación de firma; asegúrate de leer el body crudo |
Status failed con código 404 | La ruta del endpoint no existe en tu servidor | Verifica que la URL del webhook apunte a la ruta correcta |
Estado failed con "timeout" | El servidor tardó más de 30 segundos en responder | Tu servidor debe responder antes de 30 segundos; considera devolver 200 inmediatamente y procesar async |
| La prueba es exitosa pero los eventos reales fallan | Diferencia entre el entorno de prueba y producción | Verifica variables de entorno, firewalls o reglas de red en producción |
Preguntas frecuentes
¿La prueba consume mi cuota mensual de entregas?
No. Los eventos de prueba (webhook.test) no se contabilizan en tu límite mensual de entregas de webhooks.
¿Puedo elegir qué tipo de evento se envía en la prueba?
No. El tipo de evento de prueba es fijo (webhook.test). Para probar el comportamiento con un tipo de evento específico (ej. invoice.created), crea un documento real en tu cuenta y observa la entrega en el historial.
¿El payload de prueba incluye datos reales de mi cuenta?
No. El payload de prueba es sintético y no contiene datos reales de facturas, clientes u otros registros de tu cuenta.
¿Con qué frecuencia puedo usar el botón de prueba?
No hay un límite explícito de pruebas por día. Sin embargo, las pruebas sí se registran en el historial y cuentan para el análisis de disponibilidad del endpoint.
Relacionados
Última actualización: 2026-05-09
Confiabilidad y reintentos
Cómo Mosce ERP reintenta la entrega de webhooks fallidos, cuándo desactiva un endpoint automáticamente y cómo rehabilitarlo.
Idempotencia (Idempotency-Key)
Cómo usar el encabezado Idempotency-Key para que los reintentos de tus integraciones no dupliquen órdenes de compra ni apliquen una recepción dos veces.