Розбіжності

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

--- claptrap [2025/10/29 14:12]
nightfly [Under heavy development]
+++ claptrap [2025/11/18 23:49] (поточний)
nightfly
@@ Рядок 1: / Рядок 1: @@
 ====== ClaptrapBot - Користувацький Telegram бот ======
-===== Under heavy development =====
 {{:claptrap.png |}}
 ClapTrapBot - це інтерактивний телеграм-бот, який надає абонентам швидкий доступ до основних можливостей [[userstats|кабінету користувача]] без необхідності відкривати його в браузері.
-Через бот користувач може переглядати свій профіль, баланс, історію платежів, робити онлайн-оплати, користуватись кредитом, читати оголошення та звертатися до служби підтримки.
+Через бот користувач може переглядати свій профіль, баланс, історію платежів, робити онлайн-оплати, користуватись кредитом, отримувати сповіщення та звертатися до служби підтримки.
 Бот особливо зручний для тих, хто користується смартфоном:
 усі дії виконуються просто у чаті - без паролів, авторизацій і зайвих переходів.
-===== Реєстрація вашого бота =====
+====== Реєстрація вашого бота ======
 У випадку, якщо в вас ще немає бота який ви будете використовувати в ролі користувацького бота, для взаємодії з користувачами, можете скористатись [[tgbotfather|наступним посібником]] і створити собі якогось новенького для цього.
@@ Рядок 18: / Рядок 16: @@
 **Важливо:** не використовуйте, як кабінетного користувацького бота, токен вже існуючого, і прописаного в вас в [[senddog|Собаці-посилаці]], що вже використовується для розсилок вашому персоналу! Використовуйте інший токен іншого бота для цього. Це інша сутність!
-===== Веб хук =====
+====== Веб хук ======
 Для роботи ClaptrapBot, в силу своєї інтерактивності, використовує веб хуки. Їх реалізовано для нього в модулі claptrapbot. Тобто базовим посиланням є не що інше ніж
@@ Рядок 41: / Рядок 39: @@
 **Важливо:** очевидно, що від вас очікується той факт, що ви зміните значення опції 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, доступному ззовні:
@@ Рядок 69: / Рядок 67: @@
 </code>
-===== Налаштування =====
+====== Файли конфігурації ======
 Сподіваємось, що наступний набір опцій є доволі самоочевидним і не потребує порядкового розбору.
@@ Рядок 80: / Рядок 78: @@
 CLAPTRAPBOT_TOKEN="1234567890:EXAMPLEfakeToken1234567890ABCDXXXXX"
-; Режим відлагодження
+; Режим відлагодження. Воно вам треба? Воно вам не треба.
 CLAPTRAPBOT_DEBUG=0
-; Рядок автентифікації - використовується для перевірки на автентичність, запитів вебхука
+; Рядок автентифікації - використовується для перевірки на автентичність, запитів до вебхука. Змініть на нормальний.
 CLAPTRAPBOT_AUTH_STRING="changeme"
-; URL вебхука - адреса, яка встановлюється для прийому та обробки запитів від бота
+; URL вебхука - адреса, яка встановлюється для прийому та обробки запитів від бота.
 CLAPTRAPBOT_HOOK_URL="https://yourpublichost.com/tgtinygate_changeme/"
-; URL кабінету користувача - використовується для отримання даних користувача, авторизація і всякого такого.
+; URL кабінету користувача - використовується для отримання даних користувача, авторизації та всякого такого.
 CLAPTRAPBOT_USERSTATS_URL="https://my.ourisp.com/"
@@ Рядок 95: / Рядок 93: @@
 CLAPTRAPBOT_PKBD_ROW=2
-; Перелік ID увімкнених функцій ClapTrapBot
+; Перелік ID увімкнених функцій ClapTrapBot. Функції буде розташовано на основній клавіатурі в тому ж порядку.
 CLAPTRAPBOT_FEATURES="profile,announcements,credit,opayz,mypayments,support"
@@ Рядок 104: / Рядок 102: @@
 CLAPTRAPBOT_THROTTLE_BAN_TIME=120
-; Кількість платежів, що відображаються у списку "Мої платежі" за замовчуванням
+; Кількість платежів, що відображаються в списку "Мої платежі" за замовчуванням.
 CLAPTRAPBOT_MY_PAYMENTS_LIMIT=3
-; ID існуючого тега, для авторизованих користувачів ClapTrapBot. Вкажіть 0, щоб вимкнути.
+; ID існуючого тега, для авторизованих користувачів ClapTrapBot. При авторизації тег буде встановлено. При відлогінюванні - знято. Вкажіть 0, щоб вимкнути.
 CLAPTRAPBOT_USERS_TAGID=0
 </file>
@@ Рядок 125: / Рядок 123: @@
 </file>
-щоб зробити, ось таку гарненьку автомазовану авторизацію з кабінету користувача
+щоб зробити, ось таку гарненьку автоматизовану авторизацію з кабінету користувача
 {{:userstatstgbotauth.png|}}
@@ Рядок 144: / Рядок 142: @@
 Кожну з них, ви можете вмикати/вимикати/розташовувати як вам подобається, за допомогою опції **CLAPTRAPBOT_FEATURES**. На основній клавіатурі їх зображено власне в порядку, розташування ID функцій в значенні опції.
+====== Встановлення хуку  ======
+Після завершення базових налаштувань по конфігах, вам необхідно одноразово встановити хук вашого бота. Робиться це зручно та просто, за допомогою ось цього модуля
+{{:cltpmgr0.png|}}
+та виглядає приблизно наступним чином
+{{:claptraphookinstall.png|}}
+====== А далі що? ======
+Та нічо.
+{{:claptrapbot_scr1.png|}}
+{{:claptrapbot_scr2.png|}}
+{{:claptrapbot_scr3.png|}}
+{{:claptrapbot_scr4.png|}}

Ubilling Wiki

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

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

Розбіжності

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