# Telegram Payments Bot
| |
|---|
| [](https://pypi.org/project/telegram_payment_bot/) [](https://pypi.org/project/telegram_payment_bot/) [](https://github.com/ebellocchia/telegram_payment_bot?tab=MIT-1-ov-file) |
| [](https://github.com/ebellocchia/telegram_payment_bot/actions/workflows/build.yml) |
| [](https://app.codacy.com/gh/ebellocchia/telegram_payment_bot/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade) [](https://www.codefactor.io/repository/github/ebellocchia/telegram_payment_bot) |
| |
Telegram bot for handling payments in groups based on *pyrogram* library.\
Payments data can be loaded either from an *xls*/*xlsx* file or from a Google Sheet (in this way, it can be shared with other admins).\
It is also possible to extend this to load payments data from other sources (e.g. a remote database) by inheriting and implementing the `PaymentsLoaderBase` class, but I didn't need to do it so far.\
Payments data can be updated either manually by the admins or, better, automatically (e.g. by the website where the payment is made, via a webhook). It depends on the infrastructure you have.
## Setup
### Create Telegram app
In order to use the bot, in addition to the bot token you also need an APP ID and hash.\
To get them, create an app using the following website: [https://my.telegram.org/apps](https://my.telegram.org/apps).
### Installation
The package requires Python 3, it is not compatible with Python 2.\
To install it:
- Using *setuptools*:
python setup.py install
- Using *pip*:
pip install telegram_payment_bot
To run the bot, edit the configuration file by specifying the API ID/hash and bot token. Then, move to the *app* folder and run the *bot.py* script:
cd app
python bot.py
When run with no parameter, *conf/config.ini* will be the default configuration file (in this way it can be used for different groups).\
To specify a different configuration file:
python bot.py -c another_conf.ini
python bot.py --config another_conf.ini
Of course, the *app* folder can be moved elsewhere if needed.
## Configuration
An example of configuration file is provided in the *app/conf* folder.\
The list of all possible fields that can be set is shown below.
|Name|Description|
|---|---|
|**[pyrogram]**|Configuration for pyrogram|
|`session_name`|Session name of your choice|
|`api_id`|API ID from [https://my.telegram.org/apps](https://my.telegram.org/apps)|
|`api_hash`|API hash from [https://my.telegram.org/apps](https://my.telegram.org/apps)|
|`bot_token`|Bot token from BotFather|
|**[app]**|Configuration for app|
|`app_is_test_mode`|True to activate test mode false otherwise|
|`app_lang_file`|Language file in XML format (default: English)|
|**[users]**|Configuration for users|
|`authorized_users`|List of Telegram usernames that are authorized to use the bot, comma separated|
|**[support]**|Configuration for support|
|`support_email`|Email for getting support or send payments receipts (default: empty)|
|`support_telegram`|Telegram username for getting support or send payments receipts (default: empty)|
|**[payment]**|Configuration for payment|
|`payment_website`|Website for payment (default: empty)|
|`payment_check_on_join`|Flag to check the payment of new members as soon as they join the group (default: `true`)|
|`payment_check_dup_email`|Flag to check for duplicated emails in payment data (default: `true`)|
|`payment_type`|Input for payment data: `EXCEL_FILE` for using xls/xlsx file, `GOOGLE_SHEET` for using a Google Sheet|
|`payment_excel_file`|Name of the Excel file used for payment data, loaded only if `payment_type` is `EXCEL_FILE`|
|`payment_google_sheet_id`|ID of the Google Sheet used for payment data, loaded only if `payment_type` is `GOOGLE_SHEET`|
|`payment_google_cred_type`|Credentials type: `OAUTH2` for OAuth2 flow or `SERVICE_ACCOUNT` for service account (default: `OAUTH2`), loaded only if `payment_type` is `GOOGLE_SHEET`|
|`payment_google_cred`|Name of the *json* credentials file for OAuth2 or service account (default: `credentials.json`), loaded only if `payment_type` is `GOOGLE_SHEET`|
|`payment_google_cred_path`|Path where Google OAuth2 token file will be saved, loaded only if `payment_type` is `GOOGLE_SHEET` and `payment_google_cred_type` is `OAUTH2`|
|`payment_use_user_id`|If true, `payment_user_col` will be considered as a user ID (number), otherwise it'll be considered as a username|
|`payment_worksheet_idx`|Worksheet index (default: `0`)|
|`payment_email_col`|Table column (letter) containing the email used for paying (default: `A`, maximum: `Z`)|
|`payment_user_col`|Table column (letter) containing the user (default: `B`, maximum: `Z`). The user can be a username or a user ID (depending on the `payment_use_user_id` flag).|
|`payment_expiration_col`|Table column (letter) containing the payment expiration date (default: `C`, maximum: `Z`)|
|`payment_date_format`|Date format in payments data (default: `%d/%m/%Y`)|
|**[email]**|Configuration for email that reminds users to pay|
|`email_enabled`|Email enable flag (default: `false`). If false, all the next fields will be skipped.|
|`email_from`|Email sender|
|`email_reply_to`|Email reply-to|
|`email_host`|Host for sending email|
|`email_user`|Username for logging to host|
|`email_password`|Password for logging to host|
|`email_subject`|Email subject|
|`email_alt_body`|File containing email alternate body (text)|
|`email_html_body`|File containing email HTML body|
|**[logging]**|Configuration for logging|
|`log_level`|Log level, same of python logging (`DEBUG`, `INFO`, `WARNING`, `ERROR`, `CRITICAL`). Default: `INFO`.|
|`log_console_enabled`|True to enable logging to console, false otherwise (default: true)|
|`log_file_enabled`|True to enable logging to file, false otherwise (default: false). If false, all the next fields will be skipped.|
|`log_file_name`|Log file name|
|`log_file_use_rotating`|True for using a rotating log file, false otherwise|
|`log_file_max_bytes`|Maximum size in bytes for a log file. When reached, a new log file is created up to `log_file_backup_cnt`. Valid only if `log_file_use_rotating` is true.|
|`log_file_backup_cnt`|Maximum number of log files. Valid only if `log_file_use_rotating` is true.|
|`log_file_append`|True to append to log file, false to start from a new file each time. Valid only if `log_file_use_rotating` is false.|
## Supported Commands
List of supported commands:
- `help`: show help message
- `alive`: show if bot is active
- `paybot_set_test_mode true/false`: enable/disable test mode
- `paybot_is_test_mode`: show if test mode is enabled
- `paybot_auth_users`: show the list of authorized users that can use the bot
- `paybot_chat_info`: show the chat information (can be run only in group)
- `paybot_users_list`: show the users list (can be run only in group)
- `paybot_invite_link`: generate a new invite link (can be run only in group)
- `paybot_version`: show the bot version
- `paybot_check_username [<HOURS_LEFT>]`: show the list of chat members without a username (can be run only in group)
- `HOURS_LEFT` (optional): hours left to set the username before being removed (only for printing the message). Hours are automatically converted to days if greater than 47. If less than 1, it'll print "as soon as possible". Default value: 0.
- `paybot_remove_username`: remove all the chat members without a username (can be run only in group)
- `paybot_set_check_on_join true/false`: enable/disable payment check when a new member joins
- `paybot_is_check_on_join`: show if payment check when a new member joins is enabled
- `paybot_check_data`: check payments data for errors (e.g. invalid dates, duplicated users) and show them
- `paybot_email_payment [<DAYS_LEFT>]`: send a reminder email to chat members whose payment is expiring in the specified number of days
- `DAYS_LEFT` (optional): number of days within which the payment expires. Less than 1 means expiring today. Default value: 0.
- `paybot_check_payment [<DAYS_LEFT>] [<LAST_DAY>]`: show the list of chat members whose payment is expiring in the specified number of days (can be run only in group)
- `DAYS_LEFT` (optional): number of days within which the payment expires. Less than 1 means expiring today. Default value: 0.
- `LAST_DAY` (optional): last day to complete the payment before being removed (only for printing the message). If less than 1 or greater than 31, it'll print "within few days". Default value: 0.
- `paybot_remove_payment`: remove the chat members whose payment has expired (can be run only in group)
- `paybot_task_start PERIOD_HOURS`: start payment check task with the specified period
- `PERIOD_HOURS`: task period in hours
- `paybot_task_stop`: stop payment check task
- `paybot_task_info`: show payment check task information
- `paybot_task_add_chat`: add the current chat to the payment check task
- `paybot_task_remove_chat`: remove the current chat from the payment check task
- `paybot_task_remove_all_chats`: remove all chats from the payment check task
Add `quiet` or `q` as last parameter to send the bot response in a private chat instead of the group chat.
Users removed from the group are just kicked and not banned, so they can re-join later via invite links if necessary.\
When users are removed from the group (either because they had no username or they didn't pay), a new invite link is generated and sent to all authorized users in a private chat.\
This automatically revokes the old invite link and prevents those users to join again using it.
When checking for payments, a user is removed from the group if:
- He has no Telegram username
- His Telegram username or user ID is not found in the payments data
- His payment is expired
If `payment_check_dup_email` is set to true:
- If multiple rows have the same email address, only the first row will be loaded and all the others will be skipped (therefore, those users won't be considered as valid payments)
- Rows with duplicated email address will be printed by the `paybot_check_data` command
## Payment Check Task
It's suggested to run a background task to check for payments periodically. It can be started/stopped with the `paybot_task_start`/`paybot_task_stop` commands.\
The task can check multiple groups in one time (sharing the same payments data, of course). The groups can be added/removed with the `paybot_task_add_chat`/`paybot_task_remove_chat` commands (either while the task is running or stopped).\
If no group was added, the task will simply run without checking any group.
The period of the task always starts from midnight (if you use a VPS, be sure to set the correct time), for example:
- A task period of 8 hours will check for payments at 00:00, 08:00 and 16:00
- A task period of 6 hours will check for payments at 00:00, 06:00, 12:00 and 18:00
## Run the Bot
The bot shall be an administrator of the group.\
If you just need to run bot once in a while (e.g. once a week), you can do it manually using the `check_no_payment` and `remove_no_payment` commands. In this case, it's sufficient to run the bot locally on the PC when needed.\
If you prefer to let the bot check for payment periodically, it'll be better to run it 24h/24h on a VPS.
## Payment File
The payment file can be either a *xls*/*xlsx* file (*xlrd* library is used) or a Google Sheet.\
In case a Google Sheet is used and the OAuth2 flow is chosen:
1. Create a project on [Google Cloud Console](https://console.cloud.google.com)
2. Go to *APIs & Services*, then *Credentials* and select *Configure Consent Screen*
3. Create a new app and publish it, it doesn't need to be verified (but you can verify it, of course)
4. Go back to the *Credentials* page and create the credentials for OAuth client ID by selecting *Create Credentials*
5. Select *Desktop app*, choose a name and download the *json* file with the credentials
6. Go to the *Library* page, search for Google Sheet and enable Google Sheet APIs
7. Rename the *json* file to the name specified in the configuration file (`payment_google_cred`) and place it in the *app* folder
8. The first time the bot loads your Google Sheet, you'll be asked to login into your Google account and allow the bot to access the sheet. After this, a new *json* file will be automatically created in the folder you configured (`payment_google_cred_path`).
9. This *json* file allows the bot to access the sheet next times, so you don't need to allow it again
10. If you move the bot to another PC or server, just keep the *json* files to grant the bot access to the sheet without repeating the whole procedure
For more information: [create project](https://developers.google.com/workspace/guides/create-project), [create credentials](https://developers.google.com/workspace/guides/create-credentials)
Since for allowing the bot to access the Google Sheet a browser window will open, in case of a dedicated server (no GUI) it's easier to generate the *json* file on a PC and then just copy it to the server.
Alternatively, you can create a service account, which is pre-authorized. In this case, you don't need to authorize it from the browser window but you only have to share the Google Sheet with the service account gmail.
In both cases (Google Sheet or Excel file), the file shall contain the following columns starting from the second row (the first row is used as header):
- Email address used for paying (for convenience, since an email address is usually required in payment platforms)
- Telegram user ID or username
- Expiration date of the payment in the format specified by `payment_date_format`
The indexes of these columns are set in the configuration file. It is possible to add other columns beside these if necessary, they are simply ignored by the bot.
## Test Mode
Test mode can be used to test the bot without any effect to the users of the group. When active:
- Users are not kicked from the group if they don't have a username or don't have paid, in any case (i.e. when running a command, when joining the group, during periodical checks)
- Emails are not sent to the users that haven't paid yet
Moreover, the payment task period will be applied in minutes instead of hours. This allows to quickly check if it is working.
## Channel Limitations
When used in channels:
- The bot can check for payments periodically but it cannot check users immediately when they join
- All admins can use the bot, not only authorized users
- Commands in quiet mode will send the result to authorized users instead of privately to the user that executed the command
- Due to a Telegram limitation, only 200 members can be managed
## Translation
The messages sent by the bot on Telegram can be translated into different languages (the default language is English) by providing a custom XML file.\
The XML file path is specified in the configuration file (`app_lang_file` field).\
An example XML file in italian is provided in the folder *app/lang*.
# License
This software is available under the MIT license.
Raw data
{
"_id": null,
"home_page": "https://github.com/ebellocchia/telegram_payment_bot",
"name": "telegram-payment-bot",
"maintainer": "Emanuele Bellocchia",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "ebellocchia@gmail.com",
"keywords": "telegram,bot,telegram bot,payments,payments check",
"author": "Emanuele Bellocchia",
"author_email": "ebellocchia@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/61/59/67fc5e5274c29c81bbd151ada3e395d679381a6d07fd9547fc9a871b74a5/telegram_payment_bot-0.7.2.tar.gz",
"platform": "any",
"description": "# Telegram Payments Bot\r\n\r\n| |\r\n|---|\r\n| [](https://pypi.org/project/telegram_payment_bot/) [](https://pypi.org/project/telegram_payment_bot/) [](https://github.com/ebellocchia/telegram_payment_bot?tab=MIT-1-ov-file) |\r\n| [](https://github.com/ebellocchia/telegram_payment_bot/actions/workflows/build.yml) |\r\n| [](https://app.codacy.com/gh/ebellocchia/telegram_payment_bot/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade) [](https://www.codefactor.io/repository/github/ebellocchia/telegram_payment_bot) |\r\n| |\r\n\r\nTelegram bot for handling payments in groups based on *pyrogram* library.\\\r\nPayments data can be loaded either from an *xls*/*xlsx* file or from a Google Sheet (in this way, it can be shared with other admins).\\\r\nIt is also possible to extend this to load payments data from other sources (e.g. a remote database) by inheriting and implementing the `PaymentsLoaderBase` class, but I didn't need to do it so far.\\\r\nPayments data can be updated either manually by the admins or, better, automatically (e.g. by the website where the payment is made, via a webhook). It depends on the infrastructure you have.\r\n\r\n## Setup\r\n\r\n### Create Telegram app\r\n\r\nIn order to use the bot, in addition to the bot token you also need an APP ID and hash.\\\r\nTo get them, create an app using the following website: [https://my.telegram.org/apps](https://my.telegram.org/apps).\r\n\r\n### Installation\r\n\r\nThe package requires Python 3, it is not compatible with Python 2.\\\r\nTo install it:\r\n- Using *setuptools*:\r\n\r\n python setup.py install\r\n\r\n- Using *pip*:\r\n\r\n pip install telegram_payment_bot\r\n\r\nTo run the bot, edit the configuration file by specifying the API ID/hash and bot token. Then, move to the *app* folder and run the *bot.py* script:\r\n\r\n cd app\r\n python bot.py\r\n\r\nWhen run with no parameter, *conf/config.ini* will be the default configuration file (in this way it can be used for different groups).\\\r\nTo specify a different configuration file:\r\n\r\n python bot.py -c another_conf.ini\r\n python bot.py --config another_conf.ini\r\n\r\nOf course, the *app* folder can be moved elsewhere if needed.\r\n\r\n## Configuration\r\n\r\nAn example of configuration file is provided in the *app/conf* folder.\\\r\nThe list of all possible fields that can be set is shown below.\r\n\r\n|Name|Description|\r\n|---|---|\r\n|**[pyrogram]**|Configuration for pyrogram|\r\n|`session_name`|Session name of your choice|\r\n|`api_id`|API ID from [https://my.telegram.org/apps](https://my.telegram.org/apps)|\r\n|`api_hash`|API hash from [https://my.telegram.org/apps](https://my.telegram.org/apps)|\r\n|`bot_token`|Bot token from BotFather|\r\n|**[app]**|Configuration for app|\r\n|`app_is_test_mode`|True to activate test mode false otherwise|\r\n|`app_lang_file`|Language file in XML format (default: English)|\r\n|**[users]**|Configuration for users|\r\n|`authorized_users`|List of Telegram usernames that are authorized to use the bot, comma separated|\r\n|**[support]**|Configuration for support|\r\n|`support_email`|Email for getting support or send payments receipts (default: empty)|\r\n|`support_telegram`|Telegram username for getting support or send payments receipts (default: empty)|\r\n|**[payment]**|Configuration for payment|\r\n|`payment_website`|Website for payment (default: empty)|\r\n|`payment_check_on_join`|Flag to check the payment of new members as soon as they join the group (default: `true`)|\r\n|`payment_check_dup_email`|Flag to check for duplicated emails in payment data (default: `true`)|\r\n|`payment_type`|Input for payment data: `EXCEL_FILE` for using xls/xlsx file, `GOOGLE_SHEET` for using a Google Sheet|\r\n|`payment_excel_file`|Name of the Excel file used for payment data, loaded only if `payment_type` is `EXCEL_FILE`|\r\n|`payment_google_sheet_id`|ID of the Google Sheet used for payment data, loaded only if `payment_type` is `GOOGLE_SHEET`|\r\n|`payment_google_cred_type`|Credentials type: `OAUTH2` for OAuth2 flow or `SERVICE_ACCOUNT` for service account (default: `OAUTH2`), loaded only if `payment_type` is `GOOGLE_SHEET`|\r\n|`payment_google_cred`|Name of the *json* credentials file for OAuth2 or service account (default: `credentials.json`), loaded only if `payment_type` is `GOOGLE_SHEET`|\r\n|`payment_google_cred_path`|Path where Google OAuth2 token file will be saved, loaded only if `payment_type` is `GOOGLE_SHEET` and `payment_google_cred_type` is `OAUTH2`|\r\n|`payment_use_user_id`|If true, `payment_user_col` will be considered as a user ID (number), otherwise it'll be considered as a username|\r\n|`payment_worksheet_idx`|Worksheet index (default: `0`)|\r\n|`payment_email_col`|Table column (letter) containing the email used for paying (default: `A`, maximum: `Z`)|\r\n|`payment_user_col`|Table column (letter) containing the user (default: `B`, maximum: `Z`). The user can be a username or a user ID (depending on the `payment_use_user_id` flag).|\r\n|`payment_expiration_col`|Table column (letter) containing the payment expiration date (default: `C`, maximum: `Z`)|\r\n|`payment_date_format`|Date format in payments data (default: `%d/%m/%Y`)|\r\n|**[email]**|Configuration for email that reminds users to pay|\r\n|`email_enabled`|Email enable flag (default: `false`). If false, all the next fields will be skipped.|\r\n|`email_from`|Email sender|\r\n|`email_reply_to`|Email reply-to|\r\n|`email_host`|Host for sending email|\r\n|`email_user`|Username for logging to host|\r\n|`email_password`|Password for logging to host|\r\n|`email_subject`|Email subject|\r\n|`email_alt_body`|File containing email alternate body (text)|\r\n|`email_html_body`|File containing email HTML body|\r\n|**[logging]**|Configuration for logging|\r\n|`log_level`|Log level, same of python logging (`DEBUG`, `INFO`, `WARNING`, `ERROR`, `CRITICAL`). Default: `INFO`.|\r\n|`log_console_enabled`|True to enable logging to console, false otherwise (default: true)|\r\n|`log_file_enabled`|True to enable logging to file, false otherwise (default: false). If false, all the next fields will be skipped.|\r\n|`log_file_name`|Log file name|\r\n|`log_file_use_rotating`|True for using a rotating log file, false otherwise|\r\n|`log_file_max_bytes`|Maximum size in bytes for a log file. When reached, a new log file is created up to `log_file_backup_cnt`. Valid only if `log_file_use_rotating` is true.|\r\n|`log_file_backup_cnt`|Maximum number of log files. Valid only if `log_file_use_rotating` is true.|\r\n|`log_file_append`|True to append to log file, false to start from a new file each time. Valid only if `log_file_use_rotating` is false.|\r\n\r\n## Supported Commands\r\n\r\nList of supported commands:\r\n- `help`: show help message\r\n- `alive`: show if bot is active\r\n- `paybot_set_test_mode true/false`: enable/disable test mode\r\n- `paybot_is_test_mode`: show if test mode is enabled\r\n- `paybot_auth_users`: show the list of authorized users that can use the bot\r\n- `paybot_chat_info`: show the chat information (can be run only in group)\r\n- `paybot_users_list`: show the users list (can be run only in group)\r\n- `paybot_invite_link`: generate a new invite link (can be run only in group)\r\n- `paybot_version`: show the bot version\r\n- `paybot_check_username [<HOURS_LEFT>]`: show the list of chat members without a username (can be run only in group)\r\n - `HOURS_LEFT` (optional): hours left to set the username before being removed (only for printing the message). Hours are automatically converted to days if greater than 47. If less than 1, it'll print \"as soon as possible\". Default value: 0.\r\n- `paybot_remove_username`: remove all the chat members without a username (can be run only in group)\r\n- `paybot_set_check_on_join true/false`: enable/disable payment check when a new member joins\r\n- `paybot_is_check_on_join`: show if payment check when a new member joins is enabled\r\n- `paybot_check_data`: check payments data for errors (e.g. invalid dates, duplicated users) and show them\r\n- `paybot_email_payment [<DAYS_LEFT>]`: send a reminder email to chat members whose payment is expiring in the specified number of days\r\n - `DAYS_LEFT` (optional): number of days within which the payment expires. Less than 1 means expiring today. Default value: 0.\r\n- `paybot_check_payment [<DAYS_LEFT>] [<LAST_DAY>]`: show the list of chat members whose payment is expiring in the specified number of days (can be run only in group)\r\n - `DAYS_LEFT` (optional): number of days within which the payment expires. Less than 1 means expiring today. Default value: 0.\r\n - `LAST_DAY` (optional): last day to complete the payment before being removed (only for printing the message). If less than 1 or greater than 31, it'll print \"within few days\". Default value: 0.\r\n- `paybot_remove_payment`: remove the chat members whose payment has expired (can be run only in group)\r\n- `paybot_task_start PERIOD_HOURS`: start payment check task with the specified period\r\n - `PERIOD_HOURS`: task period in hours\r\n- `paybot_task_stop`: stop payment check task\r\n- `paybot_task_info`: show payment check task information\r\n- `paybot_task_add_chat`: add the current chat to the payment check task\r\n- `paybot_task_remove_chat`: remove the current chat from the payment check task\r\n- `paybot_task_remove_all_chats`: remove all chats from the payment check task\r\n\r\nAdd `quiet` or `q` as last parameter to send the bot response in a private chat instead of the group chat.\r\n\r\nUsers removed from the group are just kicked and not banned, so they can re-join later via invite links if necessary.\\\r\nWhen users are removed from the group (either because they had no username or they didn't pay), a new invite link is generated and sent to all authorized users in a private chat.\\\r\nThis automatically revokes the old invite link and prevents those users to join again using it.\r\n\r\nWhen checking for payments, a user is removed from the group if:\r\n- He has no Telegram username\r\n- His Telegram username or user ID is not found in the payments data\r\n- His payment is expired\r\n\r\nIf `payment_check_dup_email` is set to true:\r\n- If multiple rows have the same email address, only the first row will be loaded and all the others will be skipped (therefore, those users won't be considered as valid payments)\r\n- Rows with duplicated email address will be printed by the `paybot_check_data` command\r\n\r\n## Payment Check Task\r\n\r\nIt's suggested to run a background task to check for payments periodically. It can be started/stopped with the `paybot_task_start`/`paybot_task_stop` commands.\\\r\nThe task can check multiple groups in one time (sharing the same payments data, of course). The groups can be added/removed with the `paybot_task_add_chat`/`paybot_task_remove_chat` commands (either while the task is running or stopped).\\\r\nIf no group was added, the task will simply run without checking any group.\r\n\r\nThe period of the task always starts from midnight (if you use a VPS, be sure to set the correct time), for example:\r\n- A task period of 8 hours will check for payments at 00:00, 08:00 and 16:00\r\n- A task period of 6 hours will check for payments at 00:00, 06:00, 12:00 and 18:00\r\n\r\n## Run the Bot\r\n\r\nThe bot shall be an administrator of the group.\\\r\nIf you just need to run bot once in a while (e.g. once a week), you can do it manually using the `check_no_payment` and `remove_no_payment` commands. In this case, it's sufficient to run the bot locally on the PC when needed.\\\r\nIf you prefer to let the bot check for payment periodically, it'll be better to run it 24h/24h on a VPS.\r\n\r\n## Payment File\r\n\r\nThe payment file can be either a *xls*/*xlsx* file (*xlrd* library is used) or a Google Sheet.\\\r\nIn case a Google Sheet is used and the OAuth2 flow is chosen:\r\n1. Create a project on [Google Cloud Console](https://console.cloud.google.com)\r\n2. Go to *APIs & Services*, then *Credentials* and select *Configure Consent Screen*\r\n3. Create a new app and publish it, it doesn't need to be verified (but you can verify it, of course)\r\n4. Go back to the *Credentials* page and create the credentials for OAuth client ID by selecting *Create Credentials*\r\n5. Select *Desktop app*, choose a name and download the *json* file with the credentials\r\n6. Go to the *Library* page, search for Google Sheet and enable Google Sheet APIs\r\n7. Rename the *json* file to the name specified in the configuration file (`payment_google_cred`) and place it in the *app* folder\r\n8. The first time the bot loads your Google Sheet, you'll be asked to login into your Google account and allow the bot to access the sheet. After this, a new *json* file will be automatically created in the folder you configured (`payment_google_cred_path`).\r\n9. This *json* file allows the bot to access the sheet next times, so you don't need to allow it again\r\n10. If you move the bot to another PC or server, just keep the *json* files to grant the bot access to the sheet without repeating the whole procedure\r\n\r\nFor more information: [create project](https://developers.google.com/workspace/guides/create-project), [create credentials](https://developers.google.com/workspace/guides/create-credentials)\r\n\r\nSince for allowing the bot to access the Google Sheet a browser window will open, in case of a dedicated server (no GUI) it's easier to generate the *json* file on a PC and then just copy it to the server.\r\n\r\nAlternatively, you can create a service account, which is pre-authorized. In this case, you don't need to authorize it from the browser window but you only have to share the Google Sheet with the service account gmail.\r\n\r\nIn both cases (Google Sheet or Excel file), the file shall contain the following columns starting from the second row (the first row is used as header):\r\n- Email address used for paying (for convenience, since an email address is usually required in payment platforms)\r\n- Telegram user ID or username\r\n- Expiration date of the payment in the format specified by `payment_date_format`\r\n\r\nThe indexes of these columns are set in the configuration file. It is possible to add other columns beside these if necessary, they are simply ignored by the bot.\r\n\r\n## Test Mode\r\n\r\nTest mode can be used to test the bot without any effect to the users of the group. When active:\r\n- Users are not kicked from the group if they don't have a username or don't have paid, in any case (i.e. when running a command, when joining the group, during periodical checks)\r\n- Emails are not sent to the users that haven't paid yet\r\n\r\nMoreover, the payment task period will be applied in minutes instead of hours. This allows to quickly check if it is working.\r\n\r\n## Channel Limitations\r\n\r\nWhen used in channels:\r\n- The bot can check for payments periodically but it cannot check users immediately when they join\r\n- All admins can use the bot, not only authorized users\r\n- Commands in quiet mode will send the result to authorized users instead of privately to the user that executed the command\r\n- Due to a Telegram limitation, only 200 members can be managed\r\n\r\n## Translation\r\n\r\nThe messages sent by the bot on Telegram can be translated into different languages (the default language is English) by providing a custom XML file.\\\r\nThe XML file path is specified in the configuration file (`app_lang_file` field).\\\r\nAn example XML file in italian is provided in the folder *app/lang*.\r\n\r\n# License\r\n\r\nThis software is available under the MIT license.\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Telegram bot for managing payments",
"version": "0.7.2",
"project_urls": {
"Download": "https://github.com/ebellocchia/telegram_payment_bot/archive/v0.7.2.tar.gz",
"Homepage": "https://github.com/ebellocchia/telegram_payment_bot"
},
"split_keywords": [
"telegram",
"bot",
"telegram bot",
"payments",
"payments check"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "bfe8985b81cb6bedb919f07c3da3cbfd386b76d64b90f471217c9560c2fea34f",
"md5": "f24eeef208858e412ffe8753095b53e6",
"sha256": "1e97a4eef074a7262f3efeb053200e1f411d573d43424739b0404ff66b9b0db7"
},
"downloads": -1,
"filename": "telegram_payment_bot-0.7.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f24eeef208858e412ffe8753095b53e6",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 95654,
"upload_time": "2024-02-09T18:35:16",
"upload_time_iso_8601": "2024-02-09T18:35:16.885794Z",
"url": "https://files.pythonhosted.org/packages/bf/e8/985b81cb6bedb919f07c3da3cbfd386b76d64b90f471217c9560c2fea34f/telegram_payment_bot-0.7.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "615967fc5e5274c29c81bbd151ada3e395d679381a6d07fd9547fc9a871b74a5",
"md5": "b0b4b7b13658761a5efd2af8f2d27e5b",
"sha256": "034a3af7ee551cab49c068be2ab49816eefdabafcf638c152e534a338ffefbb3"
},
"downloads": -1,
"filename": "telegram_payment_bot-0.7.2.tar.gz",
"has_sig": false,
"md5_digest": "b0b4b7b13658761a5efd2af8f2d27e5b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 50777,
"upload_time": "2024-02-09T18:35:18",
"upload_time_iso_8601": "2024-02-09T18:35:18.823153Z",
"url": "https://files.pythonhosted.org/packages/61/59/67fc5e5274c29c81bbd151ada3e395d679381a6d07fd9547fc9a871b74a5/telegram_payment_bot-0.7.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-09 18:35:18",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ebellocchia",
"github_project": "telegram_payment_bot",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"tox": true,
"lcname": "telegram-payment-bot"
}
JSON
