Telegram Configuration

Full Telegram configuration reference. For initial bot setup, see Telegram Bot Setup.

Basic Settings

[telegram]
enabled = false
token = ""                               # Bot token from BotFather
admins = ["user-id"]                     # Admin user IDs
channels = ["group-id"]                  # Registration group IDs

Registration

[telegram]
register_on_start = false                # Auto-register users on /start
group_welcome_text = "Welcome {user}, remember to click on me and 'start bot' to be able to receive messages"
bot_welcome_text = "You are now registered with Poracle"
bot_goodbye_message = ""                 # Message when user loses access

The {user} placeholder in group_welcome_text is replaced with the user's name.

Delegated Admins

Grant users admin access over specific groups or channels:

[[telegram.delegated_admins]]
target = "group_or_channel_id"
admins = ["user_id_1", "user_id_2"]

User Tracking Admins

Allow specific users to manage other users' tracking:

[telegram]
user_tracking_admins = ["user_id_1"]

Messages

[telegram]
unrecognised_command_message = ""        # Reply to unknown commands
unregistered_user_message = ""           # Reply to unregistered users (empty = shrug)

Role Checking

Periodically verify users are still members of registration groups:

[telegram]
check_role = false                       # Enable periodic membership checking
check_role_interval = 6                  # Hours between checks

Reconciliation

[reconciliation.telegram]
update_user_names = false                # Follow Telegram username changes
remove_invalid_users = true              # Remove users who lose group membership