Empezar
Primeros pasos
Lo diario
Clientes Facturación Soporte y tickets
Tu red
Red y Mikrotik Fibra óptica (OLT) WiFi de clientes (TR-069) Mapa
Configuración
Datos de la empresa Correo y WhatsApp WhatsApp (Meta) — configuración completa Cobro automático de suscripción (PayPal) — solo dueño de plataforma Pagos y bancos Plantillas de mensajes
Otros
Portal de clientes Preguntas frecuentes
Primeros pasos

1Qué hacer primero al entrar

Recomendamos este orden para dejar el sistema listo:

  1. Agrega tu primer Mikrotik en "Red & Mikrotik"
  2. Crea tus planes de internet (velocidad y precio)
  3. Agrega tus clientes uno por uno o impórtalos por CSV
  4. Llena los datos de tu empresa y tu correo/WhatsApp en Configuración
  5. Si facturas formalmente, activa el NCF en Facturación

2¿Qué significa cada estado de un cliente?

  • Activo — tiene servicio funcionando normal
  • Suspendido — tú lo pausaste manualmente
  • Moroso — el sistema lo cortó automático por facturas vencidas
  • Cancelado — ya no es cliente (se usa para calcular el churn)
Clientes

1Agregar un cliente nuevo

Ve a Clientes → Nuevo cliente. Si le vas a poner usuario PPPoE, primero tienes que elegir a qué nodo (Mikrotik) pertenece — el sistema crea el usuario ahí mismo, en automático.

2Importar muchos clientes de una vez (CSV)

En Clientes → Importar CSV, sube tu archivo de Excel/CSV. El sistema reconoce columnas como nombre, telefono, plan_nombre, nodo_nombre, pppoe_user — no hace falta que los nombres de columna sean exactos, el sistema los reconoce de varias formas comunes.

3Filtrar y buscar clientes rápido

En la lista de Clientes puedes filtrar por estado (chips arriba), por nodo (selector a la derecha de los chips), y cambiar cuántos ver por página (10/50/100/500) abajo de la tabla.

4Suspender o reactivar el servicio

Entra a la ficha del cliente y usa los botones "Suspender" / "Activar". El método real que usa (PPPoE, lista de direcciones, o cola simple) depende de cómo configuraste el nodo al que pertenece.

Facturación

1¿Cómo se generan las facturas cada mes?

Todos los días a las 6:05am el sistema revisa qué clientes tienen su "día de facturación" hoy, y les crea la factura solo. También manda recordatorios antes del corte, y aplica el corte automático a quien se pase de facturas vencidas.

2Registrar un pago

Entra a la factura y dale "Registrar pago" — puedes poner el monto exacto (para pagos parciales) o dejarlo vacío para marcarla como pagada completa.

3Activar el comprobante fiscal (NCF)

En Configuración → Facturación, activa "Usar Comprobante Fiscal", pon tu RNC, el tipo (ej. B02), y el rango de secuencia que te autorizó la DGII. Cada factura nueva le pone el siguiente número solo.

4Recargo por mora

En Configuración → Facturación, pon el porcentaje — se le suma automático a cualquier factura que pase a "Vencida".

5Anular una factura o darle un descuento

Desde la ficha de la factura: "Anular" (no se puede si ya está pagada — usa un ajuste de crédito en ese caso) o "Aplicar descuento" con un monto y motivo.

Soporte y tickets

1Crear y mover un ticket

En Soporte/Tickets → Nuevo ticket. Arrastra la tarjeta entre las columnas (Abiertos, En progreso, Resueltos) según avance.

2Encuesta de satisfacción automática

Cuando marcas un ticket como "Resuelto" por primera vez, el sistema le manda solo una encuesta de 5 estrellas al cliente por su medio de contacto preferido.

Red y Mikrotik

1Agregar tu primer Mikrotik

En Red & Mikrotik → Agregar Mikrotik, necesitas: la IP del router, usuario y clave de la API (no la del panel Winbox — puedes usar la misma si quieres), y el puerto (por defecto 8728).

