Notificaciones por Telegram, cómo crear un bot paso a paso

Un pedido nuevo en la tienda, un formulario de contacto, un pago rechazado, la web que dejó de responder. Todo eso es información que alguien del equipo necesita ver pronto, y casi siempre termina en el mismo sitio: una bandeja de correo donde compite con boletines, facturas y respuestas automáticas.

Telegram resuelve ese problema con muy poco esfuerzo. Un bot propio puede escribirte a ti o al grupo del equipo cada vez que pasa algo importante, y montarlo lleva unos diez minutos. Este artículo explica por qué vale la pena, con qué se puede conectar y cómo crearlo paso a paso.

¿Por qué recibir notificaciones en Telegram?

La idea de fondo es sencilla: un aviso sirve si se ve a tiempo. El correo es un buen archivo, pero es un mal timbre. Una notificación en el teléfono, en un chat dedicado solo a eso, se lee en segundos.

Algunos avisos que suelen justificar el canal:

Ventas y contactos. Un pedido nuevo, un formulario enviado, una reserva confirmada. Responder en minutos en vez de horas cambia el resultado.
Problemas técnicos. La web caída, un certificado a punto de vencer, una copia de seguridad que falló, un error repetido en el servidor.
Operación diaria. Inventario bajo, un pago rechazado, una tarea programada que terminó (o que no terminó).
Resúmenes. Las ventas del día a las seis de la tarde, o el informe semanal cada lunes.

¿Qué ventajas tiene frente a otros canales?

Es gratis. La plataforma de bots de Telegram no cobra a usuarios ni a desarrolladores. Un SMS cuesta por mensaje, y la API de WhatsApp Business exige una cuenta verificada, plantillas aprobadas y cobra por los mensajes que inicia la empresa.

No hay trámites. No se necesita verificar una empresa ni esperar una aprobación. El bot se crea desde la propia aplicación y queda listo al instante.

Es simple por dentro. Enviar un mensaje es una sola petición web a una dirección. Cualquier sistema capaz de llamar a una URL puede avisar por Telegram, sin instalar nada.

Funciona en grupo. El bot puede escribir en un grupo donde está todo el equipo, y los grupos con temas permiten separar los avisos: ventas en un hilo, errores en otro.

Llega a todos los dispositivos. Teléfono, computador y web reciben el mismo mensaje, con historial y búsqueda.

El mensaje puede ser rico. Negritas, enlaces, botones, imágenes y archivos de hasta 50 MB. También existen los mensajes silenciosos, que llegan sin sonido: útiles para lo que conviene registrar pero no merece interrumpir a nadie.

Lo que conviene saber antes

Telegram no es la respuesta para todo, y es mejor tenerlo claro desde el principio:

Quien recibe necesita Telegram, y tiene que dar el primer paso. Un bot no puede iniciar una conversación: la persona debe escribirle primero o agregarlo a un grupo. Por eso encaja mejor para avisos internos del equipo que para escribir a clientes, que en buena parte de Latinoamérica viven en WhatsApp.
No es un canal para datos sensibles. Los chats con bots se guardan en los servidores de Telegram y no usan cifrado de extremo a extremo. Un aviso de «pedido nuevo #1042» está bien; contraseñas, números de tarjeta o historias clínicas, no.
Hay límites de envío. Están pensados para evitar el abuso y un sistema de avisos normal no se acerca a ellos. Los detallamos más abajo.

¿Con qué sistemas se puede conectar?

Con casi cualquiera, por dos caminos.

Herramientas que ya traen Telegram integrado. Solo piden el token del bot y el identificador del chat:

Automatización sin código: n8n, Make y Zapier tienen un módulo de Telegram. Sirven para unir el aviso con una tienda, un CRM, una hoja de cálculo o un formulario.
Monitoreo: Uptime Kuma, Grafana, Prometheus (a través de Alertmanager) y Zabbix pueden enviar sus alertas a un chat.
Hogar y oficina: Home Assistant avisa cuando se abre una puerta o se dispara un sensor.

