telegram-travel

name	telegram-travel
description	Telegram bot interface for the travel agent suite. Handles Telegram commands (/trip, /book, /check, /itinerary), formats agent responses for Telegram, manages user sessions, and sends documents/images. Use as the Telegram-facing layer for all travel planning agents.

Telegram Travel Bot

Telegram wrapper for the travel agent suite.

Commands

Command	Description	Example
/start	Welcome + help	/start
/trip	Find travel windows (Agent 5)	/trip SIN BKK 5days May
/flights	Search flights (Agent 1)	/flights SIN BKK 2025-05-10
/hotels	Search accommodation (Agent 2)	/hotels Bangkok 5nights
/tours	Search tours (Agent 3)	/tours Bangkok
/food	Search restaurants (Agent 4)	/food Bangkok budget
/check	Pre-trip verification (Agent 7)	/check SG TH 2025-05-15
/book	Book trip (Agent 8)	/book 1 (books option 1)
/itinerary	Generate itinerary PDF	/itinerary
/help	Show all commands	/help

Inline Keyboards

• Trip options: Buttons for each recommendation (1, 2, 3)
• Booking confirmation: ✅ Confirm / ❌ Cancel
• Date pickers: Calendar inline keyboard
• Quick actions: /flights /hotels /tours buttons

Message Formatting

Telegram supports:

• Bold: *text* or **text**
• Italic: _text_ or __text__
• Monospace: text
• Links: [text](url)

Session Management

Tracks user state:

• Last search parameters
• Current booking flow
• Selected recommendations
• User preferences (cabin class, budget)

Files

• scripts/telegram_bot.py — Main bot runner
• scripts/handlers/ — Command handlers
• assets/ — Templates, images
• references/ — API docs

Setup

1. Get bot token from @BotFather
2. Configure in Gateway or run standalone
3. Start bot: python3 scripts/telegram_bot.py

See Also

• All travel agent skills (flight-search, stay-search, etc.)
• OpenClaw Telegram provider docs