2¿Qué método de corte elegir?

  • Usuario PPPoE — el más simple, deshabilita el usuario directo
  • Lista de direcciones — agrega la IP del cliente a una lista bloqueada por firewall
  • Cola simple — limita la velocidad a algo mínimo en vez de cortar del todo

3Rango de IP y IPs disponibles

Si le pones a tu nodo un rango CIDR (ej. 10.10.0.0/24), el sistema calcula solo qué IPs de ese rango ya están usadas y cuáles están libres al asignarle una IP estática a un cliente.

Fibra óptica (OLT)

1Agregar tu OLT

En OLT / Fibra → Agregar OLT: host, usuario/clave de Telnet, y los números de puerto PON que uses (ej. "1,2,3,4").

2Autorizar una ONU nueva

En la tarjeta del OLT, sección "ONUs nuevas sin autorizar" → "Buscar". Ahí verás las que están conectadas físicamente esperando que las autorices.

3Alertas de señal débil

El sistema captura la señal de cada ONU cada 15 minutos. Si una cae mucho en 24h, o cruza el umbral de señal débil, aparece una alerta en el Panel General — antes de que el cliente llame por el servicio lento.

WiFi de clientes (TR-069)

1¿Qué es esto?

Te deja ver y cambiar el nombre de red (SSID) y clave del WiFi del router de un cliente, sin tener que ir hasta su casa. Funciona con el protocolo TR-069 — el router del cliente se conecta solo a nuestro sistema por internet.

2¿Con cuáles routers funciona?

Con routers que tú entregas a tus clientes y que soportan TR-069 (la mayoría de ONTs/routers de fibra "libres" — Huawei, ZTE, TP-Link, y muchos genéricos para WISPs). No funciona con routers que el cliente ya trajo de otro proveedor de internet — esos normalmente vienen bloqueados para hablar solo con el ACS de ese otro proveedor.

3Configurar un router nuevo, paso a paso

  1. Conecta el router a internet normalmente (con el servicio ya activo)
  2. Entra a la configuración del router desde un navegador — normalmente en 192.168.1.1 o 192.168.0.1 (revisa la etiqueta pegada en el router si no sabes cuál es)
  3. Busca en el menú una sección llamada "TR-069", "CWMP", "WAN Management Protocol", o "Remote Management" — el nombre exacto cambia según la marca del router
  4. Activa esa opción, y en el campo "URL del ACS" (o "ACS URL", "Servidor de gestión") pon: http://tramaisp.com:7547
  5. Si te pide usuario y clave para el ACS, déjalos en blanco o pon cualquier valor — no se usan por ahora
  6. Guarda los cambios en el router

4Vincularlo a un cliente en el panel

Entra a WiFi / TR-069 en el menú lateral (o desde la ficha del cliente) y dale a "Actualizar lista" — el router debería aparecer unos minutos después de guardar la configuración de arriba. Dale a "Vincular" y elige a cuál cliente pertenece.

5Cambiar el WiFi de un cliente

Con el router ya vinculado (desde su ficha o desde "WiFi / TR-069"), escribe el nuevo nombre de red y/o la nueva clave, y dale a "Aplicar cambios". Si el router está conectado ahora mismo, el cambio se aplica en segundos; si no, se aplica solo la próxima vez que el router se conecte.

6¿Por qué no aparece mi router en la lista?

  • Espera unos minutos — el router se reporta solo cada cierto tiempo, no es instantáneo
  • Confirma que escribiste bien la URL del ACS, sin errores de tipeo
  • Confirma que el router tiene internet funcionando de verdad
  • Si el router llegó configurado por otro proveedor de internet, es probable que esté bloqueado — revisa si tiene una opción para "restaurar a valores de fábrica" antes de reconfigurarlo (esto borra toda su configuración anterior)
Mapa

1Ver quién está sin servicio ahora mismo

En el Mapa, los clientes sin conexión muestran un anillo rojo animado. Si varios están agrupados en la misma zona, seguramente es un poste o un tramo de fibra — no averías individuales.