Todo lo demás, con una petición web. Si el sistema puede ejecutar un script o llamar a un webhook, puede escribir por Telegram:

El formulario de contacto de tu web, desde el servidor que lo procesa.
Una tienda en WooCommerce o Shopify, a través de sus webhooks de pedido.
Google Sheets con Apps Script, por ejemplo cuando alguien llena una fila nueva.
GitHub Actions o cualquier otro sistema de despliegue, para saber si la publicación salió bien.
Una tarea programada en el servidor: la copia de seguridad de cada noche o el resumen diario de ventas. Si no tienes clara la sintaxis para programarla, lo explicamos en qué es una expresión cron.

¿Cómo crear un bot de Telegram paso a paso?

Solo necesitas una cuenta de Telegram. Los tres primeros pasos se hacen desde el teléfono y no requieren saber programar.

1. Habla con @BotFather

BotFather es el bot oficial de Telegram para crear y administrar bots. Búscalo en la aplicación por su nombre de usuario, @BotFather, y comprueba que tenga la marca de verificación azul. Abre el chat y envía:

/newbot

Te pedirá dos cosas:

Un nombre. Es el que se ve en el chat y en los contactos, por ejemplo «Avisos Mi Tienda». Se puede cambiar después.
Un nombre de usuario. Es la dirección única del bot. Debe tener entre 5 y 32 caracteres, admite solo letras latinas, números y guiones bajos, y tiene que terminar en bot: por ejemplo mitienda_avisos_bot. Este no se puede cambiar después.

BotFather también ofrece una mini app con las mismas funciones en una interfaz más visual. El resultado es el mismo por cualquiera de los dos caminos.

2. Guarda el token

Al terminar, BotFather entrega el token del bot, una cadena con esta forma:

110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw

El token es la contraseña del bot: quien lo tenga puede enviar mensajes en su nombre. Tres cuidados básicos:

Guárdalo en un gestor de contraseñas o en las variables de entorno del servidor.
No lo escribas en el código de una página web ni lo subas a un repositorio.
Si se filtra o lo pierdes, pídele a BotFather uno nuevo con /token. El anterior deja de funcionar.

3. Escríbele a tu bot

Abre el chat de tu bot (BotFather te da el enlace, con la forma t.me/mitienda_avisos_bot) y pulsa Iniciar. Este paso es obligatorio: como vimos, un bot solo puede escribirle a quien le habló primero.

4. Averigua el identificador del chat

Para enviar un mensaje, Telegram necesita saber a qué chat va. Ese dato es el chat_id, y la forma más directa de obtenerlo es preguntarle a la propia API qué mensajes ha recibido el bot. Abre esta dirección en el navegador, con tu token en lugar de <TOKEN>:

https://api.telegram.org/bot<TOKEN>/getUpdates

Fíjate en que la palabra bot va pegada al token. La respuesta es un texto en formato JSON; busca el bloque chat:

{
  "ok": true,
  "result": [
    {
      "update_id": 123456789,
      "message": {
        "chat": { "id": 987654321, "first_name": "Ana", "type": "private" },
        "text": "/start"
      }
    }
  ]
}

Ese id es tu chat_id. Si result aparece vacío, envíale otro mensaje al bot y recarga la página: Telegram conserva estas novedades como máximo 24 horas.

5. Envía el primer mensaje

Con el token y el chat_id ya puedes enviar. Desde una terminal:

curl -s "https://api.telegram.org/bot<TOKEN>/sendMessage" \
  -d chat_id=987654321 \
  --data-urlencode "text=Hola, ya funciono. Pedido nuevo #1042"

Si todo salió bien, el mensaje llega al teléfono y la API responde con "ok": true. Eso es todo lo que hace falta: una petición a sendMessage con dos datos, el chat y el texto.

El mismo envío desde JavaScript, tal como iría en el servidor que procesa un formulario:

async function avisar(texto) {
  const respuesta = await fetch(
    `https://api.telegram.org/bot${process.env.TELEGRAM_TOKEN}/sendMessage`,
    {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({
        chat_id: process.env.TELEGRAM_CHAT_ID,
        text: texto,
        parse_mode: 'HTML',
      }),
    },
  );
  return respuesta.json();
}

