Avisos a Telegram
Cómo poner el bot del grupo de la mesa, elegir qué canales y avisos llegan, probar el envío y configurar tus avisos personales por campaña y canal.
Roliando puede mandar avisos a Telegram de dos maneras, y las dos usan un bot que creas tú:
- El grupo de la mesa. El máster conecta el bot de su grupo y ahí llegan los avisos de próximas sesiones y, si quiere, lo que se escribe en los canales de la campaña.
- Los tuyos. Cada persona puede conectar su propio bot para enterarse, en su Telegram, de lo que pasa en las campañas y canales que elija. Nada sale si no lo eliges.
Roliando nunca habla con Telegram desde tu navegador: la dirección del bot se guarda en la base y el envío lo hace el servidor.
Crear el bot
- En Telegram, escribe a @BotFather y manda
/newbot. Te pide un nombre y un usuario para el bot y te devuelve un token con esta pinta:123456789:AAH.... - Para el grupo de la mesa: añade el bot al grupo. Si el grupo tiene temas, el bot tiene que poder escribir en el que quieras usar.
- Para tus avisos personales: abre una conversación con tu bot y escríbele algo, aunque sea «hola». Sin ese primer mensaje, Telegram no deja que el bot te escriba.
Armar la dirección
La dirección que pegas en Roliando tiene siempre esta forma:
https://api.telegram.org/bot<token>/sendMessage?chat_id=<id>Cambia <token> por el que te dio BotFather y <id> por el número del chat. Para sacar ese número:
- Escribe un mensaje en el grupo (o a tu bot, si es para ti).
- Abre en el navegador
https://api.telegram.org/bot<token>/getUpdates. - Busca
"chat":{"id":y copia el número que sigue. En un grupo suele ser negativo (-1001234567890); en tu chat personal es positivo.
Si el grupo usa temas y quieres que los avisos caigan en uno concreto, añade al final &message_thread_id=<número del tema>.
La dirección lleva el token del bot: quien la tenga puede escribir en tu grupo. No la pegues en el chat ni la compartas. Roliando solo se la enseña al máster dueño de la campaña (la del grupo) o a ti (la tuya).
El grupo de la mesa
La ve y la cambia el máster dueño de la campaña (y un administrador).
Entra en Campaña → Configuración, en la sección Convivencia, y busca Aviso a Telegram. Pega la dirección. Se guarda al salir del campo.
Si algo no cuadra, el campo te lo dice:
| Mensaje | Qué pasa |
|---|---|
| Es el enlace de invitación al grupo, no la dirección del bot | Has pegado el enlace t.me/... del grupo. Con eso no se publica nada: hace falta la dirección del bot. |
| Falta el grupo: añade ?chat_id=<id> al final de la dirección | Tienes el bot, pero no a qué chat escribir. |
| No parece la dirección de un bot de Telegram | Tiene que empezar por https://api.telegram.org/bot. |
Con la dirección correcta aparece Enviar mensaje de prueba. Púlsalo: si todo va bien llega al grupo un mensaje con el nombre de la campaña, y Roliando avisa de Mensaje de prueba enviado. Si no, dice «Telegram no ha aceptado el mensaje: revisa el token y el grupo». Casi siempre es el token mal copiado, el bot sin añadir al grupo o un chat_id equivocado.
Qué canales llegan al grupo
Debajo de la prueba, Enviar también lo que se escribe en los canales reenvía al grupo lo que se escribe en la campaña. Está apagado hasta que lo enciendes.
- Canales que se envían. Marca los canales que quieres. Solo salen los canales abiertos a toda la mesa: un canal oculto o limitado a unos jugadores nunca sale. Sin marcar ninguno, salen todos los de historia, menos el chat fuera de personaje.
- Qué mensajes. Lo que dicen los personajes y Lo que cuenta el máster. Siempre queda al menos uno marcado.
Cada mensaje llega con el nombre del canal y de quien lo escribe.
Tus avisos personales
En Ajustes → Avisos, en el apartado Telegram:
- Pega la dirección de tu bot (con tu
chat_id) y pulsa Guardar dirección. - Pulsa Enviar prueba para comprobar que te llega.
- Elige de qué quieres enterarte. Cada campaña tiene tres niveles: Todo, Menciones (cuando te nombran o te responden) y Nada. Con Añadir una campaña sumas las que quieras.
- Dentro de cada campaña, Canales te deja poner un nivel distinto a un canal. Los demás siguen Como la campaña.
No te llega un mensaje por cada línea: Roliando junta lo nuevo y manda un único mensaje cada pocos minutos, con una entrada por campaña o canal.
Recibir avisos en Telegram los pausa sin borrar nada. Si Telegram deja de aceptar los avisos (el bot se borró, lo bloqueaste), Roliando los apaga y te enseña el motivo: arregla el bot y vuelve a encenderlos. Quitar borra tu dirección y lo que elegiste en cada campaña.
Problemas frecuentes
- La prueba falla. Revisa el token (sin espacios), que el bot esté en el grupo y el
chat_id. Para un chat personal, escribe antes a tu bot. - Llega la prueba pero no los canales. Comprueba que el interruptor de canales esté encendido, que el canal sea de los abiertos a toda la mesa y que su tipo de mensaje esté marcado.
- No veo el campo en la campaña. Solo lo ve el máster dueño de la campaña.
- Cambié el token en BotFather. La dirección vieja deja de valer: pega la nueva.
Límites
- Roliando solo envía texto. No reenvía imágenes, tiradas de dados ni respuestas desde Telegram.
- Los avisos son de mejor esfuerzo: un fallo de Telegram no detiene la partida.
- Un bot por grupo de mesa y un bot por persona.