Solución de problemas de webhook y solicitudes de contenido conectado
Este artículo explica cómo solucionar los códigos de error más comunes de los webhooks y el contenido conectado, y ofrece más explicaciones sobre cómo pueden producirse estos errores en tus solicitudes.
Errores 4XX
Los errores 4XX indican que hay un problema con la solicitud enviada al punto de conexión. Estos errores suelen deberse a solicitudes erróneas, como parámetros mal formados, omisión de encabezados de autenticación o URL incorrectas. Ten en cuenta que estos errores también se aplican al generador de informes.
Consulta la tabla siguiente para ver los detalles del código de error y los pasos para solucionarlo:
| Código de error | Qué significa | Pasos para resolver |
|---|---|---|
| 400 Petición errónea | Hay una sintaxis no válida en la solicitud. |
|
| 401 No autorizado | La solicitud requiere la autenticación del usuario. |
|
| 403 Prohibido | El punto de conexión entiende la solicitud pero se niega a autorizarla. |
|
| 404 No encontrado | El punto de conexión no puede encontrar el recurso solicitado. |
|
| 405 Método no permitido | El método de solicitud es conocido por el punto de conexión, pero no es compatible con el recurso de destino. |
|
| 408 Tiempo de espera de la solicitud | El punto de conexión ha agotado el tiempo de procesamiento de la solicitud. |
|
| 409 Conflicto | La solicitud está incompleta debido a un conflicto con el estado actual del recurso. |
|
| 429 Demasiadas solicitudes | Se envían demasiadas solicitudes en un tiempo determinado. |
|
Errores 5XX
Los errores 5XX indican que hay un problema con el punto de conexión. Estos errores suelen deberse a problemas del servidor.
| Código de error | Qué significa |
|---|---|
| 500 Error interno del servidor | El punto de conexión encontró una condición inesperada que le impidió completar la solicitud. |
| 502 Pasarela incorrecta | El punto de conexión recibió una respuesta no válida del servidor ascendente. |
| 503 Servicio no disponible | El punto de conexión no puede gestionar actualmente la solicitud debido a una sobrecarga temporal o a mantenimiento. |
| 504 Tiempo de espera de la pasarela | El punto de conexión no recibió una respuesta oportuna del servidor ascendente. |
| 529 Host sobrecargado | El host del punto de conexión está sobrecargado y no pudo responder. |
| 598 Host en mal estado | Braze simuló la respuesta porque el host del punto de conexión está marcado temporalmente como en mal estado. Consulta Detección de host en mal estado para más información. |
| 599 Error de conexión | Braze experimentó un error de tiempo de espera de conexión de red al intentar establecer una conexión con el punto de conexión, lo que significa que el punto de conexión puede ser inestable o estar caído. |
Resolver errores 5XX
Aquí tienes consejos para la solución de problemas comunes de errores 5XX:
- Revisa el mensaje de error para ver los detalles específicos disponibles en el Registro de actividad de mensajes. Para los webhooks, ve a la sección Rendimiento en el tiempo de la página de inicio de Braze y selecciona las estadísticas de los webhooks. Desde aquí, puedes encontrar la marca de tiempo que indica cuándo se produjeron los errores.
- Asegúrate de no enviar demasiadas solicitudes que sobrecarguen el punto de conexión. Puedes enviar por lotes o ajustar el límite de velocidad para comprobar si así se reducen los errores.
Detección de host en mal estado
Los webhooks de Braze y el contenido conectado emplean un mecanismo de detección de host en mal estado para detectar cuando el host de destino experimenta una alta tasa de lentitud significativa o una sobrecarga que provoca tiempos de espera, demasiadas solicitudes u otros resultados que impiden que Braze se comunique correctamente con el punto de conexión de destino. Actúa como salvaguarda para reducir la carga innecesaria que pueda estar causando dificultades al host de destino. También sirve para estabilizar la infraestructura de Braze y mantener velocidades rápidas de mensajería.
Los umbrales de detección difieren entre los webhooks y el contenido conectado:
- Para webhooks: Si el número de fallos supera los 3.000 en cualquier ventana de tiempo móvil de un minuto (por combinación única de nombre de host y grupo de aplicaciones—no por ruta de punto de conexión), Braze detendrá temporalmente las solicitudes al host de destino durante un minuto.
- Para contenido conectado: Si el número de fallos supera los 3.000 Y la tasa de error supera el 90% en cualquier ventana de tiempo móvil de un minuto (por combinación única de nombre de host y grupo de aplicaciones—no por ruta de punto de conexión), Braze detendrá temporalmente las solicitudes al host de destino durante un minuto.
Cuando las solicitudes se detienen, Braze simula respuestas con un código de error 598 para indicar el mal estado. Al cabo de un minuto, Braze reanudará las solicitudes a toda velocidad si se comprueba que el host está en buen estado. Si el host sigue en mal estado, Braze esperará otro minuto antes de volver a intentarlo.
Los siguientes códigos de error contribuyen al recuento de fallos del detector de host en mal estado: 408, 429, 502, 503, 504, 529.
Para los webhooks, Braze reintentará automáticamente las solicitudes HTTP que fueron detenidas por el detector de host en mal estado. Este reintento automático utiliza una retirada exponencial y solo lo intentará unas pocas veces antes de fallar. Para más información sobre los errores de webhook, consulta Errores, lógica de reintentos y tiempos de espera.
Para el contenido conectado, si las solicitudes al host de destino se detienen por el detector de host en mal estado, Braze continuará renderizando mensajes y seguirá tu lógica Liquid como si hubiera recibido un código de respuesta de error. Si quieres asegurarte de que estas solicitudes de contenido conectado se reintentan cuando son detenidas por el detector de host en mal estado, utiliza la opción :retry. Para más información sobre la opción :retry, consulta Reintentos de contenido conectado.
Si crees que la detección de host en mal estado puede estar causando problemas, ponte en contacto con soporte de Braze.
Correos electrónicos automatizados y entradas en el registro de actividad de mensajes
Configuración de correos electrónicos automatizados
Si experimentas más de 100.000 errores de webhook o de punto de conexión de contenido conectado (incluidos los reintentos) en un espacio de trabajo en un periodo de 24 horas, recibirás un correo electrónico con la siguiente información sobre cómo resolver los errores.
- Nombre del espacio de trabajo
- Un enlace al Canvas o a la campaña
- URL del punto de conexión
- Código de error
- Hora en que se observó el error por última vez
- Enlaces al registro de actividad de mensajes y documentación relacionada
Puedes configurar el umbral de error por espacio de trabajo. Para ajustar este umbral, ponte en contacto con soporte de Braze.
Los errores del punto de conexión son:
4XX:400,401,403,404,405,408,409,4295XX:500,502,503,504,598,599
Estos correos electrónicos solo se envían una vez al día a nivel de espacio de trabajo. Si ningún usuario se registra para recibir estos correos electrónicos, se notificará a todos los administradores de la empresa.
Para registrarte y recibir estos correos electrónicos, haz lo siguiente:
- Ve a Configuración > Configuración del administrador > Preferencias de notificación.
- Selecciona Errores de contenido conectado y Errores de webhook en la sección Canvas y campañas.
Entradas del registro de actividad de mensajes
Si se produce un fallo, habrá al menos una entrada en el Registro de actividad de mensajes relacionada con él. Si la solicitud se reintenta y finalmente tiene éxito, esos detalles estarán disponibles en Currents y Snowflake Data Share. Ten en cuenta que, aunque una solicitud finalmente tenga éxito tras un reintento, los errores pueden seguir activando el correo electrónico automatizado.
Información adicional sobre fallos en Braze Currents
Para aumentar la transparencia de los problemas relacionados con los webhooks, Braze transmite eventos detallados de fallos de webhooks a Currents y Snowflake Data Sharing. Estos eventos incluyen solicitudes de webhook fallidas (como respuestas HTTP 4xx o 5xx), lo que proporciona mayor capacidad de observación sobre cómo los problemas de webhook pueden afectar a la entrega de mensajes. Ten en cuenta que los eventos de fallo incluyen errores terminales, así como errores que se están reintentando.
Las solicitudes de contenido conectado no se incluyen en estos eventos de fallo de webhook.
Para más información, consulta el glosario de eventos de interacción con mensajes.
Editar esta página en GitHub