/sync- Poll users from Aura and synchronize them with the database. Remove all users which not present in Aura.
- Purchase VPN subscriptions with different payment methods (bank cards, cryptocurrency)
- Multiple subscription plans (1, 3, 6, 12 months)
- Automated subscription management
- Subscription Notifications: The bot automatically sends notifications to users 3 days before their subscription expires, helping them avoid service interruption
- Multi-language support (Russian and English)
- Selective Inbound Assignment: Configure specific inbounds to assign to users via UUID filtering
- All telegram message support HTML formatting https://core.telegram.org/bots/api#html-style
The application requires the following environment variables to be set:
| Variable | Description |
|---|---|
PRICE_1 |
Price for 1 month |
PRICE_3 |
Price for 3 month |
PRICE_6 |
Price for 6 month |
MINI_APP_URL |
tg WEB APP URL. if empty not be used. |
PRICE_12 |
Price for 12 month |
STARS_PRICE_1 |
Price in Stars for 1 month |
STARS_PRICE_3 |
Price in Stars for 3 month |
STARS_PRICE_6 |
Price in Stars for 6 month |
STARS_PRICE_12 |
Price in Stars for 12 month |
REFERRAL_DAYS |
Refferal days. if 0, then disabled. |
TELEGRAM_TOKEN |
Telegram Bot API token for bot functionality |
DATABASE_URL |
PostgreSQL connection string |
POSTGRES_USER |
PostgreSQL username |
POSTGRES_PASSWORD |
PostgreSQL password |
POSTGRES_DB |
PostgreSQL database name |
AURA_URL |
Aura API URL |
AURA_MODE |
Aura mode (remote/local), default is remote. If local set – you can pass http://aura-backend:3000 to AURA_URL |
AURA_TOKEN |
Authentication token for Aura API |
CRYPTO_PAY_ENABLED |
Enable/disable CryptoPay payment method (true/false) |
CRYPTO_PAY_TOKEN |
CryptoPay API token |
CRYPTO_PAY_URL |
CryptoPay API URL |
YOOKASA_ENABLED |
Enable/disable YooKassa payment method (true/false) |
YOOKASA_SECRET_KEY |
YooKassa API secret key |
YOOKASA_SHOP_ID |
YooKassa shop identifier |
YOOKASA_URL |
YooKassa API URL |
YOOKASA_EMAIL |
Email address associated with YooKassa account |
TRAFFIC_LIMIT |
Maximum allowed traffic in gb (0 to set unlimited) |
TELEGRAM_STARS_ENABLED |
Enable/disable Telegram Stars payment method (true/false) |
SERVER_STATUS_URL |
URL to server status page (optional) - if not set, button will not be displayed |
SUPPORT_URL |
URL to support chat or page (optional) - if not set, button will not be displayed |
FEEDBACK_URL |
URL to feedback/reviews page (optional) - if not set, button will not be displayed |
CHANNEL_URL |
URL to Telegram channel (optional) - if not set, button will not be displayed |
ADMIN_TELEGRAM_ID |
Admin telegram id |
TRIAL_TRAFFIC_LIMIT |
Maximum allowed traffic in gb for trial subscriptions |
TRIAL_DAYS |
Number of days for trial subscriptions. if 0 = disabled. |
INBOUND_UUIDS |
Comma-separated list of inbound UUIDs to assign to users (e.g., "773db654-a8b2-413a-a50b-75c3536238fd,bc979bdd-f1fa-4d94-8a51-38a0f518a2a2") |
The bot dynamically creates buttons based on available environment variables:
- Main buttons for purchasing and connecting to the VPN are always shown
- Additional buttons for Server Status, Support, Feedback, and Channel are only displayed if their corresponding URL environment variables are set
The bot includes a notification system that runs daily at 16:00 UTC to check for expiring subscriptions:
- Users receive a notification 3 days before their subscription expires
- The notification includes the exact expiration date and a convenient button to renew the subscription
- Notifications are sent in the user's preferred language
The bot supports selective inbound assignment to users:
- Configure specific inbound UUIDs in the
INBOUND_UUIDSenvironment variable (comma-separated) - If specified, only inbounds with matching UUIDs will be assigned to new users
- If no inbounds match the specified UUIDs or the variable is empty, all available inbounds will be assigned
- This feature allows fine-grained control over which connection methods are available to users
- YooKassa API
- CryptoPay API
- Telegram Stars
- Clone the repository
git clone https://github.com/localzet/aura-telegram-bot-go && cd aura-telegram-shop- Create a
.envfile in the root directory with all the environment variables listed above
mv .env.sample .env- Run the bot:
docker compose up -dGo to folder translations inside bot folder and change needed language.
- Pull the latest Docker image:
docker compose pull- Restart the containers:
docker compose down && docker compose up -d