telegram-groupfactory-bot

Conventional Telegram Bot API client for telegram-groupfactory.

This service does not use Telethon and does not replace the userbot commands. It talks to the userbot REST API with X-API-Key, so the userbot remains the only service that owns Telegram user-session operations.

Commands

/newgrp                         - Guided group creation through the API
/get_group <group_id>            - Read group info
/group_add_users <group_id> <user_id> ...

/get_users                       - Show default group users
/set_users <id_or_username_or_id:username> ...
/add_users <id_or_username_or_id:username> ...
/remove_users <id_or_username_or_id:username> ...
/add_user <username_or_id:username>

/get_qr [qr_group]
/set_qr <payload>
/set_qr <qr_group> <payload>
/set_qr_group <qr_group>         - Forward a .importbackup QR image
/qr_groups [qr_group]
/qr_group_add <qr_group> <telegram_group_id> ...
/qr_group_remove <telegram_group_id> ...
/sync_qr [qr_group|all]

/users
/user <user_id>
/delete_user <user_id>
/ping
/cancel

/newgrp also accepts quick input:

/newgrp Group name | Group description

Configuration

TELEGRAM_BOT_TOKEN       BotFather token for the conventional bot
GROUPFACTORY_API_BASE_URL Internal URL for the userbot REST API
GROUPFACTORY_API_KEY     Must match API_KEY on telegram-groupfactory
BOT_ALLOWED_CHAT_IDS     Comma-separated chat IDs allowed to use this bot
GROUPFACTORY_API_TIMEOUT API timeout in seconds, default 300

Inside the same Kubernetes namespace, GROUPFACTORY_API_BASE_URL can be:

http://groupfactory:8000

Local Run

cp .env.example .env
python3 -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt
python -m src.main

Kubernetes

Apply the example config and secret after replacing values:

kubectl apply -f examples/configmap.yaml
kubectl apply -f examples/secret.yaml
kubectl apply -f k8s/

The Deployment runs in namespace groupfactory, the same namespace as the userbot.