====== Claptrap - Користувацький Telegram бот ======


===== Under heavy development =====

{{:ctb_proto0.png|}}


===== Налаштування ===== 
<file ini alter.ini>
;Is ClapTrapBot enabled?
CLAPTRAPBOT_ENABLED=0
;ClapTrapBot token
CLAPTRAPBOT_TOKEN=""
;ClapTrapBot debug flag
CLAPTRAPBOT_DEBUG=0
;ClapTrapBot auth string - used to authenticate hook requests to ClapTrapBot
CLAPTRAPBOT_AUTH_STRING="changeme"
;ClapTrapBot hook URL - used to set as web hook for requests to ClapTrapBot
CLAPTRAPBOT_HOOK_URL="https://yourhost.com/tgtinygate/"
;ClapTrapBot userstats URL - used to get userdata from ClapTrapBot
CLAPTRAPBOT_USERSTATS_URL="https://my.ourisp.com/"
;ClapTrapBot primary keyboard buttons count in row
CLAPTRAPBOT_PKBD_ROW=2
;ClapTrapBot enabled features
CLAPTRAPBOT_FEATURES="profile,announcements,credit,opayz,mypayments,support"
;ClapTrapBot limit of actions per minute (APM). Set to 0 to disable.
CLAPTRAPBOT_THROTTLE_LIMIT=30
;ClapTrapBot throttle ban time in seconds. Set to 0 to disable.
CLAPTRAPBOT_THROTTLE_BAN_TIME=60
;ClapTrapBot limit of payments to show in mypayments list by default
CLAPTRAPBOT_MY_PAYMENTS_LIMIT=3
</file>

====== Наявні функції боту  ======

^ ID функції ^   ^ Опис ^
| profile | 👨‍💼 | Відображає інформацію профілю користувача (ПІБ, адреса, мобільний, тариф, баланс, IP, кредит, стан облікового запису, платіжний ID) |
| credit | ⏱️ | Дозволяє користувачам запитати або перевірити можливість кредиту з підтвердженням умов |
| announcements | 📢 | Відображає активні оголошення зі статусом прочитано/непрочитано та можливістю позначити всі як прочитані |
| opayz | 💳 | Список доступних методів онлайн-оплати з прямими посиланнями |
| mypayments | 💸 | Показує історію платежів користувача з пагінацією (останні, більше, всі) |
| support | 📞 | Функція підтримки (наразі в розробці) |
| catv | 📺 | Відображає профіль користувача CaTV (адреса, договір, телефон, тариф, баланс) |
| sign_in | 🔑 | Функція аутентифікації (завжди доступна) |
| sign_out | 🔒 | Функція виходу (завжди доступна) |