ayuda de WHMCS Apps

API 1

• Usar la API directamente Todos los endpoints están en /modules/addons/whmcspwa/api/index.php. Envía una cabecera Authorization: Bearer con el token de acceso. La pantalla de referencia lista la tabla de rutas activa, generada a partir del propio enrutador.

Marca 4

• Iconos de la app Proporciona un PNG de 192px y otro de 512px. Cuadrados, sin esquinas redondeadas y sin transparencia: cada plataforma aplica su propia máscara, y un icono transparente sale con fondo negro en iOS.
• Color de marca y acento El color de marca tiñe los botones principales de la app, los enlaces y la barra de estado del móvil. El acento se reserva para lo que requiere atención, como una factura vencida. Mantenerlos distintos es lo que hace que un saldo pendiente se lea de un vistazo.
• Pastel, claro, oscuro y automático Automático es el valor por defecto y sigue lo que tenga configurado el móvil: tu paleta clara de día y el tema oscuro de noche. Pastel es un fondo blanco roto con líneas suaves, claro es el mismo diseño en grises más fríos, y…
• El icono que viene con el módulo Hasta que subas el tuyo, la app usa una pila de unidades de rack con una luz de estado encendida. Es genérico a propósito, y es un icono de verdad y no un cuadrado de color, para que una instalación sin nada configurado siga…

Funciones 8

• Adjuntar una foto o un archivo, y quién lo ve El personal puede adjuntar archivos a un ticket desde el móvil, incluso directamente desde la cámara, y elegir si el cliente los ve. Por defecto solo los ve el personal, y ese es precisamente el sentido: el error contra el que conviene protegerse es un…
• Adjuntar una captura de pantalla a un ticket nuevo Al abrir un ticket en la app de clientes hay una zona opcional para adjuntos bajo el mensaje: Elegir un archivo selecciona cualquier cosa del dispositivo y Hacer una foto abre la cámara, que es la forma rápida de adjuntar una…
• Cerrar tu propio ticket Un servicio en un servidor cPanel muestra una sección cPanel en Uso una vez que la cuenta está activa, con las herramientas del día a día. Al elegir una se abre cPanel en una pestaña nueva, con la sesión iniciada y en esa herramienta, sin contraseña que…
• Archivos en un ticket Los adjuntos aparecen bajo el mensaje con el que llegaron y se descargan con un toque. Servir archivos desde el disco es lo más peligroso que hace este módulo, así que las reglas son estrictas: el enlace nombra el archivo en lugar de que quien llama haga…
• Abrir cPanel Un servicio en un servidor cPanel muestra una sección cPanel en Uso una vez que la cuenta está activa, con las herramientas del día a día: File Manager, Email Accounts, Databases, phpMyAdmin, Backups y más. Al elegir una se abre cPanel en una pestaña nueva, con la sesión iniciada…
• Imprimir una factura La app genera su propia copia imprimible en lugar de descargar el PDF de WHMCS, porque ese PDF se sirve tras una sesión del área de clientes que la app no tiene, y pedir a alguien que inicie sesión dos veces para ver su propia factura…
• Activar y desactivar secciones Una sección desactivada desaparece de la navegación de la app y sus endpoints de la API empiezan a rechazar las peticiones. Ambas cosas ocurren a la vez, así que ocultar una pantalla retiene de verdad los datos en lugar de solo ocultar el botón.
• Lo primero que ven los clientes Un servicio en un servidor cPanel muestra un botón Abrir cPanel en Uso una vez que la cuenta está activa. Te lleva directamente a cPanel con la sesión iniciada en una pestaña nueva, sin contraseña que escribir, y llegas a la página de inicio de cPanel, donde File…

Guías 7