2Agregar un poste

"Agregar poste (clic en mapa)" y luego haz clic en la ubicación exacta, o usa "Poste en mi ubicación" si estás ahí físicamente con el celular.

3Mover un cliente o poste ya existente

Por seguridad, los puntos no se arrastran solos — abre su popup y dale al botón "📍 Mover" primero.

Datos de la empresa

1¿Dónde configuro el nombre, logo y datos de mi empresa?

En Usuarios y configuración → Empresa. Todo esto aparece en tus facturas y el portal de tus clientes.

2API key de Google Maps

Sácala gratis en console.cloud.google.com/google/maps-apis (activa "Maps JavaScript API"). Sin esto, el mapa no carga para nadie de tu empresa.

Correo y WhatsApp

1Configurar tu propio correo (SMTP)

En Configuración → Correo (SMTP). Si usas Gmail, el host es smtp.gmail.com, puerto 587, y en la contraseña necesitas una "clave de aplicación" (no tu clave normal de Gmail — se genera desde la configuración de seguridad de tu cuenta de Google).

2Configurar WhatsApp/SMS (Twilio)

Necesitas una cuenta propia en twilio.com. Copia tu Account SID, Auth Token, y el número de WhatsApp/SMS que te asignen ahí. Esto queda como respaldo si no configuras Meta (ver la siguiente categoría, es la opción recomendada).

WhatsApp (Meta) — configuración completa

0Antes de empezar — qué vas a necesitar

  • Una cuenta de Facebook personal (la usas solo para entrar, no aparece en ningún mensaje)
  • Un número de teléfono que no esté activo en la app normal de WhatsApp ni WhatsApp Business — puede recibir SMS o llamada para verificarse, eso es todo
  • Documentos de tu empresa a mano (RNC, registro mercantil) — Meta los pide para la verificación
  • Calcula 1 a 5 días hábiles en total (la mayor parte es esperar la aprobación de Meta, no trabajo tuyo)

1Paso 1 — Crear tu cuenta de Meta Business

  1. Entra a business.facebook.com con tu Facebook personal
  2. Si es la primera vez, te va a pedir crear una "Cartera de negocios" (Business Portfolio) — ponle el nombre legal de tu ISP, ej. Mi ISP SRL
  3. Te va a pedir tu correo de trabajo y el país — usa un correo con tu propio dominio si tienes uno (ej. admin@tuisp.com), se ve más confiable ante Meta que un Gmail genérico
  4. Ve al menú de engranaje (⚙️) arriba a la derecha → "Configuración del negocio"
  5. En el menú izquierdo, busca "Verificación del negocio" (a veces bajo "Seguridad del centro") y dale "Empezar verificación"
  6. Sube: nombre legal exacto de tu empresa, dirección física, teléfono, y un documento (RNC/registro mercantil/factura de servicios a nombre de la empresa)
  7. Ejemplo real de lo que Meta pide que coincida exacto: si tu RNC dice "Mi ISP, S.R.L.", pon ese nombre EXACTO en Meta — con la coma, con "S.R.L." — cualquier diferencia de puntuación puede rechazar la verificación

📄 Documentación oficial de Meta (siempre actualizada, con capturas reales): business.facebook.com/business/help/2058515294227817

2Paso 2 — Crear la app de desarrollador con WhatsApp

  1. Ve a developers.facebook.com (con la misma cuenta de Facebook)
  2. Arriba a la derecha, "Mis apps""Crear app"
  3. Cuando te pregunte el "caso de uso", elige "Otro" y en el siguiente paso agrega el producto "WhatsApp" (o si te aparece directo "WhatsApp Business Platform", esa)
  4. Nombre de la app: cualquier cosa interna, ej. MiISP-WhatsApp (el cliente nunca ve este nombre)
  5. Cuando te pregunte a cuál Cartera de negocios conectarla, elige la que creaste en el Paso 1

