Saltar al contenido

Alertas

Una alerta es una consulta que Teramot corre sola y manda por mail (o publica en Slack) cuando el resultado vale la pena contarlo. Cualquiera del proyecto puede ver las alertas y su historial; crearlas, editarlas, probarlas y pausarlas requiere el rol Analista, y quitar una requiere Administrador.

Dónde: Operación → Alertas en la barra lateral, con un proyecto abierto.

Los tres modos

  • Resumen manda el resultado a una hora fija, por ejemplo cada mañana de día hábil, haya cambiado o no. Un resumen puede mostrar varias tablas, cada una de su propia consulta.
  • Incidente manda solo las filas nuevas, identificadas por las columnas clave que elijas, o las que vuelven después de un período de espera. También puede avisarte cuando una fila deja de aparecer.
  • Umbral vigila el primer valor de la primera fila contra una línea, con una racha antes de cambiar de estado, y puede avisarte cuando el valor vuelve.

Una alerta corre por horario o cuando una tabla que lee termina de actualizarse. Un resumen siempre corre por horario. Tu plan puede limitar cuántas alertas tiene un espacio de trabajo y con qué frecuencia se revisa cada una.

Alertas y actualizaciones

Una alerta lee las tablas del proyecto tal como las dejó la última actualización terminada, así que solo ve datos nuevos después de una actualización. Arriba de la página de Alertas se muestra la actualización automática del proyecto (Cron Refresh): cuándo corre, o que está pausada o sin configurar. Al hacer clic se ven todas las actualizaciones configuradas del proyecto, incluidas las únicas que todavía no corrieron, y un enlace a la programación si tu rol puede verla. Las actualizaciones automáticas y las únicas abarcan todo el proyecto y recargan sus fuentes una tras otra.

  • Una alerta por horario revisa lo que dejó la última actualización. Programala con margen después de la actualización, que tarda en terminar: si corre antes lee los datos anteriores, así que un resumen sale con ellos y un incidente o un umbral no encuentran nada nuevo.
  • Una alerta que corre cuando se actualizan sus tablas corre apenas termina la actualización de una tabla que lee, automática o manual. Si lee tablas de varias fuentes, puede correr una vez por fuente, a medida que cada una termina.
  • Una actualización manual de una fuente, o de algunas de sus tablas, también trae datos nuevos si los hay, y puede disparar alertas: las que leen esas tablas corren en el momento, y las de horario los ven en su próxima revisión.
  • Sin actualización automática, o con ella pausada, los datos solo cambian cuando alguien actualiza una fuente a mano, y hasta entonces las alertas revisan los mismos datos.

Crear o editar una alerta

Hacé clic en Nueva alerta, o en Editar en el menú de una alerta. El formulario tiene dos pestañas:

  • Regla — el nombre, el modo, cuándo corre y la consulta. Decí cuándo corre con tus palabras (“días hábiles a las 9:30”, “cada lunes a las 10”, “el 1 de cada mes a las 7”, “cada 6 horas”) o elegí una frecuencia, una hora y una zona horaria; la expresión cron está en Editar como cron si la preferís. La consulta es de solo lectura sobre las tablas del proyecto, y lo que devuelve es lo que muestra el mensaje. Los campos que siguen dependen del modo: el operador, el umbral y la racha; las columnas clave y el período de espera; o las tablas extra del resumen.
  • Envío — quién la recibe (direcciones de mail, un webhook de Slack, o ambos), el asunto, el idioma y el diseño, tus propias palabras alrededor de la tabla, y si el resultado viaja como CSV. Los destinatarios no necesitan cuenta en Teramot. Un webhook de Slack guardado no se vuelve a mostrar: dejá el campo vacío para conservarlo, pegá uno nuevo para reemplazarlo, o activá Quitar el webhook guardado.

Prueba en seco corre la consulta y muestra si la alerta dispararía, cuántas filas encontró y una muestra, sin guardar ni mandar nada. Guardá con Crear alerta o Guardar cambios.

Cuando una alerta guardada empieza a mandar a una dirección de mail que no es de un miembro del espacio de trabajo, o a un webhook de Slack, el propietario y los administradores del espacio de trabajo reciben un mail que dice quién la cambió y adónde manda ahora. Ese mail nunca lleva los resultados de la alerta. Mandar fuera del espacio de trabajo está permitido; el mail está para que nadie lo haga sin que se vea.

Correr, pausar y quitar

El menú de cada alerta tiene:

  • Historial — cada revisión: cuándo corrió, qué la disparó, si disparó, cuántas filas encontró, y para cada destinatario si el mensaje se envió, falló o no se envió y por qué (por ejemplo, nada nuevo que informar, o todavía en su período de espera).
  • Prueba en seco — la misma prueba que en el formulario, sobre la alerta guardada.
  • Correr ahora — revisa la alerta de verdad, registra el resultado y manda lo que el modo decida.
  • Pausar / Reanudar — una alerta pausada conserva su historial y sus destinatarios, pero no se revisa.
  • Quitar — detiene la alerta para siempre; su historial se conserva.

Dejar de recibir los mails de alertas

Cada mail de alerta dice al final cómo dejar de recibirlo, y los clientes de mail que lo soportan muestran su propio Cancelar suscripción junto al remitente. Un usuario de Teramot recibe un link que desactiva estos mails para su cuenta. Cualquier otra persona le pide a un administrador del workspace que la quite de los destinatarios de la alerta, o usa Cancelar suscripción en su cliente de mail, que le escribe a Teramot.

Las mismas alertas se pueden crear y cambiar desde un asistente de IA — mirá Alertas en la referencia de herramientas.