Ubilling Wiki

Користувальницькькі налаштування

Налаштування сайту

Відвідано:
claptrap

Розбіжності

Тут показані розбіжності між вибраною ревізією та поточною версією сторінки.

Посилання на цей список змін

Порівняння попередніх версій Попередня ревізія
Наступна ревізія 		Попередня ревізія
claptrap [2025/10/29 12:43]
nightfly [Налаштування] 		claptrap [2025/11/18 23:49] (поточний)
nightfly
Рядок 1: Рядок 1:
 ====== ClaptrapBot - Користувацький Telegram бот ====== ====== ClaptrapBot - Користувацький Telegram бот ======
  
 +{{:claptrap.png |}}
  
 +ClapTrapBot - це інтерактивний телеграм-бот, який надає абонентам швидкий доступ до основних можливостей [[userstats|кабінету користувача]] без необхідності відкривати його в браузері.
 +Через бот користувач може переглядати свій профіль, баланс, історію платежів, робити онлайн-оплати, користуватись кредитом, отримувати сповіщення та звертатися до служби підтримки.
  
-===== Under heavy development =====+Бот особливо зручний для тих, хто користується смартфоном: 
 +усі дії виконуються просто у чаті - без паролів, авторизацій і зайвих переходів.
  
-{{:claptrap.png |}} 
  
-===== Реєстрація вашого бота ===== +====== Реєстрація вашого бота ======
  
 У випадку, якщо в вас ще немає бота який ви будете використовувати в ролі користувацького бота, для взаємодії з користувачами, можете скористатись [[tgbotfather|наступним посібником]] і створити собі якогось новенького для цього.  У випадку, якщо в вас ще немає бота який ви будете використовувати в ролі користувацького бота, для взаємодії з користувачами, можете скористатись [[tgbotfather|наступним посібником]] і створити собі якогось новенького для цього. 
Рядок 13: Рядок 16:
 **Важливо:** не використовуйте, як кабінетного користувацького бота, токен вже існуючого, і прописаного в вас в [[senddog|Собаці-посилаці]], що вже використовується для розсилок вашому персоналу! Використовуйте інший токен іншого бота для цього. Це інша сутність! **Важливо:** не використовуйте, як кабінетного користувацького бота, токен вже існуючого, і прописаного в вас в [[senddog|Собаці-посилаці]], що вже використовується для розсилок вашому персоналу! Використовуйте інший токен іншого бота для цього. Це інша сутність!
  
-===== Веб хук ===== +====== Веб хук ======
  
 Для роботи ClaptrapBot, в силу своєї інтерактивності, використовує веб хуки. Їх реалізовано для нього в модулі claptrapbot. Тобто базовим посиланням є не що інше ніж Для роботи ClaptrapBot, в силу своєї інтерактивності, використовує веб хуки. Їх реалізовано для нього в модулі claptrapbot. Тобто базовим посиланням є не що інше ніж
Рядок 36: Рядок 39:
 **Важливо:** очевидно, що від вас очікується той факт, що ви зміните значення опції CLAPTRAPBOT_AUTH_STRING на якийсь свій рандомний рядок тексту. Не використовуйте для цього токен боту. Просто якийсь інший рандом. Якщо складно придумати - впадіть обличчям на клавіатуру. Так, ви можете залишити опцію порожньою, і використовувати хук взагалі без авторизації, але "щоби що?". **Важливо:** очевидно, що від вас очікується той факт, що ви зміните значення опції CLAPTRAPBOT_AUTH_STRING на якийсь свій рандомний рядок тексту. Не використовуйте для цього токен боту. Просто якийсь інший рандом. Якщо складно придумати - впадіть обличчям на клавіатуру. Так, ви можете залишити опцію порожньою, і використовувати хук взагалі без авторизації, але "щоби що?".
  
