Volver al blog

Notificaciones de Telegram con bot vs una API de notificaciones push para alertas de desarrollador

Notificaciones de Telegram con bot vs una API de notificaciones push para alertas de desarrollador

Pregunta a un grupo de desarrolladores cómo reciben alertas de sus scripts y la mitad dirá "un bot de Telegram". Es gratis, Telegram ya está en el teléfono y el primer mensaje se configura en diez minutos.

También es una app de chat haciendo el trabajo de un sistema de guardia. Funciona hasta que la alerta importante llega en el mismo flujo que los chats de grupo, o hasta que un nombre de archivo con guion bajo rompe el mensaje. Este artículo repasa la configuración de Telegram con honestidad: dónde funciona, dónde no, y cómo se ve la misma alerta a través de una API de notificaciones push.

La configuración de Telegram, de principio a fin

  1. Crea el bot. Escribe a @BotFather, envía /newbot, elige un nombre y un nombre de usuario que termine en bot. Recibirás un token como 110201543:AAH....
  2. Saluda primero. Los bots no pueden iniciar una conversación, así que abre el bot y envíale cualquier mensaje. Para un grupo, añade el bot al grupo.
  3. Busca tu chat id. Llama a getUpdates y lee message.chat.id del resultado:
curl -s "https://api.telegram.org/bot$TG_TOKEN/getUpdates" | jq '.result[].message.chat.id'

Las actualizaciones se conservan durante 24 horas, y getUpdates deja de funcionar en cuanto se configura un webhook en el bot. Los ids de grupo son negativos, y los de supergrupo empiezan por -100.

  1. Envía la alerta:
curl -s "https://api.telegram.org/bot$TG_TOKEN/sendMessage" \
  -d chat_id="$TG_CHAT_ID" \
  -d text="Backup failed on db-01"

Esa es toda la integración: dos secretos en un archivo de entorno y una llamada HTTP.

Dónde Telegram funciona bien

  • No cuesta nada. La propia FAQ de Telegram dice que los bots pueden enviar mensajes a sus usuarios sin coste.
  • Está donde tú estás. Clientes de teléfono, escritorio y web, todos sincronizados.
  • Los grupos son gratis. Añade el bot a un chat de equipo y todos verán la alerta y podrán hablar de ella en el mismo hilo.
  • Ya lo tienes abierto. Sin app nueva ni cuenta nueva.

Para notificaciones de poca importancia, como "el informe nocturno está listo", es difícil de superar.

Dónde se complica

Todas las alertas suenan igual

La API de bots tiene exactamente un control de entrega: disable_notification, que envía el mensaje sin sonido. No hay prioridad, ni nivel de tiempo sensible, nada que atraviese No molestar. Un backup fallido a las 3 de la madrugada llega igual que un sticker en un grupo, y si silencias el chat para evitar el ruido, silencias también las alertas.

El formato te dará problemas

Con parse_mode=MarkdownV2, los caracteres _ * [ ] ( ) ~ > # + - = | { } . ! y el backtick deben escaparse con una barra invertida fuera del formato. Las alertas están llenas justo de esos caracteres: nombres de archivo, números de versión, URL, trazas de error. Un punto sin escapar en db-01.internal y Telegram rechaza el mensaje con un error 400, así que la alerta sobre el fallo también falla. El modo HTML es más seguro, pero aun así tienes que escapar <, > y & en todo lo que envías.

El token es el bot

El token va en la ruta de la URL de cada petición, y la documentación de Telegram lo dice claro: quien lo tenga puede controlar tu bot. En la práctica, esa URL acaba en el historial de la shell, en los logs de CI y en cualquier otro sitio donde se registren URL de peticiones. Si se filtra, /token en BotFather emite uno nuevo, y entonces hay que actualizar todos los scripts.

Los botones necesitan un bot en ejecución

Los botones en línea pueden abrir una URL, lo cual está bien. Un botón que hace algo, como "reiniciar el servicio", usa callback_data, y el toque muestra un indicador de carga hasta que tu bot responde. Eso significa un proceso escuchando actualizaciones las 24 horas, más de lo que una tarea cron quiere gestionar.

Las ráfagas chocan con los límites de frecuencia

Telegram pide que los bots se mantengan por debajo de un mensaje por segundo por chat, y de 20 mensajes por minuto en un grupo. Si conectas un webhook muy activo a un grupo, recibirás 429 Too Many Requests con un valor retry_after, justo cuando las cosas van mal y las alertas llegan más rápido.

Los servicios no pueden publicar directamente

