1. Introducción

WISP Solution es una plataforma profesional diseñada para Proveedores de Internet (WISP) que permite administrar clientes, planes, cortes automáticos, pagos y equipos MikroTik desde un solo lugar, de forma centralizada y totalmente automatizada.

¿Cómo funciona WISP Solution?

El sistema trabaja en nuestros servidores y se conecta a tus routers MikroTik mediante una conexión segura a través de VPN. Esto permite que WISP Solution tenga acceso en tiempo real a tu red, sin necesidad de abrir puertos en tus módems o exponer tus equipos a internet.

Gracias a esta conexión segura, el sistema puede:

• 📡 Detectar el estado de tus MikroTiks en tiempo real (online/offline).
• 👥 Ver a tus clientes conectados, ya sea por Queue o PPPoE.
• 📊 Monitorear el consumo de cada cliente (descarga, subida, velocidad).
• 🔄 Realizar cortes y reactivaciones automáticamente según la fecha de corte.
• ⚙️ Administrar planes, velocidades y configuraciones desde una interfaz sencilla.
• 🌎 Ver clientes en el mapa mediante coordenadas GPS.
• 📥 Importar clientes directamente desde tu MikroTik sin capturar datos manualmente.

¿Qué podrás aprender en este manual?

En este manual aprenderás a usar cada módulo del sistema: agregar MikroTiks, registrar clientes, configurar planes, importar datos desde tu router, generar cortes automáticos, revisar logs y monitorear tu red en tiempo real.

Este documento está diseñado para guiarte paso a paso, incluso si es tu primera vez utilizando WISP Solution.

2. Gestión de usuarios

Cómo obtener una cuenta

Para comenzar a usar WISP Solution, primero debes crear una cuenta desde la página de inicio de sesión. Solo necesitas tu nombre completo y tu correo electrónico.

Cuando completes el formulario, el sistema enviará un correo de verificación. Es necesario confirmar tu correo para activar tu cuenta.

Cuenta demo gratuita

Al registrarte por primera vez, recibirás una cuenta demo totalmente funcional con capacidad para administrar hasta 10 usuarios. Esta cuenta te permite conocer todas las herramientas del sistema sin costo.

Actualizar a un plan profesional

Si deseas ampliar el número de clientes, activar una licencia profesional o contratar un plan mensual/anual, puedes contactarte directamente con un asesor para activar tu cuenta completa.

Iniciar sesión

Una vez verificado tu correo, ingresa nuevamente a la plataforma, escribe tu correo y contraseña, y podrás acceder al panel principal del sistema donde administrarás todos tus clientes y MikroTiks.

3. Configuración de MikroTik

Para que WISP Solution pueda administrar tus routers en tiempo real, primero es necesario conectar tus MikroTiks al sistema mediante una VPN segura. Esto evita abrir puertos en tu módem y garantiza una conexión estable.

1. Obtener la VPN y el Script de Instalación

En el menú de Administración MikroTik, selecciona la opción “Obtener VPN y Script”. Ahí encontrarás dos opciones:

• 📌 Script para MikroTik v6
• 📌 Script para MikroTik v7

Elige la versión correspondiente a tu router. El sistema generará un script completamente listo para copiar y pegar directamente en la terminal de tu MikroTik.

IMPORTANTE: Al finalizar la instalación, el sistema te mostrará una IP privada asignada por la VPN. Guarda esa IP, ya que la necesitarás para registrar el MikroTik en el sistema.

2. Agregar un MikroTik al sistema

Una vez instalada la VPN en tu router, dirígete a la sección Administrar MikroTik y selecciona el botón:

➕ Agregar MikroTik

Se abrirá un formulario con los siguientes campos:

• 🌐 IP Pública o VPN: Aquí debes colocar la IP asignada por la VPN.
• 👤 Usuario MikroTik: El usuario con permisos API (por ejemplo, admin o un usuario creado para el sistema).
• 🔒 Contraseña MikroTik: La contraseña del usuario API.
• 🚪 Puerto API: Por defecto es 8728, a menos que lo hayas cambiado.

Después de llenar los campos, presiona Probar Conexión. Si los datos son correctos y la VPN está activa, el sistema confirmará la conexión.

3. Estado del MikroTik

Una vez agregado, el MikroTik aparecerá en la lista de Administración MikroTik junto con su estado:

• 🟢 En línea: El router está conectado correctamente al sistema.
• 🔴 Desconectado: No se detecta conexión. Puede ser por VPN caída, API apagada o contraseña incorrecta.

Desde esta sección también podrás editar la información del router o eliminarlo del sistema si ya no se utiliza.

4. Clientes

En esta sección podrás registrar y administrar a todos los clientes que cuentan con tu servicio de internet. WISP Solution permite agregar clientes de forma manual o importarlos directamente desde tu MikroTik.

1. Agregar clientes manualmente

Puedes registrar clientes desde el botón “Agregar Cliente”. El sistema permite dos tipos de configuración:

• 📌 PPPoE — Debes ingresar usuario PPPoE, contraseña y seleccionar el plan.
• 📌 Simple Queue (Queues) — Debes ingresar la IP del cliente y el plan de velocidad.

Al crear un cliente manualmente, el sistema colocará automáticamente la fecha de corte según el día configurado en la sección de Configuración.

2. Importar clientes desde MikroTik

Si ya tienes clientes configurados en tu MikroTik, puedes importarlos directamente usando la opción “Exportar desde MikroTik”.

