ZeroBot Documentation

Your complete guide to setup, configuration, and integration

Introduction

ZeroBot is an advanced anti-bot solution that shields websites from unwanted automated traffic, offering robust, real-time detection and prevention capabilities powered by AI-driven fingerprinting.

Its flexible integration makes it ideal for websites, SaaS platforms, and marketing systems that need reliable protection and accurate traffic analytics.

About

Built for simplicity and efficiency, ZeroBot uses behavioral detection, ASN filtering, and device fingerprinting to block bots while allowing real human visitors to pass through seamlessly.

With its easy configuration and strong security layer, ZeroBot helps you maintain valid traffic analytics, protect your ad budgets, and optimize site performance.

Quick Setup in 3 Minutes

  1. Download your ZeroBot file
    From your dashboard, download ZeroBot_V8.php to your computer.
  2. Open the file
    Right-click the file → Open with Notepad / VS Code.
  3. Paste your license key
    Find this line: 
    $license_key = "YOUR_LICENSE_KEY";
    Replace YOUR_LICENSE_KEY with the key from your dashboard.
  4. Save the file
    Press Ctrl + S and close the editor.
  5. Upload to your website
    Upload ZeroBot_V8.php to:
    • public_html (cPanel)
    • httpdocs (Plesk)
  6. Open the file in browser
    Visit: 
    https://yourdomain.com/ZeroBot_V8.php
    If the page loads → ZeroBot is active ✅
  7. Go to your dashboard
    Open ZeroBot Dashboard → Custom Rules.
  8. Create your first rule
    Set:
    • Antibot Link → ZeroBot_V8.php
    • Redirect Link → your landing page
  9. Enable protection
    Turn ON:
    • VPN Block
    • Datacenter Block
    • Fingerprint
  10. Save — you are protected 🎉
    From now on, all visitors go through ZeroBot automatically.
You never edit the file again. All changes are done from the dashboard.
Once uploaded, all protection settings such as VPN blocking, cloaking, countries, devices, captcha, and redirects are managed from the ZeroBot Dashboard → Custom Rules.
Make sure you do not keep both index.html and index.php in the same directory — the HTML file will override the ZeroBot script.

Custom Rules Configuration

ZeroBot Custom Rules allow you to fully control how traffic is filtered, redirected, and logged. Each rule applies to a specific antibot link and defines how visitors are handled based on security, device, country, and behavior checks.

Setting Explanation
Basic Information
Antibot Link The protected ZeroBot file (e.g. ZeroBot_V8.php) where the rule is applied. This is the entry point that visitors access.
Redirect Link The destination URL where legitimate visitors are redirected after passing all filters.
Blocking Controls
Block VPN When enabled, visitors using VPN or proxy services are blocked and treated as invalid traffic.
Block Datacenter Blocks traffic coming from hosting providers, cloud servers, and datacenters commonly used by bots.
Fingerprint Activate Enables browser fingerprinting to detect advanced bots, repeated users, and automation tools.
Devices & Countries
Allowed Countries Select which countries are allowed to access the redirect link. Visitors from non-selected countries are blocked automatically.
Allowed Devices Restrict access by device type:
  • All Devices – No restriction
  • Mobile – Only smartphones & tablets
  • Desktop – Only desktop browsers
Cloaker & Grabber
Check Red Page Detects if your redirect link is flagged as a Google Red Page. If detected, ZeroBot can notify you instantly.
Cloaker Activate When enabled, bots and blocked visitors are shown alternative content instead of being redirected.
Cloaker URL The clean website URL displayed to bots when cloaking is active (for example, a blog or neutral landing page).
Autograbber Automatically captures email parameters from incoming links (e.g. ?email=test@domain.com) for tracking or reuse.
Autograbber Code Defines the separator character used to append captured values to the page URL. Default is #.
Analytics & Notifications
Location Bots URL where bots and blocked traffic are redirected when cloaking is disabled (default: https://google.com).
Views File Name The file used to store visitor logs and analytics data (default: views.php).
Telegram Token & Chat ID Enables Telegram notifications for rule activity, red page detection.
Captcha Activation Enables Cloudflare Turnstile captcha to verify real visitors and block automated traffic.
Captcha Cloudflare Key Your Cloudflare Turnstile Site Key used when captcha protection is enabled.

Important

Once the setup is complete, don’t forget to authorize your domain via your ZeroBot dashboard. Unauthorized domains will not be able to run the script properly.

Thank You

Thank you for choosing ZeroBot — we appreciate your trust and commitment to secure, intelligent, and optimized web traffic management.

Need help? Our support team is always ready to assist via Telegram or the ZeroBot dashboard chat.

© 2025 ZeroBot — All Rights Reserved.