Anúncios agendados e modo noturno

Introdução

Duas tarefas administrativas comuns são repetir a mesma mensagem em um horário programado e silenciar o grupo durante a noite. Os anúncios agendados permitem que o bot publique uma mensagem por você, uma única vez ou de forma recorrente, para que você não precise se lembrar de republicar as regras ou um lembrete. O modo noturno silencia o grupo durante uma janela diária e o reabre depois, para que uma conversa em um fuso horário não acorde pessoas em outro.

Ambos os recursos vêm desativados por padrão e não fazem nada até que um admin os configure. Ativar o bot nunca faz com que ele comece a publicar anúncios ou silenciar o grupo por conta própria.

Anúncios agendados

Um admin registra um anúncio com o comando /announce. A primeira palavra após o comando é a programação, e o restante é o texto a ser publicado. Todos os comandos de anúncio são exclusivos para admins.

Para agendar uma mensagem, use uma cadência ou a palavra once seguida do texto:

• /announce 6h Read the /rules — publica esta mensagem a cada 6 horas.
• /announce once Welcome, the AMA starts at noon. — publica esta mensagem uma única vez e depois para.

Cadências recorrentes são escritas como durações. As unidades compatíveis incluem minutos, horas, dias e semanas, por exemplo 30m, 6h, 1d e 2w. Há um mínimo de 5 minutos para anúncios recorrentes, portanto uma programação com intervalo menor que cinco minutos é rejeitada. Anúncios avulsos (once) ficam isentos desse mínimo porque são disparados apenas uma vez.

Mais dois subcomandos gerenciam anúncios existentes:

• /announce list — mostra os anúncios atuais do grupo, cada um com seu id.
• /announce del <id> — remove um anúncio pelo seu id, por exemplo /announce del 42. A exclusão é limitada ao seu grupo, então um id de outro grupo não pode ser removido por engano.

Cada grupo tem um limite de quantos anúncios pode manter ao mesmo tempo (20). Se você atingir o limite, remova um antes de adicionar outro. Depois que um anúncio é salvo, um agendador o publica quando chega a hora: anúncios recorrentes são reagendados para a próxima execução após cada publicação, e anúncios avulsos são desativados depois de dispararem. Se o bot não conseguir publicar em um grupo no momento em que um anúncio estiver previsto (por exemplo, se o bot tiver sido removido), a programação ainda avança para que o grupo não seja verificado infinitamente.

Modo noturno

O modo noturno silencia todos os membros durante uma janela diária e restaura as publicações quando a janela termina. Ele é controlado por um conjunto de configurações no painel do grupo, sendo a principal set_night_mode_enabled, que fica desativada por padrão. A janela é definida por um horário de início, um horário de término e um deslocamento em relação ao UTC que associa esses horários ao relógio local do grupo.

Você pode configurar o modo noturno em dois lugares:

• No painel. Abra o grupo no painel de administração e defina a janela na seção Moderação automática.
• No chat, com o comando /nightmode, exclusivo para admins.

O comando /nightmode aceita uma janela e alguns controles:

• /nightmode 22:00-07:00 +1 — silencia os membros das 22:00 às 07:00 em um grupo cujo horário local está uma hora à frente do UTC. A janela pode atravessar a meia-noite, como neste exemplo.
• /nightmode on — ativa o modo noturno usando a janela salva.
• /nightmode off — desativa o modo noturno. Se o grupo estiver silenciado pelo modo noturno no momento, isso também o reabre.
• /nightmode status — mostra a janela atual, o deslocamento e se o grupo está silenciado agora.

Os horários são informados no horário local do grupo, e o deslocamento ao final (por exemplo +1 ou -5) é um deslocamento UTC em horas inteiras que informa ao bot como o relógio local do grupo se relaciona com o UTC. Um agendador verifica a janela e bloqueia ou desbloqueia o grupo nos limites, então a transição acontece automaticamente todos os dias.

Admins não são afetados pelo modo noturno. O silenciamento se aplica a membros comuns, então moderadores e admins ainda podem publicar enquanto o grupo está quieto. Isso significa que um admin pode enviar um anúncio tarde da noite mesmo durante a janela silenciosa.

Como o modo noturno e o bloqueio contra raids se coordenam

O modo noturno e a proteção anti-raid funcionam bloqueando as permissões de envio do grupo, então compartilham o mesmo bloqueio subjacente e coordenam quando liberá-lo. Se a janela do modo noturno terminar enquanto um bloqueio contra raid ainda estiver ativo, o grupo permanece bloqueado por causa da raid; se um bloqueio contra raid terminar enquanto a janela do modo noturno ainda estiver ativa, o grupo permanece bloqueado por causa do modo noturno. O grupo só reabre quando nenhum dos recursos quer mantê-lo fechado, então um nunca remove um bloqueio de que o outro ainda precisa.

Boas práticas

• Use um anúncio recorrente para lembretes permanentes, como as regras do grupo, e once para avisos com prazo limitado, como o início de um evento.
• Mantenha a quantidade de anúncios abaixo do limite por grupo, removendo entradas antigas com /announce list e /announce del <id>.
• Configure o deslocamento do modo noturno com cuidado para que a janela corresponda ao relógio local dos membros; verifique depois com /nightmode status.
• Lembre-se de que admins ainda podem publicar durante o modo noturno, então use uma conta que não seja admin se quiser confirmar que o silenciamento está funcionando.

Resumo

Anúncios agendados e modo noturno automatizam duas tarefas administrativas repetitivas. /announce publica uma mensagem uma vez ou em uma cadência recorrente, com limite mínimo de 5 minutos para programações recorrentes, um limite por grupo e subcomandos list/del para gerenciar o que está agendado. O modo noturno silencia membros durante uma janela diária definida no horário local por meio de um deslocamento UTC em horas inteiras, deixa admins livres para publicar e se coordena com o bloqueio contra raids para que os dois nunca entrem em conflito pelo bloqueio do grupo. Ambos os recursos permanecem desativados até que um admin os ative.