Ir al contenido

Alertas personalizadas de Canvas

Las alertas personalizadas de Canvas te avisan cuando algo en un Canvas no está funcionando según lo previsto. Así puedes detectar un recorrido detenido o una caída inesperada antes de que afecte a tus clientes.

Establece un umbral de volumen o porcentaje para las entradas de usuarios o los mensajes enviados, y Braze te notificará por correo electrónico o webhook si se supera ese umbral. Puedes crear hasta dos alertas para el mismo Canvas; por ejemplo, una alerta para entradas de usuarios y otra para mensajes enviados.

Para ver las alertas predeterminadas de todos los Canvas de un espacio de trabajo, consulta Alertas de Canvas del espacio de trabajo.

¿No sabes por dónde empezar? Operator puede guiarte para configurar una alerta personalizada de Canvas.

Paso 1: Crear una alerta

Las alertas se configuran a nivel de Canvas, y puedes configurarlas tanto para Canvas activos como para borradores. Para abrir la página Administrar alertas de un Canvas, puedes:

  • Ir a Mensajería > Canvas y seleccionar Administrar alertas en el menú contextual de un Canvas concreto.
  • Para Canvas activos, abrir Análisis de Canvas y seleccionar Administrar alertas.

Desde la página Administrar alertas, selecciona Configurar alerta para crear una nueva alerta.

Paso 2: Nombra tu alerta y selecciona un Canvas

Ponle un nombre a tu alerta y confirma el Canvas al que se aplica.

El panel Configurar alerta que muestra los campos de nombre de la alerta y nombre del Canvas, un grupo de reglas vacío y una barra lateral de resumen con las reglas, la programación y las notificaciones de la alerta.

Paso 3: Establecer reglas de alerta

Las reglas de alerta definen el umbral que desencadena una notificación. Puedes crear reglas con dos métricas:

  • Entradas de usuarios: Número de usuarios que entraron en el Canvas
  • Mensajes enviados: Número de mensajes enviados desde el Canvas

Para cada regla, elige una comparación (menor que, mayor que, menor o igual que, mayor o igual que, o igual a), una unidad y un umbral.

  • Volumen: Compara el recuento absoluto en la ventana de comprobación actual. Por ejemplo, “Entradas de usuarios menor que 3000” señala un Canvas que normalmente llega a miles de usuarios, pero que de repente se ha estancado, lo que indica un problema previo de audiencia o de entrada que vale la pena investigar.
  • Porcentaje: Compara el recuento actual con una referencia para este Canvas. La referencia es el promedio de la misma ventana de tiempo durante los 7 días anteriores. Por ejemplo, si la alerta comprueba cada 3 horas, una comprobación de 14:00 a 17:00 se compara con el promedio de las siete ventanas anteriores de 14:00 a 17:00. Una regla de “Mensajes enviados menor que 50 %” señala una caída por debajo de la mitad de ese volumen habitual.

Los umbrales son números enteros. Para las reglas de porcentaje con menor que o menor o igual que, introduce un valor de 1 a 100. Para mayor que, mayor o igual que o igual a, el porcentaje puede ser 0 o superior, incluidos valores por encima de 100, para que puedas recibir alertas sobre un pico respecto a la referencia.

Puedes agrupar varias reglas, incluso combinando reglas de volumen y de porcentaje, y combinar grupos de reglas con lógica AND u OR para crear condiciones de alerta más específicas.

Paso 4: Configura la programación de la alerta

Define con qué frecuencia se comprueban las reglas de tu alerta. Puedes configurar la frecuencia de comprobación entre 3 y 12 horas (en incrementos de 1 hora), o cada 24 horas. Una vez activada, la alerta sigue comprobándose según esta programación mientras la alerta y su Canvas asociado estén activos.

Paso 5: Configura las notificaciones

Elige a quién se debe notificar cuando se cumpla una regla de alerta y cómo se le notifica:

  • Correo electrónico: Añade una o varias direcciones de correo electrónico de destinatarios
  • Webhook: Introduce la URL del webhook al que se notificará y, opcionalmente, añade los encabezados de solicitud personalizados que requiera el destino de tu webhook
  • Slack: Introduce la URL de tu webhook entrante de Slack para publicar notificaciones en un canal de Slack. Para más información sobre cómo integrar las alertas de Canvas con Slack, consulta la documentación de Slack sobre Enviar mensajes mediante webhooks entrantes.

Puedes habilitar uno, dos o los tres métodos de notificación para una misma alerta.

Las alertas por webhook son útiles para dirigir notificaciones a plataformas externas. Cada notificación por webhook envía una carga útil JSON con el nombre de la alerta, la ventana de evaluación y las condiciones que desencadenaron la alerta. Cada condición incluye un threshold_unit de volume o percentage. Las condiciones de porcentaje también incluyen percentage_metric_value (el recuento observado como porcentaje entero respecto a la referencia). metric_value siempre es el recuento absoluto.

Ejemplo de carga útil de webhook

A continuación se muestra un ejemplo de la carga útil JSON que se envía en una solicitud POST a tu endpoint de webhook cuando se desencadena una alerta. La primera condición es una regla de volumen. La segunda es una regla de porcentaje: se enviaron 51 235 mensajes, lo que supone el 57 % de la referencia de la misma ventana de los últimos 7 días, frente a un umbral de más del 55 %.

{
  "alert": {
    "name": "Canvas Alert - August 6, 2026",
    "target_type": "CANVAS"
  },
  "evaluation_window_start": "2026-08-06T10:28:01Z",
  "evaluation_window_end": "2026-08-06T13:28:01Z",
  "conditions": [
    {
      "subject": "user_entries",
      "operator": "lt",
      "threshold_value": 500,
      "metric_value": 0.0,
      "group_index": 0,
      "threshold_unit": "volume"
    },
    {
      "subject": "messages_sent",
      "operator": "gt",
      "threshold_value": 55,
      "metric_value": 51235.0,
      "group_index": 0,
      "threshold_unit": "percentage",
      "percentage_metric_value": 57
    }
  ]
}

Paso 6: Guarda tu alerta

Revisa las reglas, la programación y la configuración de notificaciones de tu alerta en el panel de resumen y, a continuación, selecciona Guardar alerta.

Paso 7: Activa la alerta

Guardar una alerta no la activa. Para activarla, ve a la página Administrar alertas y usa el botón para alternar el Estado de tu alerta. Una alerta permanece activa hasta que la desactives o hasta que su Canvas asociado deje de estar activo. La columna Alertas configuradas de la página Canvas muestra un icono de campana para cualquier Canvas que tenga al menos una alerta guardada.

Consideraciones

  • Límite de alertas: Puedes crear hasta dos alertas personalizadas por Canvas.
  • Canvas en borrador: Puedes configurar una alerta personalizada para un Canvas que aún está en borrador, pero la alerta no empezará a comprobar tus reglas hasta que se lance el Canvas.
  • Referencia porcentual: Las reglas porcentuales necesitan siete días anteriores completos con la misma ventana después de que se lance el Canvas. Hasta que existan esas ventanas, o cuando el promedio de referencia sea cero (sin actividad en esas ventanas anteriores), las reglas porcentuales no desencadenan una notificación.

Preguntas frecuentes

¿Las alertas personalizadas cuentan para el uso de webhooks?

No. Las alertas personalizadas de Canvas no cuentan para los límites de velocidad ni para las métricas de uso de webhooks.

New Stuff!