Verificar las entregas de webhook y corregir los fallos.

Lea el registro de entrega de un punto final de webhook Notiondesk, comprenda los reintentos y las pausas, reanude un punto final pausado y corrija las entregas fallidas.

5 min de lectura

Cada punto final mantiene un registro de las solicitudes que Notiondesk le envió. Úselo para ver qué recibió su servidor, por qué falló una solicitud y cuándo se intentará nuevamente.

Ruta rápida: Ve a Configuración > Desarrolladores > Webhooks , abre un endpoint y desplázate hasta Entregas recientes . Haz clic en una fila para ver la respuesta y el cuerpo de la solicitud.

Lea las últimas entregas

  1. Ve a Configuración > Desarrolladores > Webhooks .
  1. Haz clic en el punto final.
  1. Desplázate hasta Entregas recientes .

La lista muestra las últimas 100 entregas de los últimos 14 días. Cada fila muestra el evento, el centro de ayuda de donde proviene (o Espacio de trabajo ), el resultado y la hora.

Icono Estado Qué significa
Marca verde Entregado Su servidor respondió con un código de estado 2xx
Reloj naranja Pendiente Aún no se ha enviado, o está esperando su próximo intento. Un intento fallido muestra el resultado seguido de reintentando , como 503, reintentando.
Cruz Roja Fallido Todos los intentos fallaron. La fila muestra el último resultado.
Gris menos Cancelado No se envió porque el punto final se pausó o se apagó, o su centro de ayuda ya no podía recibir eventos, antes del siguiente intento.

Abrir un paquete

Haz clic en una fila para abrirla:

  • ID de entrega : el mismo valor que el encabezado X-ND-Delivery, para que pueda encontrar la solicitud en los registros de su servidor.
  • Respuesta : el código de estado o motivo del fallo, cuánto tiempo tardó su servidor y cuántos intentos se realizaron.
  • Cuerpo de la solicitud : el JSON exacto que se envió. Haga clic en Copiar para copiarlo.

El cuerpo de la respuesta no se almacena. En el caso de eventos que contienen datos personales, como mensajes de contacto, comentarios, información sobre compañeros de equipo y solicitudes de ingreso, el cuerpo de la solicitud se elimina una vez finalizada la entrega.

Reintentos

Una entrega falla cuando su servidor responde con un código de estado distinto de 2xx, realiza una redirección, no comienza a responder en 5 segundos o tarda más de 10 segundos en total. Notiondesk lo intenta de nuevo:

Intentar Cuando
1 De inmediato
2 1 minuto después del primer intento
3 10 minutos después del segundo intento
4 1 hora después del tercer intento
5 6 horas después del cuarto intento

Tras 5 intentos fallidos, la entrega se marca como fallida . Los eventos de prueba y las entregas marcadas como "Firma fallida" no se vuelven a intentar.

Cuando ocurren muchos eventos a la vez, por ejemplo durante una sincronización importante, las entregas pueden demorarse antes de enviarse: generalmente unos minutos, y hasta una hora si el servidor tarda en responder. Permanecen en estado Pendiente y no se descartan.

Cuando un punto final está en pausa

Notiondesk pausa un punto final cuando 10 entregas consecutivas han fallado después de todos sus intentos, y el primero de esos fallos tiene al menos 24 horas de antigüedad. Los eventos de prueba no cuentan.

Cuando se pausa un punto final:

  • Muestra el estado "En pausa" y deja de recibir eventos. Los intentos que ya estaban planificados se cancelan.
  • El propietario del espacio de trabajo y los administradores reciben un correo electrónico con el mensaje "Punto final de webhook en pausa", que incluye el nombre del punto final, su host y un enlace a la configuración del webhook.
  • Los eventos del período de pausa no se envían posteriormente.

Para continuar:

  1. Repara tu servidor. Los motivos del fallo que aparecen en Entregas recientes te indican qué ha fallado.
  1. Haz clic en Enviar evento de prueba y comprueba que aparece como Entregado .
  1. Haga clic en Reanudar .

El punto final comienza a recibir nuevos eventos nuevamente y su contador de fallos se reinicia.

Si su punto final sigue activo pero las entregas siguen fallando, la página del punto final mostrará "Fallo desde" con la fecha del primer fallo, a modo de advertencia antes de que se pause.

Solucionar los problemas con las entregas fallidas

Cuando el servidor responde, la fila muestra su código de estado. De lo contrario, muestra el motivo.

Razón Lo que ves Qué pasó Cómo solucionarlo
Estado de error El código de estado, como 500 o 401 Su servidor respondió con un error. Revisa los registros de tu servidor para esa hora. Asegúrate de que el punto final acepte solicitudes POST y que tu verificación de firma utilice la clave secreta correcta.
Redireccionamiento rechazado Un código de redireccionamiento, como 301 o 302. Su servidor redirigió la solicitud. Introduzca la URL final en la configuración del punto final.
Dirección bloqueada Dirección bloqueada Tu dominio apunta a una dirección privada o interna. Apunta el dominio a un servidor público.
Falló la conexión. Falló la conexión. Notiondesk no pudo conectarse con su servidor. Verifique que el dominio se resuelva, que el certificado TLS sea válido y que el puerto 443 o 8443 esté abierto.
Tiempo de espera agotado Tiempo de espera agotado Tu servidor no empezó a responder en 5 segundos o tardó más de 10 segundos. Responda primero con 200, luego realice el trabajo en segundo plano.
Falló la firma Falló la firma Notiondesk no pudo firmar la solicitud Esto es un problema nuestro y no se vuelve a intentar. Envíe un evento de prueba y contáctenos si vuelve a suceder.

Enviar un evento de prueba

Haz clic en Enviar evento de prueba en la página del punto final para enviar un evento ping a ese punto final. Aparece en la parte superior de Entregas recientes .

  • Se envía un evento de prueba una sola vez, sin reintentos.
  • Puedes enviarlo mientras el punto final está en pausa, para comprobar la corrección antes de reanudar la operación.
  • Cada espacio de trabajo puede enviar hasta 20 eventos de prueba por hora. Si se supera ese límite, aparece el mensaje "Demasiados eventos de prueba. Inténtelo de nuevo más tarde".

Preguntas frecuentes

¿Puedo reenviar un envío fallido?

No. Abra la entrega y haga clic en Copiar para obtener el cuerpo de la solicitud si necesita procesarla usted mismo.

¿Por qué falta el cuerpo de la solicitud de entrega?

El evento contenía datos personales, por lo que su contenido fue eliminado una vez finalizada la entrega.

¿Cuánto tiempo se conservan los productos entregados?

14 días. Las entregas recientes muestran los últimos 100.

¿Un evento de prueba exitoso reanuda un punto final que estaba en pausa?

No. Solo comprueba tu servidor. Haz clic en Reanudar para volver a recibir eventos.

¿Qué sucede con los eventos en cola si elimino un punto final?

No se envían y, con ellos, se elimina el registro de entrega del punto final.

Artículos relacionados

¿Fue útil esta página?

Still need help? Ask us