Agenda Google (Digest quotidien)

Description

Guide Utilisateur

Reliez un ou plusieurs agendas Google à votre serveur : le bot publie chaque jour un résumé des événements à venir, et peut afficher un panneau interactif où chacun s'abonne à un rappel J-1 en message privé.

Ce que ça fait

• Publie un digest quotidien des événements des 30 prochains jours, dans le salon et à l'heure de votre choix.
• Affiche un panneau d'événements interactif : pagination, actualisation automatique et compteur avant la prochaine mise à jour.
• Envoie un rappel J-1 en message privé aux membres qui s'abonnent à un événement depuis le panneau.
• Suit plusieurs agendas à la fois : publics (lus sans connexion) ou privés (lus via un compte Google connecté).
• Respecte le fuseau horaire que vous définissez pour le serveur.

Ce que vous devez fournir côté Google

Vous n'avez rien à créer chez Google : ni projet Google Cloud, ni clé d'API, ni identifiant OAuth. TennoCore fournit tout cela. Selon le type d'agenda, il vous faut simplement :

Agenda public

1. L'ID de l'agenda. Sur un ordinateur, ouvrez calendar.google.com → survolez l'agenda dans « Mes agendas » → menu ⋮ → Paramètres et partage → section Intégrer l'agenda → copiez ID de l'agenda.
2. L'agenda doit être rendu public : même page → Autorisations d'accès → Rendre disponible publiquement. Sans cela, le bot ne peut pas le lire.

Un lien Google contenant cid= est également accepté à la place de l'ID.

Agenda privé

1. Un membre (souvent vous) doit connecter son compte Google : bouton Connecter mon compte Google du dashboard, ou /agenda connect sur Discord. Google affiche un code à saisir sur une page dédiée. L'autorisation demandée est en lecture seule sur les agendas.
2. Une fois le compte connecté, choisissez-le comme propriétaire et sélectionnez l'agenda dans la liste proposée. L'agenda n'a alors pas besoin d'être public.

remarque

Un agenda privé est lu avec le jeton du compte qui l'a autorisé. Si ce membre déconnecte son compte, les agendas privés rattachés cessent d'être lisibles.

Démarrage rapide (Admin)

1. Réglez le fuseau horaire : /agenda timezone tz:Europe/Paris.
2. Ajoutez un agenda : /agenda calendrier ajouter_public calendar_id:<ID> (ou passez par le dashboard).
3. Choisissez le salon et l'heure : /agenda digest config_responses channel:#agenda hour:9.
4. Vérifiez le rendu : /agenda digest tester.
5. Activez l'envoi quotidien : /agenda digest enable_module.

Commandes

Compte Google (tout le monde)

Commande	Description
/agenda connect	Connecter votre compte Google (code à saisir sur une page Google).
/agenda me	Voir l'état de votre connexion Google.
/agenda disconnect	Vous déconnecter et supprimer vos jetons Google.
/agenda my_events	Vos 5 prochains événements, en réponse privée.
/agenda publish	Publier un panneau d'événements interactif.
/agenda digest tester	Publier immédiatement un digest de test.

Paramètres de /agenda publish : channel (sinon le salon courant), days (fenêtre de 1 à 60 jours, 30 par défaut), refresh_every (actualisation automatique de 30 à 3600 secondes, 300 par défaut).

Agendas suivis

Commande	Description
/agenda calendrier lister	Lister les agendas suivis par ce serveur.
/agenda calendrier ajouter_public	Ajouter un agenda public (ID ou lien contenant cid=), avec un libellé facultatif. (Administrateur)
/agenda calendrier ajouter_prive	Ajouter un agenda privé en s'appuyant sur le compte Google d'un membre connecté. (Administrateur)
/agenda calendrier retirer	Retirer un agenda suivi (l'ID est auto-complété). (Administrateur)

Digest quotidien

Commande	Description
/agenda digest config_responses	Choisir le salon et l'heure locale d'envoi (0–23). (Administrateur)
/agenda digest enable_module	Activer l'envoi quotidien. (Administrateur)
/agenda digest desactiver	Désactiver l'envoi quotidien. (Administrateur)
/agenda timezone	Définir le fuseau horaire du serveur, au format IANA. (Administrateur)

Réglages depuis le dashboard

Dashboard → catégorie Outils & Staff → Planning Google Calendar.

• Configuration du digest : salon de publication, heure d'envoi (0–23), fuseau horaire (Europe/Paris, UTC, America/New_York) et interrupteur d'activation.
• Calendriers privés : liste des comptes Google connectés (avec leur adresse e-mail), bouton pour en connecter un de plus, bouton pour en déconnecter un.
• Calendriers : liste des agendas suivis, avec une icône indiquant public ou privé, l'ID et le compte propriétaire. Ajout via une fenêtre où vous choisissez d'abord le type :
  • Public : vous collez l'ID (une aide dépliable explique où le trouver).
  • Privé : vous choisissez le compte connecté, puis l'agenda dans la liste de ce compte.
  • Dans les deux cas, vous pouvez donner un nom d'affichage.
• Aperçu des événements (30j) : les 10 prochains événements groupés par jour, avec un lien vers Google Calendar.
• Tester le Digest : publie immédiatement un digest dans le salon configuré.

Le nombre d'agendas suivis est limité à 3 pour un serveur non premium (valeur par défaut, ajustable par l'équipe TennoCore).

Bon à savoir

• Le digest est vérifié toutes les 5 minutes et n'est publié qu'une fois par jour, pendant l'heure que vous avez choisie. Si le bot est indisponible durant toute cette heure, le digest du jour est simplement sauté — il ne sera pas rattrapé plus tard.
• Le digest couvre toujours 30 jours et affiche 25 événements par page.
• Sans agenda configuré, /agenda publish refuse de publier et vous invite à en ajouter un.
• Le panneau d'événements est temporaire : ses boutons cessent de répondre après un quart d'heure sans interaction, et l'actualisation automatique s'arrête avec lui. Pour un affichage permanent, utilisez le digest quotidien plutôt que le panneau.
• Les boutons Actualiser maintenant, Me notifier J-1 et Ne plus notifier sont réservés au membre qui a lancé la commande : les autres reçoivent un refus. Chacun doit donc publier son propre panneau pour s'abonner, ou passer par le panneau du digest.
• Les rappels J-1 arrivent en message privé : un membre qui a fermé ses MP ne les recevra pas. Ils sont contrôlés chaque minute.
• Le fuseau horaire pilote l'heure d'envoi et l'affichage des dates. Le dashboard ne propose que trois fuseaux ; /agenda timezone accepte n'importe quel nom IANA (Europe/Brussels, America/Sao_Paulo, …).
• Le bot a besoin des permissions Envoyer des messages et Intégrer des liens dans le salon du digest.
• /agenda disconnect supprime vos jetons Google côté TennoCore. Les agendas publics du serveur continuent de fonctionner, les agendas privés qui dépendaient de votre compte non.