telegram-reminders

Telegram リマインダー スキル

Convex を利用したクラウドベースのスケジュール管理により、Telegram にすぐにメッセージを送信したり、リマインダーを予約したりできます。リマインダーは Convex Cloud 上で 24 時間 365 日実行され、インフラストラクチャの管理は不要です。

クイックリファレンス

重要！以下のコマンドを必ず順番どおりに使用してください。

• 今すぐ送信：tsx scripts/send_message.ts [message_text]
• 添付ファイル付きですぐに送信：tsx scripts/send_message.ts [message_text] /path/to/file.pdf
• 予約：tsx scripts/schedule_message.ts [time expression] [title] [message_text] [file_path]
• 添付ファイル付きで予約：tsx scripts/schedule_message.ts [time expression] [title] [message_text] /path/to/file
• 予約済みの項目を一覧表示：tsx scripts/list_scheduled.ts
• キャンセル：tsx scripts/cancel_message.ts <message_id>
• 履歴：tsx scripts/view_history.ts [limit]

初期設定

前提条件（ユーザーが用意するもの）：

1. ボットトークン： @BotFather にメッセージを送信 → /newbot → トークンをコピー
2. ユーザー ID： @userinfobot にメッセージを送信 → 数値 ID をコピー
3. デプロイキー：dashboard.convex.dev → プロジェクトを作成 → Settings → Deploy Keys → 「Production」キーを作成

設定手順：

# 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!"

重要：ボットがメッセージを送信するには、ユーザーがボットとのチャットを開始する必要があります（ボットを検索して「Start」を押します）。

主な操作

すぐにメッセージを送信する

テキストメッセージを送信する：

tsx scripts/send_message.ts "Your message text here"

特殊文字を含む例：

tsx scripts/send_message.ts "Hello! Here's a test message 🚀"

タイムゾーン

すべての時刻には、ユーザーが設定したタイムゾーンが使用されます。Convex バックエンドでは内部的に UTC で保存され、クライアントスクリプトが chrono-node を使用して変換します。

制限事項

• ファイルはドキュメントとして送信されます（インライン画像ではありません）
• ファイルサイズの上限：50MB（Telegram の制限）
• Cron の粒度：最小 1 分
• メッセージの編集には対応していません（キャンセルして再予約してください）
• レート制限：ユーザーあたり毎分 20 件

参考資料

• references/initial_setup.md - 詳細な設定手順
• references/architecture.md - システムアーキテクチャ
• references/convex.md - Convex プラットフォームの詳細
• references/telegram_api.md - Telegram Bot API
• references/error_handling.md - エラー解決ガイド