Guía de configuración de notificaciones push de Telegram

Principios de configuración y estructura de la interfaz

El envío de mensajes de Telegram se implementa mediante Telegram Bot API. La URL completa de envío se forma concatenando el Bot Token (clave de acceso del robot) y el Chat ID (identificador único del receptor).

Plantilla estándar de concatenación:

[https://api.telegram.org/bot](https://api.telegram.org/bot)<TOKEN>/sendMessage?chat_id=<CHAT_ID>

Pasos para obtenerlos

Paso 1: crear un robot y obtener el Bot Token

1. Abra Telegram, escriba y siga al robot oficial @BotFather en la barra de búsqueda.
2. Envíe el comando /newbot a @BotFather.
3. Introduzca la información siguiendo las indicaciones:
   • Bot Name: nombre visible del robot (por ejemplo: Asistente de notificaciones).
   • Bot Username: nombre de usuario único del robot (debe terminar en bot, por ejemplo: my_notice_bot).
4. Una vez creado correctamente, @BotFather mostrará las credenciales de acceso a la API. Copie la cadena HTTP API Token (con un formato como 123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ).

Paso 2: obtener el Chat ID del receptor

Seleccione el método correspondiente según el tipo de receptor del mensaje (persona o grupo):

Opción A: recibir notificaciones personales

• Método 1: mediante el robot oficial de consulta (recomendado)
  1. Busque y siga a @userinfobot en Telegram.
  2. Envíele cualquier mensaje o haga clic en /start.
  3. El robot devolverá los metadatos de la cuenta personal; el número que aparece después de Id es su Chat ID personal (por ejemplo: 987654321).
• Método 2: consulta mediante la interfaz de la API
  1. Envíe activamente un mensaje al robot que acaba de crear (por ejemplo: hello) para activar la conversación.
  2. Abra el navegador y visite el siguiente enlace (sustituya <TOKEN> por la credencial obtenida en el paso 1):

      [https://api.telegram.org/bot](https://api.telegram.org/bot)<TOKEN>/getUpdates

  3. En la respuesta JSON devuelta, extraiga el valor de "result" -> "message" -> "chat" -> "id".

Opción B: recibir notificaciones en grupos/canales

1. Añada el robot recién creado al grupo de Telegram de destino.
2. Envíe cualquier mensaje dentro del grupo (por ejemplo: test) o conceda permisos de administrador al robot.
3. Visite el siguiente enlace en el navegador (sustituya <TOKEN> por la credencial obtenida en el paso 1):

    [https://api.telegram.org/bot](https://api.telegram.org/bot)<TOKEN>/getUpdates

4. En la respuesta JSON devuelta, busque el registro que contiene el nombre del grupo correspondiente y extraiga el campo "chat" -> "id".

   Nota: el Chat ID de un grupo suele ser un número negativo que empieza por - o -100 (por ejemplo: -100123456780); al concatenarlo, debe conservar por completo el signo negativo y el prefijo.

III. Ejemplos de concatenación de URL

Después de obtener <TOKEN> y <CHAT_ID>, sustitúyalos en la plantilla estándar:

1. Ejemplo de URL para notificaciones personales

• Token: 8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t
• Chat ID: 987654321
• Resultado final de la concatenación:

  [https://api.telegram.org/bot8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t/sendMessage?chat_id=987654321](https://api.telegram.org/bot8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t/sendMessage?chat_id=987654321)

2. Ejemplo de URL para notificaciones de grupo

• Token: 8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t
• Chat ID: -7
• Resultado final de la concatenación:

  [https://api.telegram.org/bot8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t/sendMessage?chat_id=-100123456780](https://api.telegram.org/bot8832838494:AAGb7ReOvyhcbkh03uXMN01nkSNBW9LuL6t/sendMessage?chat_id=-100123456780)