type: integration name: Telegram Bot API slug: telegram-bot-api category: messaging status: active owner_agent: TODO used_by: [arteggia-bot, pediatric-news, family-tree, claude-bot] last_updated: 2026-05-01

Telegram Bot API

Why deployed

Месенджер-канал для всіх ботів і агентів. Сергій спілкується з Claude через Telegram.

Where used

• Claude Bot (мій канал з Сергієм) — /srv/passepartout/telegram/claude-bot.token
• Arteggia Bot — @arteggia_promo_bot
• Pediatric News — @smart_pediatric_news
• Family Tree — tree-bot

Endpoints / Touchpoints

• API: https://api.telegram.org/bot{TOKEN}/
• WebHook (n8n) або long-polling (claude-bot, arteggia-bot)

Credentials

• Path: /srv/passepartout/telegram/
• Files: claude-bot.token, tree-bot.token, pediatric-news-bot.token, arteggia-bot.token (TODO)

Health & monitoring

• claude-watchdog detect 401 / unresponsive
• telegram-nudge.timer (15 хв) — alert на unanswered

Known issues / quirks

• Bot API не віддає історію — для контексту минулих сесій SessionStart hook читає JSONL transcripts
• 20MB ліміт на attachments
• Reactions whitelist (не всі emoji)

Cost

Free.