• Guía: llevar a los clientes a la app El anuncio, la instalación y qué hacer con los iPhone.Unos 30 minutos.Define la dirección de la app Apunta un subdominio como app.yourhosting.com a la app y úsalo en todas partes. Una dirección corta marca la diferencia entre que la gente la escriba y que la gente…
• Guía: gestionar un ticket de principio a fin desde el móvil Lo que envía un cliente, lo que ve el personal y cómo se comportan las respuestas sin conexión.Unos 10 minutos.Activa los tickets Los clientes ven una lista de sus tickets y pueden abrir otros nuevos en cualquier departamento que hayas configurado en WHMCS.Un cliente abre un ticket…
• Guía: de la factura al pago en el móvil Cómo una notificación se convierte en una factura pagada.Unos 10 minutos.Se emite la factura WHMCS crea la factura como siempre. La app se engancha a ese evento y avisa al cliente, con el importe y la fecha de vencimiento en el cuerpo de la notificación.Toca la notificación…
• Guía: lanzar la app por primera vez Desde una instalación nueva hasta un cliente tocando tu app en su pantalla de inicio.Unos 15 minutos.Ejecuta la configuración El asistente comprueba HTTPS, las extensiones de PHP y tu versión de WHMCS antes que nada, para que descubras un impedimento ahora y no…
• Guía: poner el código de instalación donde se escanee Desde el código generado hasta clientes con la app en su pantalla de inicio.Unos 30 minutos.Fija la dirección de la app antes de imprimir nada El código contiene la dirección que esté definida aquí. Imprímelo, cambia luego la dirección, y todos los códigos impresos apuntan…
• Guía: activar las llaves de acceso sin una avalancha de consultas Actívalas, comprueba que funcionan en tu propio dispositivo y luego deja que la gente las descubra.Unos 20 minutos, y después una semana de observación.Decide primero el dominio Antes de que nadie se registre, fija el dominio al que se vinculan las llaves de acceso. Si la app puede trasladarse a app.yourhosting.com…
• Guía: cuando algo no funciona Las comprobaciones que resuelven la mayoría de los avisos, en el orden en que conviene probarlas.Unos 5 minutos.Mira primero el panel de estado Informa de HTTPS, las extensiones de PHP, la cuenta de administrador de la API y las claves de notificación. La mayoría de los problemas se deben a que una de esas cuatro no está configurada.Nadie puede…

Instalación 2

• Poner el código delante de la gente El panel del área de clientes hace el trabajo automáticamente: quien ha iniciado sesión en un ordenador ve el código, y quien está en un móvil ve en su lugar un botón de instalación, porque un móvil no puede escanearse a sí mismo. Aparte de eso, los dos sitios que de verdad convierten…
• El código de instalación Un código QR que contiene la dirección de tu app, generado por el módulo y no por un servicio externo, para que ninguna empresa ajena conozca el tráfico de tus clientes. Siempre refleja la dirección de la app de la pantalla Marca. Imprímelo en las facturas, muéstralo…

Notificaciones 4

• Claves de notificación Las claves VAPID identifican tu servidor ante los servicios push de Apple, Google y Mozilla. Genéralas una sola vez. Regenerarlas invalida todas las suscripciones existentes, así que todo el mundo tiene que volver a activar las notificaciones.
• Notificaciones en iPhone iOS solo entrega notificaciones web después de añadir la app a la pantalla de inicio, y la solicitud de permiso tiene que venir de un toque. Por eso la app pregunta en la pantalla de Notificaciones y no en la primera carga…
• Avisar al personal de los tickets Con las notificaciones activadas, el personal también puede recibir avisos de los tickets: cuando se abre uno nuevo y cuando un cliente responde a uno existente. Una respuesta en un ticket asignado a un miembro concreto del personal le llega a…
• Qué genera una notificación Factura creada, pago recibido, pago fallido y una respuesta del personal en un ticket. Cada una es un hook de WHMCS distinto, así que puedes desactivar una sin tocar las demás.

Sin conexión 1

• Qué funciona sin cobertura Las últimas pantallas que alguien cargó siguen siendo legibles, y una respuesta a un ticket escrita sin conexión se pone en cola y se envía en cuanto vuelve la conexión. Los pagos siempre necesitan conexión.

Llaves de acceso 6

