Google Agenda (Resumo diário)

Descrição

Guia do Usuário

Vincule um ou mais calendários do Google ao seu servidor: o bot publica todos os dias um resumo dos próximos eventos e pode exibir um painel interativo no qual cada membro se inscreve para receber um lembrete um dia antes por mensagem privada.

O que ele faz

• Publica um resumo diário dos eventos dos próximos 30 dias, no canal e no horário que você escolher.
• Exibe um painel de eventos interativo: paginação, atualização automática e contador até a próxima atualização.
• Envia um lembrete um dia antes por mensagem privada aos membros que se inscrevem em um evento pelo painel.
• Acompanha vários calendários ao mesmo tempo: públicos (lidos sem autenticação) ou privados (lidos por meio de uma conta Google conectada).
• Respeita o fuso horário que você definir para o servidor.

O que você precisa fornecer do lado do Google

Você não precisa criar nada no Google: nem projeto no Google Cloud, nem chave de API, nem credencial OAuth. O TennoCore fornece tudo isso. Dependendo do tipo de calendário, basta ter:

Calendário público

1. O ID do calendário. Em um computador, abra calendar.google.com → passe o cursor sobre o calendário em "Meus calendários" → menu ⋮ → Configurações e compartilhamento → seção Incorporar agenda → copie o ID da agenda.
2. O calendário deve estar público: mesma página → Permissões de acesso → Disponibilizar publicamente. Sem isso, o bot não consegue lê-lo.

Um link do Google contendo cid= também é aceito no lugar do ID.

Calendário privado

1. Um membro (normalmente você) deve conectar sua conta Google: botão Conectar minha conta Google no dashboard, ou /agenda connect no Discord. O Google exibe um código a ser inserido em uma página dedicada. A autorização solicitada é somente leitura nos calendários.
2. Depois de conectar a conta, escolha-a como proprietária e selecione o calendário na lista apresentada. Nesse caso, o calendário não precisa ser público.

observação

Um calendário privado é lido com o token da conta que o autorizou. Se esse membro desconectar a conta, os calendários privados vinculados deixam de ser legíveis.

Início rápido (Admin)

1. Defina o fuso horário: /agenda timezone tz:America/Sao_Paulo.
2. Adicione um calendário: /agenda calendrier ajouter_public calendar_id:<ID> (ou use o dashboard).
3. Escolha o canal e o horário: /agenda digest config_responses channel:#agenda hour:9.
4. Verifique o resultado: /agenda digest tester.
5. Ative o envio diário: /agenda digest enable_module.

Comandos

Conta Google (todos)

Comando	Descrição
/agenda connect	Conectar sua conta Google (código a inserir em uma página do Google).
/agenda me	Ver o estado da sua conexão com o Google.
/agenda disconnect	Desconectar-se e excluir seus tokens do Google.
/agenda my_events	Seus 5 próximos eventos, em resposta privada.
/agenda publish	Publicar um painel de eventos interativo.
/agenda digest tester	Publicar imediatamente um resumo de teste.

Parâmetros de /agenda publish: channel (se omitido, o canal atual), days (janela de 1 a 60 dias, 30 por padrão), refresh_every (atualização automática de 30 a 3600 segundos, 300 por padrão).

Calendários acompanhados

Comando	Descrição
/agenda calendrier lister	Listar os calendários acompanhados por este servidor.
/agenda calendrier ajouter_public	Adicionar um calendário público (ID ou link contendo cid=), com um rótulo opcional. (Administrador)
/agenda calendrier ajouter_prive	Adicionar um calendário privado usando a conta Google de um membro conectado. (Administrador)
/agenda calendrier retirer	Remover um calendário acompanhado (o ID é preenchido automaticamente). (Administrador)

Resumo diário

Comando	Descrição
/agenda digest config_responses	Escolher o canal e o horário local de envio (0–23). (Administrador)
/agenda digest enable_module	Ativar o envio diário. (Administrador)
/agenda digest desactiver	Desativar o envio diário. (Administrador)
/agenda timezone	Definir o fuso horário do servidor, no formato IANA. (Administrador)

Configuração pelo dashboard

Dashboard → categoria Ferramentas & Equipe → Planejamento Google Calendar.

• Configuração do resumo: canal de publicação, horário de envio (0–23), fuso horário (Europe/Paris, UTC, America/New_York) e interruptor de ativação.
• Calendários privados: lista das contas Google conectadas (com seus endereços de e-mail), botão para conectar mais uma, botão para desconectar.
• Calendários: lista dos calendários acompanhados, com um ícone indicando público ou privado, o ID e a conta proprietária. A adição é feita por uma janela na qual você escolhe primeiro o tipo:
  • Público: você cola o ID (uma ajuda expansível explica onde encontrá-lo).
  • Privado: você escolhe a conta conectada e depois o calendário na lista dessa conta.
  • Nos dois casos, você pode definir um nome de exibição.
• Prévia dos eventos (30d): os 10 próximos eventos agrupados por dia, com um link para o Google Calendar.
• Testar o Resumo: publica imediatamente um resumo no canal configurado.

O número de calendários acompanhados é limitado a 3 para um servidor não premium (valor padrão, ajustável pela equipe TennoCore).

Bom saber

• O resumo é verificado a cada 5 minutos e publicado apenas uma vez por dia, durante a hora que você escolheu. Se o bot ficar indisponível durante toda essa hora, o resumo do dia é simplesmente ignorado — ele não será recuperado mais tarde.
• O resumo cobre sempre 30 dias e exibe 25 eventos por página.
• Sem nenhum calendário configurado, /agenda publish se recusa a publicar e convida você a adicionar um.
• O painel de eventos é temporário: seus botões param de responder após quinze minutos sem interação, e a atualização automática para junto com ele. Para uma exibição permanente, use o resumo diário em vez do painel.
• Os botões Atualizar agora, Notificar-me um dia antes e Não notificar mais são reservados ao membro que executou o comando: os demais recebem uma recusa. Assim, cada pessoa deve publicar seu próprio painel para se inscrever, ou usar o painel do resumo.
• Os lembretes de um dia antes chegam por mensagem privada: um membro que fechou suas MPs não os receberá. São verificados a cada minuto.
• O fuso horário controla o horário de envio e a exibição das datas. O dashboard oferece apenas três fusos; /agenda timezone aceita qualquer nome IANA (Europe/Brussels, America/Sao_Paulo, …).
• O bot precisa das permissões Enviar mensagens e Inserir links no canal do resumo.
• /agenda disconnect exclui seus tokens do Google no lado do TennoCore. Os calendários públicos do servidor continuam funcionando; os calendários privados que dependiam da sua conta, não.