await avisar('<b>Pedido nuevo</b> #1042 por $120.000');

Algunos parámetros opcionales que vale la pena conocer:

Parámetro	Para qué sirve
`parse_mode`	Da formato al texto. Con `HTML` puedes usar `<b>`, `<i>`, `<a>` y `<code>`; con `MarkdownV2`, la sintaxis de Markdown.
`disable_notification`	Con `true`, el mensaje llega sin sonido.
`message_thread_id`	Envía el mensaje a un tema concreto de un grupo con temas.
`protect_content`	Impide reenviar o guardar el mensaje.
`link_preview_options`	Controla la vista previa de los enlaces, o la desactiva.

Un detalle del formato HTML: si el texto incluye los símbolos <, > o & y no forman parte de una etiqueta, hay que escribirlos como <, > y &, o Telegram rechazará el mensaje.

6. Lleva los avisos a un grupo o a un canal

Para que los avisos lleguen a todo el equipo:

Grupo. Agrega el bot como un miembro más y envía en el grupo un comando que lo mencione, por ejemplo /start@mitienda_avisos_bot. Vuelve a abrir getUpdates y encontrarás el chat_id del grupo, que es un número negativo. Se menciona al bot porque, por defecto, los bots trabajan en modo privacidad y en los grupos solo ven los comandos y las respuestas dirigidas a ellos. Para enviar avisos no hace falta cambiarlo.
Canal. Agrega el bot como administrador. Si el canal es público, puedes usar su nombre de usuario como chat_id, con la forma @nombredelcanal.

¿Qué límites tiene y qué errores son comunes?

Los límites que publica Telegram para los bots:

Alrededor de un mensaje por segundo en un mismo chat.
20 mensajes por minuto en un mismo grupo.
Unos 30 mensajes por segundo en total cuando se envía a muchos chats distintos.
Cada mensaje de texto admite hasta 4096 caracteres.

Si un sistema los supera, la API responde con el error 429 e indica cuántos segundos esperar antes de reintentar. Para un canal de avisos, la conclusión práctica es agrupar: un resumen con veinte líneas es mejor que veinte mensajes seguidos.

Los errores que aparecen con más frecuencia al empezar:

Error	Causa habitual
`401 Unauthorized`	El token está mal copiado o fue reemplazado por uno nuevo.
`400 Bad Request: chat not found`	El `chat_id` es incorrecto, o esa persona todavía no le ha escrito al bot.
`403 Forbidden: bot was blocked by the user`	La persona bloqueó el bot.
`429 Too Many Requests`	Se superó el límite de envío. La respuesta dice cuánto esperar.

Un último aviso sobre getUpdates: deja de funcionar si el bot tiene configurado un webhook, que es el otro mecanismo de Telegram para entregar los mensajes entrantes. Para un bot que solo envía avisos no necesitas ninguno de los dos una vez que tienes el chat_id.

¿Qué avisos vale la pena enviar?

Un canal de avisos funciona mientras la gente confíe en él. Si suena cincuenta veces al día, el equipo lo silencia y deja de servir. Algunas pautas que ayudan:

Avisa solo de lo que requiere una acción. Lo demás va en un resumen diario o en mensajes silenciosos.
Separa por urgencia. Un grupo o tema para lo crítico, con sonido, y otro para lo informativo.
Escribe mensajes que se entiendan solos. Qué pasó, dónde y un enlace para actuar: «Pago rechazado en el pedido #1042» con el enlace al pedido es mejor que «Error en pagos».
No dependas de un solo canal para lo crítico. Si el aviso es vital, que quede además en el correo o en el registro del sistema.

Con el bot funcionando, el siguiente paso es decidir qué procesos conectarle. Si la lista de candidatos es larga, en qué automatizar primero hay un método para ordenarla.

Notificaciones por Telegram, por qué usarlas y cómo crear tu bot paso a paso