📄 Guía oficial paso a paso con capturas: developers.facebook.com/docs/whatsapp/cloud-api/get-started

3Paso 3 — Agregar y verificar tu número

  1. Dentro de tu app nueva, en el menú izquierdo entra a WhatsApp → Configuración de la API (a veces dice "API Setup" o "Introducción")
  2. Vas a ver un número de prueba GRATIS que Meta te da automático — sirve para probar, pero solo le puede escribir a números que agregues a una lista de prueba (máximo 5). Para producción real, sigue con tu propio número:
  3. Busca el botón "Agregar número de teléfono"
  4. Escribe el número completo con código de país, ej. +1 809 555 0000
  5. Elige verificación por SMS o llamada, y pon el código de 6 dígitos que te llegue
  6. Ponle un nombre para mostrar (Display Name) — este SÍ lo ve el cliente en WhatsApp, ej. Mi ISP — Meta también revisa que este nombre tenga sentido con tu negocio verificado, así que evita nombres genéricos tipo "Soporte" solo

4Paso 4 — Copiar tus credenciales

En la misma pantalla de "Configuración de la API", vas a ver dos cosas — cópialas exactas, sin espacios:

  • Phone Number ID: un número largo tipo 109876543210987 (NO es tu número de teléfono, es un ID interno de Meta)
  • Token de acceso temporal: una cadena larga que empieza con EAAxxxxx... — este dura solo 24 horas, es solo para que hagas tu primera prueba. Para producción, sigue al Paso 5

5Paso 5 — Generar el token PERMANENTE (el que sí usarás siempre)

  1. Ve a Configuración del negocio (el mismo lugar del Paso 1) → menú izquierdo → "Usuarios" → "Usuarios del sistema"
  2. "Agregar" → nombre cualquiera, ej. Sistema TramaISP → rol: Administrador
  3. Dale clic al usuario que acabas de crear → "Agregar activos" → selecciona tu app de WhatsApp del Paso 2, con permiso "Control total"
  4. Botón "Generar nuevo token" → elige tu app → marca el permiso whatsapp_business_messaging (y whatsapp_business_management también, por si acaso) → duración: "Nunca"
  5. Copia ese token — Meta solo te lo muestra una vez, si lo pierdes tienes que generar uno nuevo

6Paso 6 — Crear tus plantillas de mensaje

Meta exige que cualquier mensaje que tú inicies (no una respuesta a algo que el cliente escribió) use una plantilla previamente aprobada — no se puede mandar texto libre armado por el sistema.

  1. En WhatsApp Manager (business.facebook.com/latest/whatsapp_manager) → menú izquierdo → "Plantillas de mensajes"
  2. "Crear plantilla" → Categoría: "Utilidad" (Utility) — NO "Marketing", así pagas la tarifa barata y no necesitas botón de "cancelar suscripción"
  3. Nombre de la plantilla: usa exactamente los nombres de abajo (en minúsculas, con guion bajo, así los reconoce nuestro sistema)
  4. Idioma: Español (elige el que uses — DOM/LATAM suele ser "Español" a secas, código es)
  5. En el cuerpo del mensaje, escribe tu texto y usa {{1}}, {{2}}, {{3}} donde va cada variable — en este orden exacto, es lo que nuestro sistema espera:
Nombre exactoTexto de ejemplo (puedes cambiar la redacción, no el orden de variables)
factura_nuevaHola {{1}}, tu factura de este mes es de ${{2}}. Fecha límite: {{3}}.
recordatorioHola {{1}}, recuerda que tienes ${{2}} pendiente. Si no pagas antes del día {{3}}, tu servicio podría suspenderse.
corteHola {{1}}, tu servicio fue suspendido por tener {{2}} factura(s) vencida(s). Contáctanos para reactivarlo.
pago_recibidoHola {{1}}, recibimos tu pago de ${{2}}. ¡Gracias!
pago_parcialHola {{1}}, recibimos ${{2}}. Te queda un saldo de ${{3}}.
encuesta_satisfaccionHola {{1}}, resolvimos tu ticket "{{2}}". Califica tu experiencia: {{3}}