• Bloquear la app Se puede configurar un dispositivo para que bloquee la app cuando pasa a segundo plano, de modo que al volver a abrirla haga falta la huella. La forma obvia de hacerlo es un aviso delante de la sesión existente, pero sería puro teatro:…
• Exigir huella, cara o PIN Con esto activado, el dispositivo debe confirmar quién lo tiene antes de firmar, así que un móvil que alguien ha cogido desbloqueado no basta por sí solo. Desactivado, basta con la presencia: un toque en la llave de…
• Cuentas del personal con autenticación en dos pasos WHMCS no publica ninguna forma admitida de verificar el segundo factor de un miembro del personal fuera de su propio formulario de inicio de sesión. Comprobar solo la contraseña convertiría esta app en la forma fácil de saltarse un control que activaste a propósito, así que las cuentas con autenticación en dos pasos no pueden…
• El dominio al que se vinculan las llaves de acceso Una llave de acceso está ligada a un dominio y sus subdominios, y ese vínculo es lo que hace imposible el phishing. En blanco significa que el módulo lo deduce de la dirección de tu app. Fíjalo a propósito si puede que traslades la app más adelante:…
• Qué es una llave de acceso Un par de claves que el móvil o el portátil crea y guarda tras su propia pantalla de bloqueo. Iniciar sesión significa que el dispositivo firma un desafío de un solo uso con la mitad privada, que nunca sale de él ni viaja por la red. No hay…
• Cuando alguien pierde el dispositivo Su contraseña sigue funcionando, así que nadie se queda fuera. Las llaves de acceso guardadas en el Llavero de iCloud o en el Gestor de contraseñas de Google también siguen a la persona a un dispositivo nuevo por sí solas. Si un dispositivo se ha perdido de verdad, inicia sesión con la contraseña,…

Seguridad 4

• Límite de peticiones Peticiones por minuto desde una misma dirección IP. Los intentos de inicio de sesión tienen un límite aparte y más estricto. Súbelo si se bloquea una oficina grande que sale por una sola dirección.
• Rotar la clave de firma Rotarla cierra la sesión de todo el mundo en la app, en todas partes y de inmediato. Úsalo si sospechas que se ha filtrado un token. Nadie pierde datos; simplemente vuelven a iniciar sesión.
• Sesiones y tokens Al iniciar sesión se devuelve un token de acceso de corta duración y un token de renovación de larga duración. Los tokens de renovación rotan en cada uso; si se vuelve a presentar uno antiguo, se revoca toda la sesión, y así se detecta un token robado.
• Por qué el inicio de sesión del personal necesita una comprobación WHMCS publica una llamada admitida para validar la contraseña de un cliente, pero ninguna para validar la de un miembro del personal, así que la app tiene que leer ella misma el hash guardado. El lugar donde se guarda ese hash cambió entre versiones de WHMCS: las instalaciones más antiguas lo guardan en…

Configuración inicial 5

• Cuenta de administrador de la API La app comprueba contraseñas y abre tickets llamando a WHMCS como este administrador. Elige una cuenta dedicada con solo los permisos que necesita la app, en lugar del usuario del día a día de una persona, para poder revocarla sin dejar a nadie fuera.
• Llevar la app a la pantalla de inicio Android y Chrome de escritorio muestran automáticamente un aviso de instalación en cuanto la app tiene un manifiesto, un icono de al menos 192px y un service worker. iOS no tiene aviso: la gente usa Compartir y luego Añadir a pantalla de inicio. La app detecta…
• Mostrar el detalle de los errores Normalmente, cuando una petición falla, la app muestra un mensaje breve y genérico, y el detalle real va al registro de actividad. Con esto activado, ese mensaje real y dónde ocurrió también se devuelven a la app. Está pensado…
• Verificar el certificado de cPanel Para abrir cPanel, la app inicia la sesión del cliente a través de la propia API del servidor cPanel mediante una conexión segura. El certificado de esa conexión se comprueba por defecto. Algunos servidores presentan en el puerto de su API un certificado autofirmado o que no coincide con el nombre del host, lo que hace…
• Por qué se exige HTTPS Los navegadores se niegan a instalar una app en la pantalla de inicio, registrar un service worker o entregar notificaciones por HTTP sin cifrar. Localhost es la única excepción, y por eso las pruebas funcionan antes que tu certificado.

Personal 19

