مستندات تنظیم وب‌هوک بات روبیکا

📖 فهرست مطالب

· معرفی · پیش‌نیازها · نصب و راه‌اندازی · استفاده · اجرا در Termux · عیب‌یابی · مثال‌های کاربردی

#🚀 معرفی

این اسکریپت برای تنظیم endpointهای بات روبیکا روی یک وب‌هوک مشخص طراحی شده است. با استفاده از این کد می‌توانید به سادگی تمام endpointهای لازم را روی سرور خود تنظیم کنید.

این پروژه چندین نسخه برای وب‌هوک کردن دارد:

· نسخه پایتون (webhook.py) · نسخه C++ (webhook.cpp) · نسخه Node.js (webhook.js) · نسخه shell (webhook.sh)

📋 پیش‌نیازها

برای نسخه پایتون:

pip install requests

برای نسخه C++:

sudo apt install curl g++

برای نسخه Node.js:

npm install axios

برای Termux:

pkg install curl python git nodejs

💻 نصب و راه‌اندازی

نسخه پایتون:

git clone https://github.com/Daniyel-Vanguard/Rubika_Webhook.git
cd Rubika_Webhook
python webhook.py

نسخه C++:

git clone https://github.com/Daniyel-Vanguard/Rubika_Webhook.git
cd Rubika_Webhook
g++ -o webhook webhook.cpp -std=c++11
./webhook

نسخه Node.js:

git clone https://github.com/Daniyel-Vanguard/Rubika_Webhook.git
cd Rubika_Webhook
npm install
node webhook.js

🛠 استفاده

پیکربندی

قبل از اجرا، توکن بات و آدرس وب‌هوک را در کد تنظیم کنید:

# برای پایتون
token = "YOUR_BOT_TOKEN_HERE"
webhook_url = "https://yourdomain.com/bot.php"

// برای C++
const std::string token = "YOUR_BOT_TOKEN_HERE";
const std::string webhook_url = "https://yourdomain.com/bot.php";

// برای Node.js
const TOKEN = "YOUR_BOT_TOKEN_HERE";
const WEBHOOK_URL = "https://yourdomain.com/bot.php";

endpointهای پشتیبانی شده

· ReceiveUpdate - دریافت آپدیت‌ها · ReceiveInlineMessage - دریافت پیام‌های اینلاین · ReceiveQuery - دریافت کوئری‌ها · GetSelectionItem - دریافت آیتم‌های انتخابی · SearchSelectionItems - جستجوی آیتم‌های انتخابی

📱 اجرا در Termux

نصب پیش‌نیازها در Termux:

pkg update
pkg upgrade
pkg install python git curl nodejs
pip install requests

اجرای نسخه پایتون در Termux:

git clone https://github.com/Daniyel-Vanguard/Rubika_Webhook.git
cd Rubika_Webhook
python webhook.py

اجرای نسخه C++ در Termux:

pkg install clang
git clone https://github.com/Daniyel-Vanguard/Rubika_Webhook.git
cd Rubika_Webhook
g++ -o webhook webhook.cpp -std=c++11
./webhook

اجرای نسخه Node.js در Termux:

git clone https://github.com/Daniyel-Vanguard/Rubika_Webhook.git
cd Rubika_Webhook
npm install
node webhook.js

🔧 عیب‌یابی

خطاهای رایج:

1. Connection Error - مشکل اتصال به سرور · بررسی اتصال اینترنت · بررسی صحت آدرس وب‌هوک
2. Invalid Token - توکن نامعتبر · بررسی صحت توکن بات · اطمینان از فعال بودن بات
3. Timeout - timeout شدن درخواست · افزایش timeout در کد · بررسی سرعت اینترنت

لاگ‌گیری:

کد به طور خودکار نتیجه هر endpoint را نمایش می‌دهد.

📝 مثال‌های کاربردی

نمونه خروجی موفق:

🚀 شروع تنظیم endpoint‌های بات Rubika

🌐 آدرس وبhook: https://yourdomain.com/bot.php

📡 ReceiveUpdate:
   ✅ موفق - وضعیت: OK
📡 ReceiveInlineMessage:
   ✅ موفق - وضعیت: OK
📡 ReceiveQuery:
   ✅ موفق - وضعیت: OK
📡 GetSelectionItem:
   ✅ موفق - وضعیت: OK
📡 SearchSelectionItems:
   ✅ موفق - وضعیت: OK

🎯 عملیات تکمیل شد!

اجرای خودکار:

می‌توانید اسکریپت را در crontab برای بررسی دوره‌ای تنظیم کنید.

🤝 مشارکت

1. Fork کنید
2. Branch ایجاد کنید (git checkout -b feature/AmazingFeature)
3. Commit کنید (git commit -m 'Add AmazingFeature')
4. Push کنید (git push origin feature/AmazingFeature)
5. Pull Request ایجاد کنید

📜 لایسنس

این پروژه تحت لایسنس MIT منتشر شده است.

📞 پشتیبانی

اگر مشکل یا سؤالی دارید:

· Issue در GitHub ایجاد کنید · ایمیل: hadipishghadam13@gmail.com

---

⭐ اگر این پروژه برای شما مفید بود، لطفاً آن را در GitHub ستاره دهید!