Google Calendar (Resumen diario)
Descripción
Guía de Usuario
Vincule uno o varios calendarios de Google a su servidor: el bot publica cada día un resumen de los próximos eventos y puede mostrar un panel interactivo donde cada persona se suscribe a un recordatorio 1 día antes por mensaje privado.
Qué hace
- Publica un resumen diario de los eventos de los próximos 30 días, en el canal y a la hora que elija.
- Muestra un panel de eventos interactivo: paginación, actualización automática y contador antes de la siguiente actualización.
- Envía un recordatorio 1 día antes por mensaje privado a los miembros que se suscriben a un evento desde el panel.
- Sigue varios calendarios a la vez: públicos (leídos sin conexión) o privados (leídos mediante una cuenta de Google conectada).
- Respeta la zona horaria que defina para el servidor.
Lo que debe aportar por parte de Google
No tiene nada que crear en Google: ni proyecto de Google Cloud, ni clave de API, ni identificador OAuth. TennoCore lo proporciona todo. Según el tipo de calendario, solo necesita:
Calendario público
- El ID del calendario. En un ordenador, abra calendar.google.com → pase el cursor sobre el calendario en «Mis calendarios» → menú ⋮ → Configuración y uso compartido → sección Integrar calendario → copie el ID del calendario.
- El calendario debe estar hecho público: en la misma página → Permisos de acceso → Hacer público. Sin eso, el bot no puede leerlo.
También se acepta un enlace de Google que contenga cid= en lugar del ID.
Calendario privado
- Un miembro (a menudo usted) debe conectar su cuenta de Google: botón Conectar mi cuenta de Google del panel de control, o
/agenda connecten Discord. Google muestra un código que debe introducirse en una página dedicada. El permiso solicitado es de solo lectura sobre los calendarios. - Una vez conectada la cuenta, elíjala como propietaria y seleccione el calendario en la lista propuesta. Entonces el calendario no necesita ser público.
nota
Un calendario privado se lee con el token de la cuenta que lo autorizó. Si ese miembro desconecta su cuenta, los calendarios privados asociados dejan de ser legibles.
Inicio Rápido (Admin)
- Ajuste la zona horaria:
/agenda timezone tz:Europe/Madrid. - Añada un calendario:
/agenda calendrier ajouter_public calendar_id:<ID>(o hágalo desde el panel de control). - Elija el canal y la hora:
/agenda digest config_responses channel:#agenda hour:9. - Compruebe el resultado:
/agenda digest tester. - Active el envío diario:
/agenda digest enable_module.
Comandos
Cuenta de Google (para todos)
| Comando | Descripción |
|---|---|
/agenda connect | Conectar su cuenta de Google (código que introducir en una página de Google). |
/agenda me | Ver el estado de su conexión con Google. |
/agenda disconnect | Desconectarse y eliminar sus tokens de Google. |
/agenda my_events | Sus 5 próximos eventos, en respuesta privada. |
/agenda publish | Publicar un panel de eventos interactivo. |
/agenda digest tester | Publicar de inmediato un resumen de prueba. |
Parámetros de /agenda publish: channel (si no, el canal actual), days (ventana de 1 a 60 días, 30 por defecto), refresh_every (actualización automática de 30 a 3600 segundos, 300 por defecto).
Calendarios seguidos
| Comando | Descripción |
|---|---|
/agenda calendrier lister | Listar los calendarios seguidos por este servidor. |
/agenda calendrier ajouter_public | Añadir un calendario público (ID o enlace que contenga cid=), con una etiqueta opcional. (Administrador) |
/agenda calendrier ajouter_prive | Añadir un calendario privado apoyándose en la cuenta de Google de un miembro conectado. (Administrador) |
/agenda calendrier retirer | Quitar un calendario seguido (el ID se autocompleta). (Administrador) |
Resumen diario
| Comando | Descripción |
|---|---|
/agenda digest config_responses | Elegir el canal y la hora local de envío (0–23). (Administrador) |
/agenda digest enable_module | Activar el envío diario. (Administrador) |
/agenda digest desactiver | Desactivar el envío diario. (Administrador) |
/agenda timezone | Definir la zona horaria del servidor, en formato IANA. (Administrador) |
Ajustes desde el panel de control
Panel de control → categoría Herramientas y Staff → Planificación Google Calendar.
- Configuración del resumen: canal de publicación, hora de envío (0–23), zona horaria (Europe/Paris, UTC, America/New_York) e interruptor de activación.
- Calendarios privados: lista de las cuentas de Google conectadas (con su dirección de correo), botón para conectar una más, botón para desconectar una.
- Calendarios: lista de los calendarios seguidos, con un icono que indica si es público o privado, el ID y la cuenta propietaria. Se añaden mediante una ventana donde primero elige el tipo:
- Público: pega el ID (una ayuda desplegable explica dónde encontrarlo).
- Privado: elige la cuenta conectada y luego el calendario en la lista de esa cuenta.
- En ambos casos, puede darle un nombre de visualización.
- Vista previa de los eventos (30 d): los 10 próximos eventos agrupados por día, con un enlace a Google Calendar.
- Probar el Resumen: publica de inmediato un resumen en el canal configurado.
El número de calendarios seguidos está limitado a 3 para un servidor no premium (valor por defecto, ajustable por el equipo de TennoCore).
Bueno saberlo
- El resumen se comprueba cada 5 minutos y solo se publica una vez al día, durante la hora que haya elegido. Si el bot no está disponible durante toda esa hora, el resumen del día simplemente se omite — no se recuperará más tarde.
- El resumen cubre siempre 30 días y muestra 25 eventos por página.
- Sin ningún calendario configurado,
/agenda publishse niega a publicar y le invita a añadir uno. - El panel de eventos es temporal: sus botones dejan de responder tras un cuarto de hora sin interacción, y la actualización automática se detiene con él. Para una visualización permanente, utilice el resumen diario en lugar del panel.
- Los botones Actualizar ahora, Avisarme 1 día antes y No avisarme más están reservados al miembro que lanzó el comando: los demás reciben un rechazo. Por tanto, cada persona debe publicar su propio panel para suscribirse, o pasar por el panel del resumen.
- Los recordatorios de 1 día antes llegan por mensaje privado: un miembro que haya cerrado sus MD no los recibirá. Se comprueban cada minuto.
- La zona horaria rige la hora de envío y la visualización de las fechas. El panel de control solo propone tres zonas;
/agenda timezoneacepta cualquier nombre IANA (Europe/Brussels,America/Sao_Paulo, …). - El bot necesita los permisos Enviar mensajes e Insertar enlaces en el canal del resumen.
/agenda disconnectelimina sus tokens de Google del lado de TennoCore. Los calendarios públicos del servidor siguen funcionando; los calendarios privados que dependían de su cuenta, no.