• Actuar sobre un servicio o un dominio Desde la ficha de un cliente, cada servicio ofrece las acciones que corresponden a su estado: suspender uno activo, reactivar uno suspendido o ejecutar la creación/configuración de uno aún pendiente. Una suspensión pide un motivo, porque ese motivo es lo único…
• Añadir una nota interna La pantalla de un ticket tiene un cuadro de Nota interna para el personal, debajo del cuadro de respuesta. Lo que escribas ahí se guarda como nota del ticket en WHMCS: solo para el personal, y el cliente nunca recibe aviso. Sirve para ir comentando…
• Anular una factura Una factura impagada, en borrador o vencida se puede anular desde su propia pantalla, lo que hace que WHMCS deje de reclamar el pago. Se ofrece en el móvil porque es reversible: una factura anulada se puede restablecer como impagada desde la…
• Acciones rápidas del cliente La pantalla de un cliente incluye un conjunto de acciones para lo que el personal hace sin encender un ordenador. Añadir crédito pone saldo en la cuenta. Enviar restablecimiento de contraseña lanza el correo de restablecimiento de WHMCS, así que el cliente recibe el enlace habitual…
• Contactar con un cliente y actuar sobre su cuenta La pantalla de un cliente tiene botones de llamada, SMS y correo en la parte superior, y un botón WHMCS que abre su ficha completa en el área de administración. Los tres primeros son enlaces del dispositivo: pasan al marcador del móvil, a la app de mensajes…
• Controlar lo que pueden hacer los clientes Controlas lo que los clientes pueden ver y hacer en la app en dos niveles. Cuenta, Permisos de la app de clientes define los valores por defecto que hereda cada cliente: para cada cosa, como pagar facturas, abrir tickets o abrir cPanel, un interruptor decide si…
• Invitar a los clientes a la app Puedes enviar a los clientes por correo un enlace a la app con instrucciones para añadirla a su pantalla de inicio; inician sesión con la cuenta que ya tienen. Envíalo a uno desde su ficha de cliente con el botón Invitar, o a…
• Abrir un cliente Al tocar un cliente en cualquier parte de la app se abre una pantalla con lo que tiene, lo que debe y lo que está esperando: servicios con su estado, dominios con los días que faltan para su vencimiento, facturas con las impagadas primero y cualquier ticket abierto.…
• Excepciones para un cliente La pantalla de un cliente tiene Permisos de la app, donde se pueden cambiar los valores por defecto solo para ese cliente. Cada permiso ofrece tres opciones: Por defecto sigue el ajuste global, Activado lo pone a disposición de este cliente sea cual sea el valor por defecto, y Desactivado lo retira…
• Publicar una incidencia de red Un servicio en un servidor cPanel muestra las herramientas de cPanel en Uso una vez que la cuenta está activa, además de un botón Abrir cPanel. Al elegir una herramienta, el cliente inicia sesión y, si el servidor lo permite, llega directamente a la…
• Leer el panel El panel tiene tres páginas: ingresos, pedidos y soporte. Desliza entre ellas o toca los nombres de encima, que es la forma más rápida de llegar a la tercera. Los ingresos cuentan el dinero realmente recibido, que no es lo mismo que el dinero facturado:…
• Actividad reciente Actividad reciente, enlazada desde el panel, es un único flujo de lo que acaba de pasar en todo el negocio: pedidos nuevos, pagos recibidos, tickets abiertos y cancelaciones solicitadas, lo más reciente primero, durante el último mes. Los contadores del panel te dicen cuánto…
• Registrar un pago recibido Para el dinero que llegó fuera de la app: una transferencia, efectivo, un cheque. La app pasa el pago a WHMCS mediante su propia llamada AddInvoicePayment en lugar de escribir en el libro de cuentas por su cuenta, así que es WHMCS quien decide si la factura ya está…
• Respuestas guardadas en el móvil Las respuestas predefinidas ya configuradas en WHMCS, en Soporte, aparecen en la app agrupadas por categoría, y al tocar una se añade a lo que ya haya en el cuadro de respuesta en lugar de sustituirlo. Esta es la función que decide…
• Mantener la sesión iniciada El inicio de sesión del personal tiene una casilla Mantener la sesión iniciada en este dispositivo. Déjala marcada y la sesión se mantiene entre visitas con normalidad. Desmárcala y la sesión solo dura hasta que la app se cierra del todo, lo que conviene a un…
• Evitar que un pago se registre dos veces Pon la referencia bancaria o el número de recibo en el campo Referencia. La app rechaza un segundo pago con una referencia ya registrada en esa factura, que es lo que te salva cuando un móvil pierde la señal a mitad del envío y vuelves a tocar.…
• El cuadro de búsqueda El panel tiene un cuadro de búsqueda que busca a la vez en clientes, facturas, tickets y dominios, para que puedas encontrar a un cliente que está al teléfono sin saber en qué lista está. Escribe un nombre, una empresa, un correo o un número de teléfono…
• Clasificar un ticket Un ticket abierto en la cola muestra un panel de Clasificación para el personal, debajo de su estado. Desde ahí se pueden cambiar su estado, su prioridad, su departamento y el miembro del personal al que está asignado, y cada cambio surte efecto en cuanto se…
• Gestionar un pedido Al tocar un pedido pendiente se abre con las mismas acciones que ofrece la app oficial, salvo una: aceptar, cancelar, cancelar y reembolsar, marcar como fraude y volver a pendiente. Cada una pasa por la API documentada de pedidos de WHMCS, así que hace exactamente…

