================================================================================
TELEGRAM JOIN-REQUEST BOT — cPanel CRON SETUP (cron.txt)
================================================================================

IMPORTANT:
- Cron jobs SERVER par chalti hain, aapke laptop par NAHI.
- Laptop band hone se bot NAHI rukta — jab tak hosting active hai aur cron set hai.
- Join-request DM window limited hai (~5 min). Isliye POLL cron jitna fast ho sake utna accha.
- Shared hosting par har-second cron possible NAHI — minimum practical: every 1 minute.

================================================================================
STEP 1: cPanel mein Cron Jobs kahan milte hain
================================================================================

1. cPanel login karo
2. "Advanced" section → "Cron Jobs"
3. "Add New Cron Job" section mein command add karo

================================================================================
STEP 2: PHP binary path
================================================================================

Common paths (hosting ke hisaab se ek try karo):

  /usr/local/bin/php
  /usr/bin/php
  /opt/cpanel/ea-php81/root/usr/bin/php    (PHP 8.1 — ea-php)
  /opt/cpanel/ea-php82/root/usr/bin/php    (PHP 8.2 — ea-php)
  /opt/cpanel/ea-php83/root/usr/bin/php    (PHP 8.3 — ea-php)

PHP path check (SSH / Terminal):

  which php
  php -v

cPanel → "Select PHP Version" → CLI path bhi wahan mention hota hai.

================================================================================
STEP 3: Bot folder path
================================================================================

Apna exact path use karo. Example:

  /home/cpanelusername/public_html/bot/mybot.php

Replace:
  cpanelusername  →  apna cPanel username
  public_html/bot →  jahan files upload ki hain

================================================================================
RECOMMENDED CRON JOBS (BEST for join-request DM speed)
================================================================================

--- Poll: every 1 minute (getUpdates + join requests + callbacks + /start) ---

* * * * * /usr/local/bin/php -q /home/USERNAME/public_html/bot/mybot.php poll >/dev/null 2>&1

--- Queue: every 1 minute (10s reminder + 5s final offer) ---

* * * * * /usr/local/bin/php -q /home/USERNAME/public_html/bot/mybot.php queue >/dev/null 2>&1

--- Cleanup: every 10 minutes (locks, old logs) ---

*/10 * * * * /usr/local/bin/php -q /home/USERNAME/public_html/bot/mybot.php cleanup >/dev/null 2>&1

================================================================================
ALTERNATE: ea-php path example (PHP 8.1)
================================================================================

* * * * * /opt/cpanel/ea-php81/root/usr/bin/php -q /home/USERNAME/public_html/bot/mybot.php poll >/dev/null 2>&1
* * * * * /opt/cpanel/ea-php81/root/usr/bin/php -q /home/USERNAME/public_html/bot/mybot.php queue >/dev/null 2>&1
*/10 * * * * /opt/cpanel/ea-php81/root/usr/bin/php -q /home/USERNAME/public_html/bot/mybot.php cleanup >/dev/null 2>&1

================================================================================
STAGGERED CRON (if host limits concurrent PHP)
================================================================================

Poll at :00, :20, :40 — Queue at :10, :30, :50 (less ideal for join-request window):

*/1 * * * * /usr/local/bin/php -q /home/USERNAME/public_html/bot/mybot.php poll >/dev/null 2>&1
*/1 * * * * sleep 30; /usr/local/bin/php -q /home/USERNAME/public_html/bot/mybot.php queue >/dev/null 2>&1

Note: "sleep 30" wala trick har host par allow nahi hota.

Better: dono alag minute slots par:

* * * * * /usr/local/bin/php -q /home/USERNAME/public_html/bot/mybot.php poll >/dev/null 2>&1
* * * * * /usr/local/bin/php -q /home/USERNAME/public_html/bot/mybot.php queue >/dev/null 2>&1

================================================================================
AVOID CRON EMAIL SPAM
================================================================================

Har command ke end mein output redirect lagao:

  >/dev/null 2>&1

Isse cron output email nahi bhejega.

Agar debug chahiye temporarily, redirect hata do aur cPanel cron email check karo.

================================================================================
MANUAL TEST (SSH / cPanel Terminal)
================================================================================

cd /home/USERNAME/public_html/bot
php mybot.php poll
php mybot.php queue
php mybot.php cleanup

Expected: no fatal errors. Debug mode ON ho to logs/bot.log check karo.

================================================================================
LOW-COST SHARED HOSTING LIMITATIONS
================================================================================

- Cron "every minute" set karoge to bhi kabhi 1-2 min delay ho sakta hai
- Join-request welcome DM is delay par depend karta hai
- Agar DM miss ho raha hai → VPS ya faster hosting consider karo
- approve_even_if_dm_fails = yes rakho taaki user channel mein join ho jaye

================================================================================
WEBHOOK — DO NOT USE
================================================================================

Ye bot webhook use NAHI karta. Sirf getUpdates + cron.

Agar pehle webhook set tha to BotFather/Telegram API se delete karo:

  https://api.telegram.org/bot<TOKEN>/deleteWebhook

================================================================================
QUICK COPY TEMPLATE (edit USERNAME and path)
================================================================================

* * * * * /usr/local/bin/php -q /home/USERNAME/public_html/bot/mybot.php poll >/dev/null 2>&1
* * * * * /usr/local/bin/php -q /home/USERNAME/public_html/bot/mybot.php queue >/dev/null 2>&1
*/10 * * * * /usr/local/bin/php -q /home/USERNAME/public_html/bot/mybot.php cleanup >/dev/null 2>&1

================================================================================