Telegram

Conecta Telegram y cada entrada que publiques saldrá como mensaje al chat, canal o grupo de Telegram que elijas. Genial para hacer broadcasting a un canal de Telegram con suscriptores, o simplemente avisarte a ti mismo.

Telegram requiere un poco de configuración inicial en la propia app de Telegram — crear un bot y encontrar la ID de chat — pero una vez hecho, el lado de Structura es rápido.

Qué se publica

Un solo mensaje de Telegram por publicación:

Título de la entrada en negrita.
Resumen corto del extracto o primer párrafo.
Enlace al artículo en tu sitio WordPress.
Imagen destacada como adjunto de foto del mensaje (cuando esté disponible).

Qué necesitas

Dos piezas de información:

Un token de bot del BotFather de Telegram.
Una ID de chat — el identificador numérico del chat, canal o grupo en el que quieres que el bot publique.

Ambas vienen de la app de Telegram en sí; pasos abajo.

Crear un bot de Telegram

Hazlo una vez, en Telegram:

Abre Telegram y busca @BotFather. Inicia un chat.
Envía /newbot.
Dale al bot un nombre para mostrar (p. ej. «Structura Publisher»).
Dale un nombre de usuario terminado en bot (p. ej. mysite_structura_bot).
BotFather responde con un token de bot — una cadena larga como 123456:ABCdef.... Cópialo. Es un secreto.

Obtener tu ID de chat

La ID de chat le dice al bot dónde publicar. La forma más rápida de encontrarla es con un bot de ayuda como @RawDataBot o @getidsbot — no necesitas token de bot ni navegador para este paso.

Para un chat privado contigo mismo:

En Telegram, busca @RawDataBot (o @getidsbot) y haz clic en Iniciar.
Responde al instante con un bloque de datos. Encuentra la sección "chat" y copia su id — un entero positivo como 685793393. Ese número es tu ID de chat.
Antes de que Structura pueda escribirte, primero debes abrir tu propio bot y hacer clic en Iniciar — un bot no puede iniciar una conversación contigo (mira la nota en «Qué puede salir mal»).

Para un canal de Telegram:

Publica cualquier mensaje en el canal.
Reenvía ese mensaje a @getidsbot (o @RawDataBot). Responde con la ID del canal — un entero negativo con el prefijo -100, p. ej. -1001234567890.
Añade tu bot de Structura como administrador del canal (Ajustes del canal → Administradores → Añadir admin) para que pueda publicar.

Para un grupo de Telegram:

Añade @RawDataBot (o @getidsbot) al grupo como miembro.
Publica un mensaje mostrando la id del grupo — un entero negativo. Cópiala.
Añade tu bot de Structura al mismo grupo para que pueda publicar. Puedes quitar el bot de ayuda después.

Conectar

En wp-admin, ve a Structura → Channels.
Haz clic en la tarjeta de Telegram. Se abre el panel de instalación.
Pega el token del bot en el campo Token del bot.
Pega la ID de chat en el campo ID de chat.
Haz clic en Conectar. Structura llama a getMe y sendMessage de Telegram para verificar las credenciales y que el bot puede publicar en el chat. Si ambos tienen éxito, el panel de instalación muestra Conectado y el chat objetivo recibe un mensaje de prueba «Structura connected».

Qué puede salir mal

Unauthorized al conectar. El token del bot está mal o el bot fue borrado.
chat not found. La ID de chat está mal, el bot no es miembro de ese chat/canal o el bot no es admin del canal.
Forbidden: bot can't initiate conversation with a user. Para chats privados, el bot solo puede enviarte mensajes después de que tú le hayas mandado uno primero. Manda un mensaje a tu bot y reintenta.
Mensaje enviado pero sin imagen. La imagen destacada de la entrada puede ser demasiado grande (Telegram rechaza archivos de más de 10 MB para bots) o su URL puede no ser alcanzable públicamente.

Mira Un canal muestra «failed» para el playbook completo.

Rotar el token o cambiar de chat

Token nuevo: regenéralo con /token en BotFather, después haz clic en Reconectar en el panel de instalación de Telegram y pega el nuevo.
Chat nuevo: consigue la nueva ID de chat de la misma manera, después pégala en el panel de instalación. Puedes mantener el mismo bot.