Telegram Bot¶

The telegram app (src/telegram/) integrates Revel with Telegram, providing account linking, event interactions, and organizer notifications.

Overview¶

flowchart LR
    subgraph Telegram
        U[User] <--> Bot[Revel Bot]
    end

    subgraph Revel Backend
        Bot <--> LP[Long-Polling Handler]
        LP <--> R[Routers]
        R <--> SVC[Services Layer]
        NS[Notification System] --> Bot
    end

Core Features¶

Account Linking via OTP¶

Users link their Telegram account to their Revel account using a one-time password (OTP):

1. User sends /connect to the bot
2. Bot generates a 9-digit OTP code and displays it to the user
3. User enters the OTP code in the Revel web app
4. The web app validates the code and links the accounts

Once linked, the user can receive notifications and interact with events directly from Telegram.

Inline Keyboards¶

User interactions are driven by inline keyboard buttons rather than free-text input, providing a guided experience. Organizers receive action buttons on notifications (e.g., approve/reject invitation requests, approve/reject whitelist requests).

Notification Delivery¶

The bot integrates with Revel's notification system to deliver messages to users and organizers via Celery tasks:

• Event updates and reminders
• RSVP and ticket confirmations
• Questionnaire submissions requiring review
• Invitation and whitelist request actions

Event Interactions¶

Users can interact with events directly from Telegram callback queries:

• RSVP to events
• Request invitations
• Join waitlists
• Request membership

Superuser Broadcast¶

Superusers can broadcast messages to all bot users via a dedicated FSM flow.

Technical Details¶

Bot Commands¶

Configuration¶

Access control is not configured via environment variables: broadcast powers come from RevelUser.is_superuser, and organizer actions from the acting user's OrganizationStaff permissions on the target organization (see src/telegram/middleware.py).