GitHub, Stripe, Grafana y Sentry envían webhooks con su propio JSON. La API de bots espera un chat_id y un text. Alguien tiene que estar en medio y traducir: un pequeño servidor, una función serverless, o un flujo en n8n o Zapier. Ese relevo es una cosa más que mantener en marcha.

Las alertas viven en un mensajero

Los mensajes del bot son mensajes de chat normales de Telegram, almacenados por Telegram y mezclados con tus chats personales. Buscar los incidentes del mes pasado significa desplazarte por un chat, no filtrar un historial por origen.

La misma alerta a través de una API push

Esta es la alerta del backup enviada a Pocket Alert, con una prioridad y un botón que abre el log del trabajo:

curl -X POST https://api.pocketalert.app/v1/messages \
  -H "Token: $PA_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Backup failed",
    "message": "db-01.internal: pg_dump exited with code 1",
    "level": "high",
    "actions": [{ "type": "view", "label": "Open log", "value": "https://ci.example.com/jobs/4821" }]
  }'

Lo que cambia:

  • Un solo secreto, en una cabecera. Una clave de API en la cabecera Token, no un token en la URL más un chat id.
  • Texto plano dentro, texto plano fuera. Sin reglas de escape. Los puntos, guiones bajos y corchetes llegan tal cual.
  • Prioridad por mensaje. silent, low, default, high o critical. En iPhone, las notificaciones high y critical atraviesan Concentración como notificaciones sensibles al tiempo, y en Android una alerta crítica anula No molestar. Consulta alertas críticas.
  • Botones sin bot. Hasta tres botones de acción: abrir una URL, llamar a un endpoint HTTP o copiar un valor. Nada tiene que escuchar los toques.
  • Los servicios publican directamente. Cada webhook tiene su propia URL. GitHub o Grafana envían su propio JSON, y marcadores como %alerts.0.labels.alertname% extraen campos hacia la notificación. Cada llamada queda registrada en el historial de webhooks.
  • Un historial propio. Las alertas se guardan en una app y un panel aparte, agrupadas por aplicación, no entre tus chats.

Cuándo Telegram sigue siendo la mejor opción

Siendo justos:

  • Volumen con presupuesto cero. Telegram es gratis y no tiene cuota diaria más allá de sus límites de frecuencia. El plan gratuito de Pocket Alert son 50 mensajes al día; para más hace falta un plan de pago desde 6 $ al mes.
  • Alertas que abren una conversación. Si la idea es que el equipo debata una alerta donde le llega, un chat de grupo lo hace y una notificación push no.
  • Escritorio y web primero. Si trabajas en un portátil, el cliente de escritorio de Telegram muestra las alertas donde ya miras. Las apps de Pocket Alert son para iPhone y Android, con un panel web para el historial.

Un reparto que funciona para muchos equipos: mantén un grupo de Telegram para la charla y los resúmenes diarios, y envía como push cualquier cosa que deba despertar a alguien, con un nivel asignado.

Preguntas frecuentes

¿Puede un mensaje de un bot de Telegram saltarse No molestar?

No desde el lado del bot. La API de bots no tiene ajuste de prioridad, solo disable_notification para silenciar un mensaje. La única forma de atravesar Concentración en iPhone es que el destinatario permita Telegram como excepción de app, lo que deja pasar todas las notificaciones de Telegram, no solo las alertas.

¿Cómo encuentro mi chat id de Telegram?

Envía cualquier mensaje a tu bot, luego llama a https://api.telegram.org/bot<token>/getUpdates y lee message.chat.id. Si el resultado está vacío, es posible que la actualización tenga más de 24 horas, o que el bot tenga un webhook configurado, y getUpdates no funciona mientras exista uno.

¿Por qué mi alerta de Telegram falla con un error 400?

Normalmente por un carácter sin escapar en el modo MarkdownV2 o HTML. Quita parse_mode para enviar texto plano, o escapa todos los caracteres reservados antes de enviar.

¿Es más difícil configurar una API de notificaciones push que un bot de Telegram?

Más o menos lo mismo. Con Pocket Alert instalas la app, copias una clave de API desde el panel y envías un POST. No hay chat id que buscar ni bot que crear.

¿Puedo enviar a las dos a la vez?

Sí. Muchos equipos mantienen Telegram para la discusión y envían como push las alertas que requieren respuesta. Un script puede llamar a ambas APIs, y la mayoría de servicios que envían webhooks aceptan más de una URL.

Crea una cuenta gratuita en Pocket Alert y envía el curl de arriba, o lee primero qué es una API de notificaciones push. Si estás valorando otras opciones, el centro de comparativas cubre Pushover, ntfy, Bark, Gotify y más.

Comparte este artículo