Open-source event management inside Telegram.
Create events, invite guests, collect RSVPs, issue tickets, check people in, and share event media without leaving Telegram.
Try XEvents on Telegram → · Demo walkthrough · Self-hosting · Contributing
For clubs, meetups, workshops and community gatherings. Hosts and guests use Telegram; there is no separate app to install.
- Open @XEvents_bot and press Start.
- Use App to explore the Mini App, or Create event for the guided chat flow.
- For your own event, choose a shared ticket-booking link or a named guest list with personal RSVP links.
- Manage replies and guests, then use Check in guests on event day.
Real app screens, captured locally with fictional events and mocked Telegram calls:
Open the animated walkthrough · Capture details and limitations
 |  |
| Home and upcoming plans | Create an event |
 |  |
| Manage RSVPs and group counts | Check in guests |
Download the optional MP4 version
The walkthrough is a silent sequence of actual local UI captures, not a live Telegram recording. The public bot is a live service. For experiments, use your own development bot and fictional data following the self-hosting guide.
| For organisers | For guests |
|---|---|
| Create events in chat or the Mini App, with timezones and reminders | Open invitations and see local event times |
| Share booking links or personal invitations; manage co-hosts | Accept, Reject, Maybe or Respond later on named invitations |
| Track group counts, approval requests and attendance | Receive tickets after required approval and payment |
| Check in groups with on-demand codes or optional QR tickets | Request a short-lived check-in code; use QR when enabled |
| Configure free events, manual payments or Telegram Stars | Share photos, videos and files in the event gallery |
| Control guest-list, media and private-location access | Access private details when attendance requirements are met |
QR codes are optional and off for new events. Stars payouts to organisers are manual. Direct card processing and calendar synchronisation are not implemented.
Share photos with attendees in one event collection, with no built-in photo-count limit. Telegram and hosting limits apply; Mini App downloads support files up to 20 MB, with Send to Telegram available for larger files.
Full feature guide · Invitations and guest counts · Payments and refunds
You need Node.js 22+, npm, your own Telegram bot, and Cloudflare Workers with D1.
git clone https://github.com/ehsan0921/Telegram-event-management.git
cd Telegram-event-management
npm ci
cp .dev.vars.example .dev.vars
# Fill .dev.vars with your own development bot secrets before continuing.
npx wrangler d1 migrations apply xevents --local
npx wrangler devOpen the local /app route to preview the interface. Signed Telegram identity is required for private data; follow local and Telegram setup for a complete flow. Keep development and production bots separate.
XEvents is MIT-licensed JavaScript with a plain HTML/CSS Mini App. A Cloudflare Worker serves the webhook, Mini App and API; D1 stores records, and Telegram hosts uploaded media. Provider quotas apply: unlimited free hosting or storage is not promised. Architecture and limits →
| Guide | Purpose |
|---|---|
| Detailed overview | Extended introduction, invitation examples and quick start |
| Self-hosting | Your own bot, database, secrets and deployment |
| Development | Separate environments and required checks |
| Features | Supported flows and examples |
| Invitations | RSVP, guest counts, co-hosts and check-in |
| Payments | Manual review, Stars and refunds |
| Architecture | Code map and operational constraints |
| UX review | User journeys and test boundaries |
Bug reports, documentation, accessibility improvements and focused pull requests are welcome. Start with CONTRIBUTING.md. Run npm test for regression coverage and npm run test:worker for the Worker bundle and local database checks.
Keep tokens, private deployment settings and real guest data out of issues and screenshots. Report vulnerabilities privately through SECURITY.md.