-===== Доступ до веб хуку ===== +====== Доступ до веб хуку ======
  
 Варто також помітити, що Telegram [[https://core.telegram.org/bots/api#setwebhook|дозволяє]] використовувати як веб-хуки, **тільки https** посилання. І так, тільки на портах 443, 80, 88, 8443. Також очевидно, що якщо ви не знехтували нашими [[security|рекомендаціями що до безпеки]] доступ до адміністративного інтерфейсу білінгу, у вас повинен би бути обмеженим ззовні. Щоб не гратись і не дозволяти доступ поштучно, для Telegram до цілої адмінки, ви можете, прокинути посилання на ваш вебхук в якусь іншу URL засобами вашого веб сервера, ну скажімо [[https://lapaste.in.ua/?v=0kot1hrg|якось так]], або ж скористатись мінімалістичним web-proxy, наприклад [[https://github.com/nightflyza/tgtinygate|tgtinygate aka TGTG]], спеціально зробленим під ці задачі. Також ніхто вас не зобов'язує тримати його прямо на білінговому сервері. Наприклад, ваш Ubilling знаходиться на хості з сірою IP адресою, десь за NAT-ом, або до нього дропаються всі звернення окрім як від вашої внутрішньої інфраструктури. В цьому випадку, ви можете, розмітити TGTG на будь-якому хості, з працюючим https, доступному ззовні: Варто також помітити, що Telegram [[https://core.telegram.org/bots/api#setwebhook|дозволяє]] використовувати як веб-хуки, **тільки https** посилання. І так, тільки на портах 443, 80, 88, 8443. Також очевидно, що якщо ви не знехтували нашими [[security|рекомендаціями що до безпеки]] доступ до адміністративного інтерфейсу білінгу, у вас повинен би бути обмеженим ззовні. Щоб не гратись і не дозволяти доступ поштучно, для Telegram до цілої адмінки, ви можете, прокинути посилання на ваш вебхук в якусь іншу URL засобами вашого веб сервера, ну скажімо [[https://lapaste.in.ua/?v=0kot1hrg|якось так]], або ж скористатись мінімалістичним web-proxy, наприклад [[https://github.com/nightflyza/tgtinygate|tgtinygate aka TGTG]], спеціально зробленим під ці задачі. Також ніхто вас не зобов'язує тримати його прямо на білінговому сервері. Наприклад, ваш Ubilling знаходиться на хості з сірою IP адресою, десь за NAT-ом, або до нього дропаються всі звернення окрім як від вашої внутрішньої інфраструктури. В цьому випадку, ви можете, розмітити TGTG на будь-якому хості, з працюючим https, доступному ззовні:
Рядок 64: Рядок 67:
 </code> </code>
  
-===== Налаштування ===== +====== Файли конфігурації ====== 
 + 
 +Сподіваємось, що наступний набір опцій є доволі самоочевидним і не потребує порядкового розбору. 
  
 <file ini alter.ini> <file ini alter.ini>
Рядок 73: Рядок 78:
 CLAPTRAPBOT_TOKEN="1234567890:EXAMPLEfakeToken1234567890ABCDXXXXX" CLAPTRAPBOT_TOKEN="1234567890:EXAMPLEfakeToken1234567890ABCDXXXXX"
  
-; Режим відлагодження+; Режим відлагодження. Воно вам треба? Воно вам не треба.
 CLAPTRAPBOT_DEBUG=0 CLAPTRAPBOT_DEBUG=0
  
-; Рядок автентифікації - використовується для перевірки на автентичність, запитів вебхука+; Рядок автентифікації - використовується для перевірки на автентичність, запитів до вебхука. Змініть на нормальний.
 CLAPTRAPBOT_AUTH_STRING="changeme" CLAPTRAPBOT_AUTH_STRING="changeme"
  
-; URL вебхука - адреса, яка встановлюється для прийому та обробки запитів від бота+; URL вебхука - адреса, яка встановлюється для прийому та обробки запитів від бота.
 CLAPTRAPBOT_HOOK_URL="https://yourpublichost.com/tgtinygate_changeme/" CLAPTRAPBOT_HOOK_URL="https://yourpublichost.com/tgtinygate_changeme/"
  
-; URL кабінету користувача - використовується для отримання даних користувача, авторизація і всякого такого.+; URL кабінету користувача - використовується для отримання даних користувача, авторизації та всякого такого.
 CLAPTRAPBOT_USERSTATS_URL="https://my.ourisp.com/" CLAPTRAPBOT_USERSTATS_URL="https://my.ourisp.com/"
  
Рядок 88: Рядок 93:
 CLAPTRAPBOT_PKBD_ROW=2 CLAPTRAPBOT_PKBD_ROW=2
  
-; Перелік ID увімкнених функцій ClapTrapBot+; Перелік ID увімкнених функцій ClapTrapBot. Функції буде розташовано на основній клавіатурі в тому ж порядку.
 CLAPTRAPBOT_FEATURES="profile,announcements,credit,opayz,mypayments,support" CLAPTRAPBOT_FEATURES="profile,announcements,credit,opayz,mypayments,support"
  
Рядок 97: Рядок 102:
 CLAPTRAPBOT_THROTTLE_BAN_TIME=120 CLAPTRAPBOT_THROTTLE_BAN_TIME=120
  
-; Кількість платежів, що відображаються у списку "Мої платежі" за замовчуванням+; Кількість платежів, що відображаються в списку "Мої платежі" за замовчуванням.
 CLAPTRAPBOT_MY_PAYMENTS_LIMIT=3 CLAPTRAPBOT_MY_PAYMENTS_LIMIT=3
  
-; ID існуючого тега, для авторизованих користувачів ClapTrapBot. Вкажіть 0, щоб вимкнути.+; ID існуючого тега, для авторизованих користувачів ClapTrapBot. При авторизації тег буде встановлено. При відлогінюванні - знято. Вкажіть 0, щоб вимкнути.
 CLAPTRAPBOT_USERS_TAGID=0 CLAPTRAPBOT_USERS_TAGID=0
 </file> </file>
 +
 +З боку ж кабінету, в свою чергу потрібен [[xmlagent|XMLAgent REST API]] щонайменше версії 2 (тобто кабінет актуальної версії Ubilling >= 1.5.8)
 +
 +<file ini userstats.ini>
 + UBA_ENABLED=1
 +</file>
 +
 +
 +а також ви можете використати наступні опції
 +
 +<file ini userstats.ini>
 +TG_BOTNAME="ubillingdemobot"
 +TG_BOT_QR=1
 +</file>
 +
 +щоб зробити, ось таку гарненьку автоматизовану авторизацію з кабінету користувача
 +
 +{{:userstatstgbotauth.png|}}
 +
  
 ====== Наявні функції боту  ====== ====== Наявні функції боту  ======
Рядок 118: Рядок 142:
  
 Кожну з них, ви можете вмикати/вимикати/розташовувати як вам подобається, за допомогою опції **CLAPTRAPBOT_FEATURES**. На основній клавіатурі їх зображено власне в порядку, розташування ID функцій в значенні опції. Кожну з них, ви можете вмикати/вимикати/розташовувати як вам подобається, за допомогою опції **CLAPTRAPBOT_FEATURES**. На основній клавіатурі їх зображено власне в порядку, розташування ID функцій в значенні опції.
 +
 +====== Встановлення хуку  ======
 +
 +Після завершення базових налаштувань по конфігах, вам необхідно одноразово встановити хук вашого бота. Робиться це зручно та просто, за допомогою ось цього модуля
 +
 +{{:cltpmgr0.png|}}
 +
 +та виглядає приблизно наступним чином
 +
 +{{:claptraphookinstall.png|}}
 +
 +
 +====== А далі що? ======
 +
 +Та нічо.
 +
 +
 +{{:claptrapbot_scr1.png|}}
 +
 +{{:claptrapbot_scr2.png|}}
 +
 +{{:claptrapbot_scr3.png|}}
 +
 +{{:claptrapbot_scr4.png|}}
 +
claptrap.1761734622.txt.gz · Востаннє змінено: 2025/10/29 12:43 повз nightfly

Налаштування сторінки

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki