🐞Errores
A continuación podrás encontrar información de como depurar errores sobre webhooks.
Última actualización
A continuación podrás encontrar información de como depurar errores sobre webhooks.
Última actualización
Dentro de las funciones que podrás encontrar en webhooks son los registros de errores los cuales te podrán entregar información relacionada a las peticiones que sean enviadas y que puedan fallar ya sean en el proceso de mutación, red (envío) o la plataforma a respondido con un error.
De esta forma podrás identificar de forma fácil qué es lo que no está funcionando correctamente en las integraciones.
Esta función está activa por defecto y no es posible desactivarla.
La duración de los registros son de 30 días desde su creación, luego de ello serán eliminados de forma automática.
En caso que requieras mantener los registros más tiempo envíanos un correo a [email protected]
Solo detectamos errores con códigos de estado 4XX o superior. Si la plataforma a integrar responde con errores con códigos de estado 2XX no considerarán como errores.
Para el caso de errores de formato en el webhook, automáticamente capturaremos el error.
Los errores capturados durante el proceso de envío contienen una estructura que podrás visualizar de forma sencilla.
Por defecto podrás ver los siguientes datos, los cuales describiremos a continuación.
Esta información es relativa al evento como un id de trazabilidad traceId y fecha en que se generó createdAt.
Esta información contiene datos de la petición como:
Este valor corresponde a la URL que haz ingresado en la configuración del webhook.
Este es el método con el cual se envió la petición el cual puede ser POST, GET, PATCH, PUT, HEAD, OPTIONS o DELETE.
Este valor corresponde a la fuente del error, el cual puede ser parsing, que corresponde a la sintaxis {{mustache}} o third-party que serían errores provocados en respuestas de la plataforma externa como 4XX o 5XX.
Recuerda, que solo detectamos errores con códigos de estado 4XX o superior.
Valor booleano si se verificó o no el certificado SSL.
Estos valores son dinámicos, ya que corresponden a las cabeceras que hayas configurado en el webhook. Por defecto, Content-Type es obligatorio.
Estos son valores dinámicos, ya que corresponden a los parámetros por url que hayas configurado en el webhook.
En caso de ser un error de fuente third-party existirán datos como:
Corresponde al código de estado HTTP que ha respondido la plataforma, como 4XX o 5XX.
Corresponde al nombre del código de estado HTTP, como BadRequest, NotAuthenticated, ServerError, etc.
Este valor es de mayor relevancia ya que te indicará el error que se ha provocado, tanto si es error de sintaxis como en el caso que sea un error que haya respondido la plataforma a integrar.
Es posible que no siempre una plataforma responda con contenido, por lo tanto este valor podría ser vacío.
Recuerda comparar este valor comparando el parámetro source para identificar la causa del error.
Este es el valor sin mutar, es decir, con la sintaxis en puro.
Almacenamos este valor para mantener su atomicidad y evitar confusiones si editas el webhook.