Dale "Enviar" — cada plantilla se revisa por separado, y te llega un aviso (dentro de WhatsApp Manager y a tu correo) cuando la aprueben o rechacen. Si rechazan una, casi siempre es porque el texto suena a "spam" o promoción — hazla sonar más neutral/informativa.

7Paso 7 — Configurar todo en TramaISP

  1. Ve a Configuración → WhatsApp (Meta)
  2. Pega el Phone Number ID (Paso 4) y el Access Token permanente (Paso 5)
  3. En "Idioma de tus plantillas" pon el código que usaste en Meta, ej. es
  4. En cada campo de plantilla, pon el nombre EXACTO que le pusiste en el Paso 6 (ej. factura_nueva)
  5. Guarda la configuración

8Paso 8 — Probar que de verdad funciona

  1. En la misma tarjeta, dale a "🔎 Verificar conexión" — si todo está bien, te muestra el nombre y número verificado de tu WhatsApp Business
  2. Escribe tu propio número de celular en "Número para mensaje de prueba" (con código de país, sin espacios ni signos: 18095551234)
  3. Dale a "📨 Enviar mensaje de prueba" — te debería llegar un WhatsApp real usando tu plantilla de "factura_nueva" con datos de ejemplo
  4. Si no llega nada en un minuto, revisa: que la plantilla ya esté APROBADA (no "en revisión"), y que el número de prueba tenga WhatsApp activo

9¿Cuánto cuesta?

La API de Meta en sí es gratis — no hay mensualidad. Pagas solo por mensaje enviado, categoría "Utility" (unos centavos de dólar cada uno, varía por país). Meta te cobra directo a ti con la tarjeta que registres en Meta Business, no a través de TramaISP. Las cuentas nuevas empiezan con un límite de 1,000 clientes distintos por día — sube solo con el uso, sin que hagas nada.

10Errores comunes

  • "Template does not exist": el nombre que pusiste en TramaISP no coincide exacto con el de Meta (revisa mayúsculas/guiones bajos), o la plantilla todavía no fue aprobada
  • "(#131056) Pair rate limit": le mandaste varios mensajes seguidos al mismo número en poco tiempo — espera un momento
  • El mensaje de prueba no llega: confirma que el número de teléfono tenga WhatsApp instalado y activo, y que escribiste el código de país correcto sin el "+" ni espacios
  • "This message was not delivered...": revisa que tu plantilla esté en estado "Aprobada" en WhatsApp Manager, no "En revisión" ni "Rechazada"
Cobro automático de suscripción (PayPal) — solo dueño de plataforma

0¿Qué es esto?

Esto es distinto al PayPal de cada tenant (el que usan para cobrarles a SUS clientes). Esto es tu propio PayPal — el del dueño de TramaISP — para que cuando un tenant pase a un plan pago (Básico/Profesional/Empresarial), PayPal le cobre automático cada mes y te llegue el dinero a ti, sin que nadie tenga que registrar nada a mano.

1Paso 1 — Crear tu app de desarrollador en PayPal

  1. Entra a developer.paypal.com con tu cuenta de PayPal Business (la tuya, no la de un tenant)
  2. Ve a "Apps & Credentials"
  3. Arriba, elige el ambiente: "Sandbox" para probar primero (recomendado), o "Live" cuando ya quieras cobros reales
  4. "Create App" → ponle un nombre, ej. TramaISP-Suscripciones
  5. Copia el Client ID y el Secret que te muestra — estos son los que vas a pegar en TramaISP

2Paso 2 — Configurar el Webhook (para que te avisen los cobros)

  1. Dentro de esa misma app, busca la sección "Webhooks"
  2. "Add Webhook"
  3. URL: https://tramaisp.com/api/webhooks/paypal
  4. Eventos a marcar (busca y selecciona estos 4):
    • BILLING.SUBSCRIPTION.ACTIVATED
    • PAYMENT.SALE.COMPLETED
    • BILLING.SUBSCRIPTION.CANCELLED
    • BILLING.SUBSCRIPTION.SUSPENDED
  5. Guarda, y copia el Webhook ID que te asigne (parece un código largo tipo 8PT597110X687914E)

