Alertas y notificaciones.
Cómo entregar las alertas de Vericto a tus canales: Slack, Microsoft Teams, Webhook y Email, con filtros de severidad, frecuencias y envío de pruebas.
Resumen
Las alertas de Vericto te avisan fuera del dashboard cuando una regla bloquea una query o cuando ocurre un evento relevante en tus bases de datos. Cada aviso se entrega a través de un canal: un destino externo como Slack, Microsoft Teams, un webhook HTTP genérico o un email.
Los canales se configuran en Dashboard → Alerts. Puedes crear varios canales a la vez, cada uno con su propio filtro de severidad y su propia frecuencia de entrega. Por ejemplo, un webhook en tiempo real para críticas y un email de resumen diario para el equipo.
Esta página trata sobre canales de entrega externos. No debe confundirse con el centro de notificaciones dentro de la app (el icono de campana), que es solo un historial de eventos. Los canales descritos aquí envían los avisos fuera de Vericto.
Quién puede gestionarlos
Crear, editar, borrar o probar canales requiere la capacidad notifications.manage, que tienen el owner y los admins. Los members y viewers ven la lista de canales en modo de solo lectura: pueden consultar la configuración y el estado de entrega, pero no ofrecen acciones de escritura.
Canales soportados
Vericto soporta cuatro tipos de canal. Al crear uno defines el tipo, el filtro de severidad, la frecuencia, un nombre opcional y el destino (URL de webhook o email del destinatario):
Slack
Entrega los avisos a un canal de Slack mediante un incoming webhook. Crea el webhook en Slack (api.slack.com) y pega la URL con formato https://hooks.slack.com/services/.... Admite todas las frecuencias, incluida realtime en los planes que la habilitan.
Microsoft Teams
Entrega los avisos a un canal de Microsoft Teams mediante un incoming webhook. Configura el conector en Teams y pega la URL con formato https://. Igual que Slack, admite todas las frecuencias.
Webhook (HTTP genérico)
Envía una petición HTTP a un endpoint de tu elección (por ejemplo https://api.tuapp.com/webhooks/vericto), útil para integrar con PagerDuty, un SIEM o tu propia automatización. La URL debe ser HTTPS. Admite todas las frecuencias.
Envía un reporte por correo a la dirección que indiques. El email es solo de resumen: usa cadencias de digest (diaria, semanal, quincenal o mensual) y no admite realtime. Además define una plantilla de reporte:
- summary: un resumen ejecutivo con los totales y las severidades del periodo.
- detailed: un reporte con el desglose evento por evento del periodo.
Filtro de severidad y frecuencia
Filtro de severidad
Cada canal tiene un filtro de severidad de tipo multi-select. Eliges una o más de las cuatro severidades y el canal solo entrega los eventos cuya severidad esté en el conjunto. Debe quedar al menos una severidad seleccionada. Los niveles son critical, high, medium y low. Seleccionar las cuatro equivale a "todas las severidades".
Frecuencia de entrega
La frecuencia controla cada cuánto agrupa Vericto los eventos antes de enviarlos. En realtime se envía un mensaje por evento; en el resto de cadencias los eventos del periodo se agrupan en un solo aviso, lo que evita saturar el canal. El correo usa cadencias de resumen más largas:
| Valor | Qué significa | Canales |
|---|---|---|
realtime |
Un mensaje por evento, en el momento. | Slack, Teams, Webhook |
5min |
Resumen agrupado cada 5 minutos. | Slack, Teams, Webhook |
15min |
Resumen agrupado cada 15 minutos. Valor por defecto. | Slack, Teams, Webhook |
1h |
Resumen agrupado cada hora. | Slack, Teams, Webhook |
4h |
Resumen agrupado cada 4 horas. | Slack, Teams, Webhook |
1d |
Resumen diario. | Slack, Teams, Webhook, Email |
7d |
Resumen semanal. | |
15d |
Resumen quincenal. | |
30d |
Resumen mensual. |
Los canales de Slack, Teams y Webhook usan las cadencias cortas (realtime, 5min, 15min, 1h, 4h, 1d). El correo usa cadencias de resumen (1d, 7d, 15d, 30d), nunca realtime. Puedes cambiar la frecuencia de un canal ya creado directamente desde su tarjeta.
Disponibilidad por plan
Las alertas son una funcionalidad de pago. Hay dos límites que dependen del plan del workspace:
- Las alertas no están disponibles en el plan Free. La sección muestra el aviso "Builder required" con un enlace para mejorar el plan.
- La frecuencia realtime solo está disponible en el plan Team o superior. En Builder solo aparecen las cadencias de digest (5min, 15min, 1h, 4h, 1d y las de correo), sin realtime.
| Plan | Alertas | Cadencias disponibles |
|---|---|---|
| Free | No disponibles. | Ninguna. Se muestra el CTA de mejora a Builder. |
| Builder | Disponibles. | Digest: 5min, 15min, 1h, 4h, 1d (más 7d, 15d, 30d en correo). Sin realtime. |
| Team | Disponibles. | Todas, incluida realtime. |
| Enterprise | Disponibles. | Todas, incluida realtime. |
Si intentas usar una cadencia que tu plan no permite (por ejemplo realtime en Builder), el backend responde con un error PLAN_UPGRADE_REQUIRED y la app abre el modal de mejora de plan. El selector de frecuencia oculta las opciones que tu plan no habilita.
Pruebas y estado de entrega
Acciones por canal
Cada canal se gestiona desde su tarjeta en Dashboard → Alerts. Con la capacidad notifications.manage puedes:
- Activar o desactivar el canal sin borrarlo.
- Cambiar la frecuencia en línea desde el selector de la tarjeta.
- Enviar una prueba: Vericto entrega un mensaje de test para verificar que el destino recibe correctamente. El canal debe estar activo.
- Eliminar el canal.
Contador y estado de entrega
Cada tarjeta muestra el contador de entregas y el estado de la última entrega, con tres valores posibles:
| Estado | Qué significa |
|---|---|
| delivered | La última entrega se envió correctamente al destino. |
| failed | La última entrega falló. Revisa que la URL o el email siga siendo válido. |
| pending | La entrega está encolada o en proceso. |
Preguntas frecuentes
¿Cuál es la diferencia entre estas alertas y el icono de campana?
El icono de campana dentro de la app es un centro de notificaciones que solo guarda el historial de eventos para consultarlo en el dashboard. Los canales de esta página entregan los avisos fuera de Vericto, a Slack, Teams, un webhook o un email.
¿Puedo tener varios canales a la vez?
Sí. Puedes crear tantos canales como necesites, cada uno con su propio tipo, filtro de severidad y frecuencia. Por ejemplo, un webhook realtime para críticas y un email de resumen semanal para el equipo.
¿Por qué no veo la opción realtime?
La frecuencia realtime solo está disponible en el plan Team o superior. En Builder el selector muestra únicamente las cadencias de digest. Si tu plan es Free, las alertas no están disponibles y verás el aviso de mejora a Builder.
¿Un viewer puede enviar una prueba o cambiar la frecuencia?
No. Members y viewers ven los canales en modo de solo lectura. Las acciones de crear, editar, cambiar frecuencia, enviar prueba y borrar requieren la capacidad notifications.manage, que tienen el owner y los admins.
¿Por qué no llegan los avisos aunque el canal esté activo?
Revisa el estado de la última entrega en la tarjeta. Si es failed, comprueba que la URL de webhook o el email destinatario sigan siendo válidos y envía una prueba. Recuerda que el filtro de severidad solo entrega los eventos cuya severidad esté en el conjunto seleccionado.