Agendar mensagens automáticas no Discord com bot

Instalar node-schedule#

O node-schedule é a biblioteca mais usada para agendamentos em bots Discord com Node.js. Para instalar no projeto do bot:

npm install node-schedule

E importe no arquivo do bot:

const schedule = require('node-schedule');

Mensagem em horário específico#

Para enviar uma mensagem em uma data e hora específica:

client.once('ready', () => { const canal = client.channels.cache.get('ID_DO_CANAL'); // Agendar para 25 de dezembro às 00:00 no horário de Brasília const data = new Date('2026-12-25T00:00:00-03:00'); schedule.scheduleJob(data, () => { canal.send('Feliz Natal! 🎄'); }); });

O agendamento é cancelado automaticamente após a execução. Para datas passadas, o job não executa.

Mensagem recorrente (diária/semanal)#

Use sintaxe cron para agendamentos que se repetem. O formato é:

segundo minuto hora dia-mês mês dia-semana

client.once('ready', () => { const canal = client.channels.cache.get('ID_DO_CANAL'); // Todo dia às 9h no horário de Brasília schedule.scheduleJob( { rule: '0 9 * * *', tz: 'America/Sao_Paulo' }, () => { canal.send('Bom dia! Lembre-se de votar no servidor hoje. 🗳️'); } ); // Toda segunda-feira às 10h schedule.scheduleJob( { rule: '0 10 * * 1', tz: 'America/Sao_Paulo' }, () => { canal.send('É segunda! Novidades da semana no #anuncios 📢'); } ); });

• 0 9 * * * — todo dia às 9h
• 0 12 * * 1 — toda segunda-feira ao meio-dia
• 0 0 1 * * — no dia 1 de cada mês à meia-noite
• */30 * * * * — a cada 30 minutos

Cancelar agendamentos#

Para cancelar um agendamento, guarde a referência do job e chame o método cancel():

const job = schedule.scheduleJob('0 9 * * *', () => { canal.send('Mensagem diária'); }); // Cancelar quando necessário job.cancel();

Boas práticas de agendamento#

• Sempre especifique o fuso com tz: 'America/Sao_Paulo' para evitar surpresas
• Verifique se o canal existe antes de enviar: if (!canal) return;
• Use try/catch dentro do callback do job para erros silenciosos não derrubarem o processo
• Evite muitas mensagens automáticas: usuários podem silenciar ou sair do servidor
• Teste o agendamento com um horário próximo antes de colocar em produção

Para o bot funcionar sem interrupções e os agendamentos executarem corretamente, é essencial uma hospedagem estável. Veja como hospedar o bot 24/7 e como configurar o PM2 para manter o processo ativo.