El sistema es compatible con:

• 📥 Queues (Simple Queue)
• 📥 PPPoE / Secrets
• 📥 DHCP (si está habilitado en el sistema)

Durante la importación, WISP Solution detectará automáticamente duplicados, actualizará datos existentes si corresponde y asignará la fecha de corte del siguiente mes usando el día configurado por el usuario.

3. Crear planes antes de registrar clientes

Antes de agregar o importar clientes, es importante configurar tus planes de internet.

El sistema utiliza estos planes para:

• 💰 Saber cuánto cobrar al cliente.
• ⚡ Asignar velocidad en las Simple Queues.
• 🔧 Configurar límites de velocidad en PPPoE si se administra automáticamente.

Si los planes no están configurados, el sistema no podrá asignar valores correctos.

4. Administración automática o manual

WISP Solution permite definir cómo se gestionan los clientes:

• 🤖 Administración automática: El sistema realiza cortes y reactivaciones automáticamente según la fecha de corte. También modifica la Simple Queue en MikroTik para suspender o activar el servicio.
• 👨‍💼 Administración manual: Un administrador decide cuándo suspender o reactivar el servicio desde el panel, sin automatización por parte del sistema.

Esta opción se selecciona al agregar o editar un cliente.

5. Facturación automática

La sección de Facturación permite llevar el control completo de los pagos de los clientes, generar comprobantes automáticamente y administrar cortes o reactivaciones de forma automática según la fecha de corte configurada.

1. Registrar pagos de clientes

Desde esta sección podrás registrar el pago de un cliente seleccionándolo en la lista y eligiendo el método de pago (efectivo, transferencia, depósito, etc.).

Al registrar el pago:

• 💳 El sistema actualiza la fecha de corte automáticamente al siguiente mes.
• 📄 Se genera un comprobante de pago de forma automática.
• 📥 El comprobante puede descargarse o reenviarse al cliente.

2. Generación automática de comprobantes

Cada vez que se registre un pago, WISP Solution creará un comprobante en formato digital con:

• Nombre del cliente
• Plan contratado
• Monto pagado
• Fecha de pago
• Fecha próxima de corte
• Datos fiscales o del negocio (opcional)

Estos comprobantes pueden imprimirse o descargarse directamente.

3. Cortes automáticos según fecha de corte

El sistema usa el día configurado en la sección de Configuración para generar la fecha de corte de cada cliente.

Cuando llega esa fecha, si un cliente no tiene un pago registrado:

• ⛔ Se genera un corte automático.
• 🚫 El sistema suspende el servicio desde MikroTik (Queue o PPPoE).

Si el sistema está configurado en modo automático, los cortes se realizan sin intervención del administrador.

4. Reactivación automática después del pago

Una vez que un cliente realiza su pago:

• 🔓 El sistema reactiva su servicio de internet automáticamente.
• ⏳ Se asigna la nueva fecha de corte para el siguiente mes.
• 📘 Se genera un comprobante digital.

Todo este proceso queda registrado en los Logs del sistema para auditoría.

6. Importar desde MikroTik

WISP Solution permite importar clientes directamente desde tu router MikroTik sin necesidad de capturar datos manualmente. Esta función acelera la migración al sistema y evita errores de escritura.

1. Antes de importar

Para que la importación funcione correctamente, asegúrate de:

• ✔ Tener el MikroTik agregado y en línea dentro de WISP Solution.
• ✔ Tener configurados los planes en el sistema (necesarios para asignar velocidad o tarifas).
• ✔ Haber conectado tu MikroTik mediante la VPN generada por el sistema.

2. Tipos de importación disponibles

El sistema puede importar clientes desde tres fuentes principales del MikroTik:

• 📥 Simple Queue (Queues): Importa clientes que navegan por IP con límites de velocidad.
• 📥 PPPoE Secrets: Importa usuarios PPPoE con usuario y contraseña.
• 📥 DHCP Leases: (opcional) Para redes que usan DHCP y Simple Queue.

Solo necesitas seleccionar el origen y el sistema mostrará una lista con todos los clientes encontrados.

3. Detección automática de clientes

El sistema identifica cada cliente usando:

• 🔑 IP del cliente (para Queue)
• 🔑 Usuario PPPoE (para Secret)
• 📶 Velocidad asignada
• 📛 Nombre o comentario configurado en MikroTik

Una vez detectados, se mostrará la lista para que confirmes cuáles deseas importar.

4. Manejo de duplicados

Si un cliente ya existe en tu base de datos, el sistema lo detectará automáticamente y mostrará tres opciones:

• 🔄 Actualizar — Si el plan o velocidad cambió.
• 📑 Ignorar — Si es el mismo cliente con la misma información.
• 🆕 Agregar como nuevo — Si es un cliente diferente con datos similares.

5. Fecha de corte automática

Al importar un cliente desde MikroTik, el sistema asigna automáticamente la fecha de corte usando:

• 📅 El día configurado en la sección de Configuración
• ⏭ El mes siguiente al actual

Ejemplo: Si la fecha de corte configurada es el día 5 y estamos en marzo, el cliente se registrará con fecha de corte: 5 de abril.

6. Finalizar importación

Una vez confirmados los clientes, el sistema los agregará automáticamente y podrás administrarlos desde la sección de Clientes.

Si la administración automática está habilitada, el sistema comenzará a aplicar cortes y reactivaciones según corresponda.