Hub de soporte 4

• Abrir el hub desde Ajustes El personal accede al hub desde Ajustes en la pantalla Tú, donde Abrir Keen2Support inicia tu sesión en tu propio servicio de soporte con tu nombre y tu correo, para que no se te vuelvan a pedir. Es un enlace, en lugar de…
• El feed de ayuda que lee el hub El hub no recibe la ayuda de este módulo; la recoge. Una vez por hora lee un feed que sirve este módulo y guarda en caché los artículos, para que un agente de soporte que gestiona un ticket pueda buscarlos y pegar una respuesta…
• Qué hace conectarse a Keen2Support Keen2Support es tu propio servicio de soporte, independiente, con los creadores de esta app. Al conectarte, esta app se registra en el hub con una clave de producto obtenida de allí, y la app recibe un token de sitio que usa en cada…
• Qué telemetría se envía y cuál no La telemetría está desactivada hasta que la activas. Cuando está activada, los eventos que esta app ya registra en su propio registro de actividad se replican en el hub: cosas como un inicio de sesión, un pago registrado o una notificación push enviada. Antes de que nada salga del…

Herramientas 2

• Comprobar que el servidor puede enviar notificaciones Ejecuta «php modules/addons/whmcspwa/tools/selftest.php» en el servidor. Firma un token, firma una solicitud VAPID y cifra y descifra una carga push real, sin tocar tu base de datos. Deberían superarse dieciocho comprobaciones. Si fallan las de push, al servidor le falta la…
• Números de versión y actualizaciones La versión de version.php es la única respuesta válida; la pantalla Vista general, la API y la app la leen de ahí. Tres archivos que el navegador carga directamente llevan una copia para que su caché se vacíe al actualizar. «php tools/version.php –check»…

Tu cuenta 8

• Cambiar un ajuste del dominio La pantalla de un dominio tiene una sección Ajustes con tres interruptores que puedes cambiar tú mismo: renovación automática, privacidad WHOIS y bloqueo de transferencia. Cada uno muestra su estado actual y cambia al tocarlo, y el cambio va directamente a tu cuenta con el proveedor. Con la renovación automática activada…
• Cambiar tu contraseña Cuenta, Cambiar contraseña te pide tu contraseña actual y luego una nueva. Primero se comprueba la actual, para que alguien que coja un móvil desbloqueado no pueda cambiarla sin que se note. La nueva contraseña debe tener al menos ocho…
• Editar tus datos Cuenta, Tus datos, Editar tus datos te permite cambiar tu información de contacto: nombre, empresa, correo, teléfono y dirección. Al guardar, los cambios van directamente a tu cuenta con el proveedor, igual que si los editaras en su web, así que las facturas y…
• Contraseña olvidada En la pantalla de inicio de sesión, He olvidado mi contraseña pide una dirección de correo y solicita al proveedor que envíe ahí un enlace de restablecimiento. El enlace y la página de restablecimiento son del propio sistema del proveedor, exactamente igual que en la web, así que la app…
• Nombre de usuario olvidado Los clientes inician sesión con su dirección de correo, así que no hay un nombre de usuario aparte que olvidar. He olvidado mi nombre de usuario, en la pantalla de inicio de sesión, lo explica y, si el correo introducido pertenece a una cuenta, le envía un breve recordatorio. Igual que con…
• Pagarlo todo de una vez Cuando hay más de una factura pendiente, la pantalla de inicio ofrece un único botón Pagar todo con el total combinado, junto a un enlace para ver las facturas por separado. Pagar todo abre la página de pago múltiple del proveedor, que liquida todas las facturas impagadas…
• Dispositivos con sesión iniciada Cuenta, Dispositivos con sesión iniciada lista todos los sitios donde tu cuenta tiene la sesión iniciada, con el dispositivo, su dirección y cuándo se usó por última vez, y marca el que estás usando. Cerrar la sesión de un dispositivo que no reconoces termina su sesión…
• Tus notificaciones Cuando las notificaciones están activadas y las has permitido en un dispositivo, lo que se te comunica (una factura nueva, un pago que se completa, una respuesta a un ticket) también se guarda en la app, en…