Primeros pasos con notificaciones de Telegram en 5 minutos

Telegram es uno de los mejores canales para alertas de desarrollo. Es rapido, funciona en todos los dispositivos, tiene una gran API y — a diferencia del email — la gente realmente lee sus mensajes. Esta guia te acompana paso a paso para conectar tu software a Telegram a traves de NotificationsBot, desde crear tu cuenta hasta enviar tu primera notificacion real.

No se requiere experiencia previa con la API de Telegram Bot. No hay tokens que gestionar ni servidores de webhook que configurar. NotificationsBot se encarga de todo eso por ti.

1 Crea tu cuenta en NotificationsBot

Ve a app.notificationsbot.com y registrate con tu email o cuenta de Google. El plan gratuito te da 100 notificaciones al mes — mas que suficiente para comenzar e integrar alertas en tu flujo de trabajo antes de decidir si necesitas mas.

No se requiere tarjeta de credito. Tu cuenta esta lista para usar en el momento en que verificas tu email.

2 Crea un canal

Un canal en NotificationsBot es un destino con nombre para tus notificaciones. Piensa en el como un tema o categoria — por ejemplo errors, deployments o payments. Cada canal puede tener multiples suscriptores en diferentes plataformas.

Desde el panel, ve a Channels → New Channel, dale un nombre (por ejemplo, my-app-alerts) y guarda. Eso es todo, tu canal esta creado.

3 Agrega un suscriptor de Telegram

Aqui es donde ocurre la magia. Un suscriptor es una persona (o un grupo) que recibe notificaciones de un canal. Para agregarte como suscriptor de Telegram:

• Ve a Subscribers → New Subscriber en el panel
• Ingresa tu nombre y guarda — se genera un enlace unico de suscriptor para ti
• Abre ese enlace en tu telefono o escritorio — se abre el bot de NotificationsBot en Telegram
• Presiona Start en Telegram para vincular tu cuenta de Telegram a tu perfil de suscriptor
• Vuelve al panel, abre tu canal y agrega este suscriptor

Una vez que el suscriptor esta vinculado, cualquier notificacion enviada a ese canal llegara a tu Telegram de inmediato. Puedes agregar tantos suscriptores como necesites — colegas, canales de equipo, diferentes dispositivos.

4 Obtiene tu API Key

Tu API key es lo que autentica tu aplicacion cuando llama a la API de NotificationsBot. Ve a Settings → API Keys en el panel y crea una nueva clave. Copiala en un lugar seguro — tratala como una contrasena.

Guardala en una variable de entorno en tu aplicacion:

# .env (nunca hagas commit de este archivo)
NOTIFICATIONSBOT_API_KEY=nbk_your_key_here

5 Envia tu primera notificacion

Con tu canal creado, tu suscriptor de Telegram vinculado y tu API key lista, ya puedes enviar tu primera notificacion. Es una sola peticion HTTP POST:

curl -s -X POST https://api.notificationsbot.com/event \
  -H "Authorization: Bearer $NOTIFICATIONSBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "my-app-alerts",
    "title": "Hello from my app!",
    "message": "Your first real-time Telegram notification is working."
  }'

Ejecuta ese comando y en menos de dos segundos veras la notificacion llegar a tu Telegram. Si no la recibes, verifica que tu suscriptor completo el onboarding del bot y esta asignado al canal.

Integracion en tu codigo

Una vez que hayas verificado que la notificacion llega, agrega la misma llamada en el codigo de tu aplicacion. Aqui tienes ejemplos para los stacks mas comunes:

import os, requests

def notify(title: str, message: str, channel: str = "my-app-alerts"):
    requests.post(
        "https://api.notificationsbot.com/event",
        headers={"Authorization": f"Bearer {os.environ['NOTIFICATIONSBOT_API_KEY']}"},
        json={"channel": channel, "title": title, "message": message},
        timeout=5,
    )

# Uso en cualquier parte de tu app
notify("Order processed", f"Order #42 — $99.00")

// notify.ts
export async function notify(title: string, message: string) {
  await fetch("https://api.notificationsbot.com/event", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.NOTIFICATIONSBOT_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      channel: "my-app-alerts",
      title,
      message,
    }),
  });
}

// Uso
await notify("Server error", "NullPointerException in checkout flow");

// notify.php
function notify(string $title, string $message): void {
    $ch = curl_init('https://api.notificationsbot.com/event');
    curl_setopt_array($ch, [
        CURLOPT_POST           => true,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER     => [
            'Authorization: Bearer ' . $_ENV['NOTIFICATIONSBOT_API_KEY'],
            'Content-Type: application/json',
        ],
        CURLOPT_POSTFIELDS => json_encode([
            'channel' => 'my-app-alerts',
            'title'   => $title,
            'message' => $message,
        ]),
    ]);
    curl_exec($ch);
    curl_close($ch);
}

// Uso
notify('Backup complete', 'Database backup finished — 2.3 GB');

Que construir a continuacion

Ahora que las notificaciones de Telegram estan funcionando, estas son las cosas mas utiles que puedes agregar:

• Alertas de errores — envuelve tus rutas de codigo mas criticas y envia una alerta cuando algo falle
• Notificaciones de despliegue — agrega una linea a tu pipeline de CI/CD para que el equipo sepa cuando se hace un deploy
• Monitoreo de URLs — agrega tus endpoints de API en el panel y recibe alertas dentro de 60 segundos de cualquier caida
• Eventos de negocio — notifica sobre nuevos registros, pagos, cancelaciones para mantener a todo el equipo informado
• Mas suscriptores — invita a companeros de equipo y agregalos a canales para que las personas correctas reciban las alertas correctas