--- title: "Alertas" description: "El módulo Alerts te permite monitorear la actividad de las billeteras en tiempo real y recibir notificaciones instantáneas a través de canales externos como Telegram." url: https://docs.fystack.io/es/product/alerts last_updated: 2026-11-13 --- > ## Documentation index > Fetch the complete documentation index at: https://docs.fystack.io/llms.txt > Use it to discover all available pages before exploring further. # Alertas El módulo **Alerts** te permite monitorear la actividad de las billeteras en tiempo real y recibir notificaciones instantáneas a través de canales externos como Telegram. Configura alertas basadas en eventos o en condiciones para billeteras específicas, envíalas a los canales de comunicación de tu equipo y recibe un aviso en el momento en que ocurra algo, sin tener que vigilar un dashboard. Las alertas se organizan en dos pestañas: - **Alert**: las alertas que configuraste y su estado actual - **Channels**: los destinos de notificación (p. ej., grupos de Telegram) que reciben los mensajes de alerta --- ## Configurar un canal de notificación Un canal de notificación es el destino de entrega de tus alertas. Actualmente, Fystack admite canales y grupos de **Telegram**. ### Paso 1: ve a Alerts y abre la pestaña Channels Haz clic en **Alerts** en la barra lateral izquierda y luego selecciona la pestaña **Channels**. Aquí aparecen los canales existentes. Haz clic en **+ Create Channel** para agregar uno nuevo. _Image: Pestaña Channels de Alerts con los canales existentes y el botón Create Channel_ ### Paso 2: completa los detalles del canal En el modal **Create Notification Channel**, completa los siguientes campos: 1. **Channel Type**: selecciona `Telegram` en el menú desplegable 2. **Channel Name**: una etiqueta para identificar este canal dentro de Fystack (p. ej., `Marketing Department`, `Ops Team`) 3. **Description**: una nota opcional que explica para qué sirve este canal Haz clic en **Create Channel** para guardar. _Image: Modal Create Notification Channel con los campos Channel Type, Channel Name y Description_ ### Paso 3: conecta el canal a Telegram Después de crearlo, el canal aparece en la lista con **Connected: False**. Debe vincularse a un chat de Telegram antes de poder entregar alertas. Haz clic en el ícono **Connect channel** (el ícono de enlace) en el lado derecho de la fila. _Image: Lista de Channels con el Demo Channel recién creado y Connected en False_ _Image: Ícono Connect channel resaltado en la fila de la lista de Channels_ ### Paso 4: vincula el Fystack Alert Bot en Telegram Se abre el diálogo **Channel Connection Setup** con un código de conexión único e instrucciones. Para vincular el canal: 1. Abre Telegram y busca **@FystackAlertBot** 2. Inicia un chat directo con el bot, o agrégalo al grupo o canal en el que quieres recibir las notificaciones 3. Envía el código de conexión que aparece en el diálogo: haz clic en el campo del código para copiarlo y luego pégalo como mensaje al bot _Image: Diálogo Channel Connection Setup con el nombre del bot de Telegram y el código de conexión que debes enviar_ El bot responde con una confirmación: **"Channel successfully linked! You will now receive alerts here."** _Image: Chat de Telegram con Fystack Alert Bot que confirma que el canal se vinculó correctamente_ > **Note:** Para notificaciones de equipo, agrega **@FystackAlertBot** a un grupo o canal de Telegram y asegúrate de que tenga permiso para enviar mensajes. Para notificaciones personales, basta con un chat directo con el bot. ### Paso 5: haz clic en Complete Setup De vuelta en el diálogo **Channel Connection Setup**, el indicador de estado ahora muestra **Connected**. Haz clic en **Complete Setup** para finalizar la configuración. _Image: Diálogo Channel Connection Setup con el estado Connected y el botón Complete Setup resaltado_ La lista de Channels ahora muestra **Connected: True** para este canal. Ya está listo para recibir notificaciones de alertas. _Image: Lista de Channels con Demo Channel que ahora muestra Connected en True_ --- ## Crear una alerta > **Note:** Debes tener al menos un canal conectado antes de crear una alerta. Si todavía no configuraste uno, sigue primero los pasos anteriores. Ve a la pestaña **Alert** y haz clic en **+ Create Alert** para configurar una regla de monitoreo. _Image: Pestaña Alert con la lista de alertas existentes y el botón Create Alert_ ### Paso 1: elige el tipo de alerta El asistente **Create Alert** comienza preguntando qué quieres monitorear. Selecciona el tipo que se ajuste a tu caso de uso y haz clic en **Next**. _Image: Selección del tipo en Create Alert con las opciones Event Alert y Trigger Alert_ | Tipo | Cuándo se activa | Casos de uso de ejemplo | | --- | --- | --- | | Event Alert | Ocurre una acción específica en la billetera: depósito recibido, retiro solicitado, retiro aprobado, retiro cancelado o retiro ejecutado | Notificar al equipo de operaciones cada vez que se ejecuta un retiro en una hot wallet | | Trigger Alert | El estado de una billetera cruza una condición definida: el saldo cae por debajo de un umbral, el volumen de transacciones supera un límite o se detecta actividad inusual | Alertar cuando el saldo de USDC en una billetera de tesorería cae por debajo de 100 | ### Paso 2: selecciona los tipos de evento y las billeteras objetivo Para una **Event Alert**, elige de la lista uno o más eventos de billetera que quieras monitorear: - **Incoming Deposit**: se activa cuando se reciben fondos - **Withdrawal Request**: cuando se envía un retiro - **Withdrawal Approval**: cuando un [Signer](https://docs.fystack.io/product/user-management.md) aprueba un retiro - **Withdrawal Cancel**: cuando se cancela un retiro - **Withdrawal Executed**: cuando un retiro se completa on-chain Luego selecciona una o más **Target Wallets** para delimitar el alcance de la alerta. El resumen de la parte inferior confirma cuántos tipos de evento y billeteras se monitorearán. _Image: Paso de Create Alert con la selección de tipos de evento y el selector de billeteras objetivo_ > **Note:** En las **Trigger Alerts**, este paso te pide definir la condición (p. ej., `balance gte 100 USDC`) y la billetera que se evaluará. La condición se comprueba continuamente contra el estado real de la billetera. ### Paso 3: selecciona los canales de notificación Elige qué canales de notificación deben recibir los mensajes de esta alerta. Todos los canales conectados aparecen en el selector **Add Notification Channel**. Selecciona uno o más, confirma el resumen de la parte inferior y haz clic en **Create Alert**. _Image: Paso de Create Alert con el selector de canales de notificación y Demo Channel seleccionado_ ### La alerta está activa La nueva alerta aparece en la lista **Alert** con **Active: True**. Cada fila muestra el tipo de alerta, el evento o la condición de activación, las billeteras monitoreadas, el creador y los canales vinculados. _Image: Lista de alertas con varias alertas activas, sus tipos, eventos, billeteras y canales_ ### Prueba tus alertas La forma más rápida de verificar que una alerta funciona es activar manualmente uno de los eventos monitoreados. Para una alerta de evento **Withdrawal Request** o **Withdrawal Executed**, inicia un [retiro](https://docs.fystack.io/withdrawals.md) desde una de las billeteras objetivo. _Image: Modal Withdraw con un retiro de prueba para verificar la notificación de la alerta_ Cuando se activa el evento, el Fystack Alert Bot entrega en segundos un mensaje estructurado a tu canal de Telegram. El mensaje incluye el tipo de evento, el nombre de la billetera, el ID de la transacción, el monto, la red, la dirección del destinatario y un enlace al explorador de bloques. _Image: Mensaje de Telegram de Fystack Alert Bot con una notificación Withdrawal Requested y todos los detalles de la transacción_ --- ## Buenas prácticas - **Crea un canal por equipo o función**: tener canales separados para operaciones, finanzas y cumplimiento facilita enviar las alertas correctas a las personas correctas sin ruido. - **Usa Event Alerts para registros de auditoría**: combinar las alertas **Withdrawal Approval** y **Withdrawal Executed** le da a tu equipo un registro en tiempo real de cada transacción, que complementa el Audit Log del workspace. - **Usa Trigger Alerts para monitorear saldos**: define un umbral de saldo mínimo en las billeteras que usas con sweep tasks de [Automation](https://docs.fystack.io/product/automation.md), para detectar situaciones de saldo bajo antes de que bloqueen las transferencias automatizadas. - **Prueba cada alerta nueva antes de confiar en ella**: activa manualmente el evento monitoreado justo después de configurarla para confirmar que el mensaje del bot llega al chat de Telegram esperado. - **Agrega el bot a un grupo para dar visibilidad al equipo**: los mensajes directos individuales son fáciles de pasar por alto. Un grupo de Telegram compartido garantiza que todo el equipo vea los eventos críticos en tiempo real.