Send reminders and messages to Telegram with cloud-based scheduling. Use when the user wants to send immediate messages or schedule future reminders to Telegram. Supports text messages, timestamp-based scheduling, recurring reminders, viewing and canceling scheduled messages, and message history.
Send immediate messages and schedule reminders to Telegram with cloud-based scheduling powered by Convex. Your reminders run 24/7 in Convex Cloud with zero infrastructure management.
IMPORTANT! Always use these commands in order:
tsx scripts/send_message.ts [message_text]tsx scripts/send_message.ts [message_text] /path/to/file.pdftsx scripts/schedule_message.ts [time expression] [title] [message_text] [file_path]tsx scripts/schedule_message.ts [time expression] [title] [message_text] /path/to/filetsx scripts/list_scheduled.tstsx scripts/cancel_message.ts <message_id>tsx scripts/view_history.ts [limit](user must provide):
/newbot → copy tokenSetup steps:
# 1. Install dependencies
cd /mnt/skills/user/telegram-reminders && npm install
# 2. Save configuration
mkdir -p /mnt/user-data/outputs
cat > /mnt/user-data/outputs/telegram_config.json << 'EOF'
{
"botToken": "YOUR_BOT_TOKEN",
"userId": "YOUR_USER_ID",
"deployKey": "YOUR_DEPLOY_KEY",
"setupDate": "CURRENT_DATE"
}
EOF
# 3. Create .env.local
cat > .env.local << 'EOF'
CONVEX_DEPLOY_KEY=YOUR_DEPLOY_KEY
EOF
# 4. Set environment variables in Convex
npx convex env set TELEGRAM_BOT_TOKEN "YOUR_BOT_TOKEN"
npx convex env set TELEGRAM_USER_ID "YOUR_USER_ID"
# 5. Deploy to Convex
npx convex deploy
# 6. Test with a message
tsx scripts/send_message.ts "Setup complete!"
Critical: User must start a chat with their bot (search and press "Start") before the bot can send messages.
Send text message:
tsx scripts/send_message.ts "Your message text here"
Example with special characters:
tsx scripts/send_message.ts "Hello! Here's a test message 🚀"
All times use user's configured timezone. The Convex backend stores UTC internally; client scripts handle conversion via chrono-node.
references/initial_setup.md - Detailed setup processreferences/architecture.md - System architecturereferences/convex.md - Convex platform detailsreferences/telegram_api.md - Telegram Bot APIreferences/error_handling.md - Error resolution guide