3Paso 3 — Pegar todo en TramaISP

  1. Ve a Plataforma (menú lateral) → busca la tarjeta "Cobro automático de suscripción (PayPal)"
  2. Modo: deja "Sandbox" mientras pruebas
  3. Pega el Client ID, el Client Secret, y el Webhook ID
  4. Dale a "Guardar credenciales"

4Paso 4 — Crear los planes en PayPal

En esa misma tarjeta, dale a "Crear planes en PayPal" — esto crea automáticamente un producto y los planes de pago vigentes en tu cuenta de PayPal (Starter, Starter Pro, Básico, Básico Pro, Enterprise, Ultimate), usando los precios que tengas puestos en el sistema. Los planes anteriores (Básico viejo, Profesional, Empresarial) no se tocan — siguen cobrando a los tenants que ya los tenían, sin cambios. Solo hace falta correrlo una vez — si cambias los precios más adelante, avísame para ajustar esto (los planes ya creados no cambian de precio solos).

5Paso 5 — Probar en Sandbox antes de ir en serio

  1. Crea una cuenta de prueba en sandbox.paypal.com (PayPal te da cuentas de prueba con dinero ficticio en tu Developer Dashboard, sección "Sandbox → Accounts")
  2. Como si fueras un tenant, ve a Configuración → Mi Suscripción y prueba pasar a un plan pago
  3. Aprueba el pago con la cuenta de prueba — confirma que en Plataforma el tenant pase a "activo" solo, sin que tú hagas nada

6Paso 6 — Pasar a Live (cobros reales)

  1. Repite el Paso 1 y 2, pero esta vez con el ambiente "Live" en el Developer Dashboard (son credenciales DISTINTAS a las de Sandbox)
  2. En TramaISP, cambia el Modo a "Live" y pega las credenciales nuevas
  3. Vuelve a darle a "Crear planes en PayPal" (los de Sandbox no sirven en Live, son cuentas separadas)

7¿Qué pasa si un tenant no paga (tarjeta rechazada, etc.)?

PayPal reintenta el cobro automáticamente (hasta 3 veces, configurado así por defecto). Si falla las 3 veces, PayPal manda el evento de suspensión, y el tenant queda como "suspendido" en tu sistema solo — tú no tienes que hacer nada.

Pagos y bancos

1Mostrar tus datos bancarios a los clientes

En Configuración → Datos bancarios, llena banco, titular y número de cuenta — tus clientes los ven como referencia para transferirte.

2PayPal

Puedes guardar tus credenciales desde ya en Configuración → PayPal, listas para cuando actives el cobro en línea directo.

Plantillas de mensajes

1Personalizar lo que reciben tus clientes

En Configuración → Mensajes hay una tarjeta por cada situación (factura nueva, recordatorio, corte, pago recibido/parcial). Haz clic en las variables como {nombre} para insertarlas donde tengas el cursor.

Portal de clientes

1Darle acceso al portal a un cliente

En su ficha, botón "Generar acceso al portal" — te da un código de 6 dígitos que le compartes. Con eso y su usuario PPPoE (o correo), entra a ver sus facturas y abrir tickets solo.

Preguntas frecuentes

1¿Por qué no me llegan los correos a mis clientes?

Revisa que tengas el SMTP configurado y activado en Configuración → Correo (SMTP) — sin eso, ningún correo sale, ni facturas ni recordatorios.

2¿Puedo tener varios usuarios con distintos permisos?

Sí — en Usuarios puedes crear cuentas con rol admin, finanzas, o técnico, cada uno viendo solo lo que le corresponde.

3Llegué al límite de clientes de mi plan, ¿qué hago?

Contacta al soporte de la plataforma para subir de plan — tus datos actuales no se tocan, solo se levanta el límite.