Primeros pasos

Documentación de ZeroBot

Tu guía completa de instalación, configuración e integración

Introducción

ZeroBot es una solución avanzada anti-bot que protege sitios web del tráfico automatizado no deseado, ofreciendo capacidades robustas de detección y prevención en tiempo real impulsadas por huella digital basada en inteligencia artificial.

Su integración flexible lo hace ideal para sitios web, plataformas SaaS y sistemas de marketing que necesitan protección confiable y análisis de tráfico precisos.

Acerca de

Diseñado para ser simple y eficiente, ZeroBot utiliza detección conductual, filtrado ASN y huella digital de dispositivos para bloquear bots mientras permite que los visitantes humanos reales pasen sin interrupciones.

Con su fácil configuración y robusta capa de seguridad, ZeroBot te ayuda a mantener análisis de tráfico válidos, proteger tus presupuestos publicitarios y optimizar el rendimiento de tu sitio.

Cómo funciona ZeroBot: un solo motor, distintas funciones

ZeroBot se basa en un único motor anti-bots.
Ese mismo motor de detección impulsa cuatro herramientas diferentes, y cada herramienta lo aplica en una función distinta.
Antes de empezar, es importante entender qué herramientas se ejecutan en tu propio hosting y cuáles se ejecutan en la infraestructura de ZeroBot.

El plan Antibot no incluye hosting.
Tu suscripción te da el script de ZeroBot, acceso a la API y el panel de control — eres tú quien sube el script a tu propio hosting (cPanel, Plesk, VPS o cualquier alojamiento PHP).
ZeroBot no aloja tu sitio web ni guarda el script por ti.
Si prefieres que alojemos el script por ti, ese es un servicio aparte — consulta Hosting privado más abajo.
Herramienta Dónde se ejecuta Qué haces tú
Tú lo alojas: se ejecuta en tu propio hosting
Antibot Tu propio hosting Subes ZeroBot.php a la raíz de tu sitio y le aplicas una regla personalizada.
Link Shortener Tu propio hosting Subes el paquete del acortador a tu servidor y luego generas claves desde el panel.
ZeroBot lo aloja: se ejecuta en nuestra nube
Redirect Generator La nube de ZeroBot (Cloudflare) Nada que subir — generas el enlace protegido desde el panel y lo usas directamente.
Private Hosting La nube de ZeroBot Nada que subir a tu propio servidor — alojas tu página de destino con nosotros, con la protección ya incluida.

¿Por qué esta separación?
El motor es el mismo en todas partes — la diferencia está en dónde se ejecuta la protección.
Antibot y el Acortador de enlaces se ejecutan en tu propio hosting, lo que te da control total sobre tus archivos y tu infraestructura.
El Generador de redirecciones y el Hosting privado se ejecutan en la nube de ZeroBot, para cuando no quieres gestionar ningún servidor.
Elige la herramienta según cuánto quieras alojar tú mismo — la detección de bots es idéntica en todos los casos.

Guía de instalación

Configuración rápida en 3 minutos

1
Descarga tu archivo ZeroBot

Desde tu panel de control, descarga ZeroBot.php a tu computadora.

2
Abre el archivo

Haz clic derecho en el archivo y ábrelo con Notepad o VS Code.

3
Introduce tu clave de licencia

Busca esta línea y reemplázala con la clave de tu panel de control:

$license_key = "YOUR_LICENSE_KEY";
4
Guarda el archivo

Presiona Ctrl + S y cierra el editor.

5
Autoriza tu dominio

Antes de subir el archivo, ve a Panel de control → Mis dominios y agrega el dominio donde desplegarás el script:

example.com

Esto es obligatorio — la API rechazará solicitudes de dominios no autorizados. Más información →

6
Sube el archivo a tu sitio web

Sube ZeroBot.php a tu hosting — puede estar en la raíz de tu sitio o en cualquier subcarpeta que elijas. Solo apunta el Enlace Antibot de tu regla a donde lo hayas subido:

cPanel: public_html Plesk: httpdocs …or any subfolder you choose
7
Abre el archivo en el navegador

Visita tu archivo para verificar que está activo:

https://yourdomain.com/ZeroBot.php
8
Crea tu primera regla

Abre Panel de ZeroBot → Reglas personalizadas y configura:

  • Enlace Antibot → ZeroBot.php
  • Enlace de redirección → tu página de destino
9
Activa la protección

Activa las protecciones que necesites:

VPN Block Datacenter Block Fingerprint
¡Estás protegido! A partir de ahora, todos los visitantes pasan por ZeroBot automáticamente.
No necesitas editar el archivo de nuevo. Todos los cambios se realizan desde el panel de control.
Una vez subido, todos los ajustes de protección como bloqueo de VPN, cloaking, países, dispositivos, captcha y redirecciones se gestionan desde Panel de ZeroBot → Reglas personalizadas.
Asegúrate de no tener tanto index.html como index.php en el mismo directorio — el archivo HTML anulará el script de ZeroBot.

Siguiente: Configurar reglas personalizadas

Después de subir el script de ZeroBot, necesitas crear una Regla personalizada desde el panel de control para activar la protección. Las reglas personalizadas definen cómo se filtra el tráfico, qué se bloquea y hacia dónde se redirigen los visitantes.

Para la referencia completa de configuración, incluyendo todos los ajustes (bloqueo de VPN, huella digital, cloaking, captcha, restricciones de país/dispositivo y más), consulta la guía dedicada:

Ver guía de reglas personalizadas

Importante

Una vez completada la instalación, asegúrate de que tus Reglas personalizadas estén correctamente configuradas en el panel de ZeroBot. Todos los ajustes de protección, incluyendo captcha, bloqueo, cloaking y personalización de marca, se gestionan directamente desde la página de reglas personalizadas.

Gracias

Gracias por elegir ZeroBot — valoramos tu confianza y compromiso con una gestión de tráfico web segura, inteligente y optimizada.

¿Necesitas ayuda? Nuestro equipo de soporte está siempre disponible para asistirte a través de Telegram o el chat del panel de ZeroBot.