Primeros pasos

Qué es ChatISP

ChatISP es la central de atención por WhatsApp creada por Ravi Systems para proveedores de internet. Reúne en un único panel web los números de WhatsApp del proveedor, el equipo de atención, la inteligencia artificial y la información del suscriptor: quién está hablando, cómo está su conexión y cómo está su situación financiera.

Lo que diferencia a ChatISP de una atención por WhatsApp genérica es que conoce la operación de un proveedor:

• Red del suscriptor, a través de Ravicor: con Ravicor (la gestión de red de Ravi Systems, contratada por separado) emparejado, el agente y la IA ven durante la conversación la situación real de la conexión del cliente (sesión, señal de la fibra, router, Wi-Fi) y pueden ejecutar acciones de diagnóstico. Vea Integraciones.
• Registro y finanzas, a través del ERP: ChatISP se conecta directamente a los ERP homologados (IXC Provedor, SGP, Hubsoft, Gesprov, ReceitaNet y Pipesoft) para reconocer al suscriptor por el teléfono, mostrar facturas pendientes y enviar segunda vía. Otros sistemas se integran por API genérica.
• IA que atiende de verdad: la asistente de inteligencia artificial recibe al cliente, consulta su situación, resuelve lo que puede (segunda vía, orientación de Wi-Fi, conexión) y transfiere al equipo cuando es necesario, con el motivo resumido. Vea Inteligencia artificial.
• Atención compartida: cola por departamento, distribución automática entre agentes, transferencia, conversación compartida, notas internas, mensajes rápidos, encuesta de satisfacción. Vea Atención.
• Todo lo que la operación necesita alrededor: órdenes de servicio internas, agenda del equipo, llamadas de voz y video por WhatsApp, automatización de envíos (incluida la regla de cobranza), flujos de autoatención, informes, auditoría, API pública y webhooks.

El panel es 100% web, funciona en computadora, tableta y celular, en los temas claro y oscuro, en portugués, inglés y español.

Cómo funciona

En líneas generales, el recorrido de un mensaje es este: el cliente escribe al WhatsApp del proveedor; el mensaje llega a ChatISP por el canal de ese número; el sistema identifica al suscriptor, registra la conversación y decide quién responde (flujo de autoatención, IA o cola humana); la respuesta vuelve al cliente por el mismo canal.

Las piezas, en lenguaje de operación

Las dos formas de uso

ChatISP es el mismo sistema en las dos formas de contratación. Lo que cambia es quién se encarga de la máquina.

A lo largo de esta documentación, lo que solo existe en la instalación propia está marcado con la etiqueta Instalación propia.

Requisitos del servidor Instalación propia

ChatISP se distribuye como una imagen de instalación propia, basada en Debian 13 (64 bits). La imagen instala el sistema operativo y todo lo demás: servidor web, base de datos, servicios de WhatsApp, transcripción de audio y voz. Usted no instala ningún paquete a mano.

Máquina

Máquina virtual: atención al tipo de CPU

La máquina virtual es el camino más común y funciona con normalidad. El cuidado es uno solo: el tipo de CPU de la VM debe transmitir las instrucciones modernas del procesador. En Proxmox y KVM, elija host (o x86-64-v2, si la VM necesita migrar entre nodos diferentes) en lugar del genérico kvm64.

Internet

• El servidor necesita salida a internet: por ella funcionan los números de WhatsApp, se valida la licencia ante la central de Ravi Systems, se envía la copia de seguridad diaria y llegan las actualizaciones.
• Al panel se accede por la IP de la instalación, ya en https con un certificado propio de la máquina (el navegador puede pedir una confirmación en el primer acceso). Un dominio con certificado reconocido (su propio dominio o un subdominio de chatisp.com.br, con Let's Encrypt) puede configurarse después en Servidor.
• Para usar la API oficial de Meta, tener el panel publicado en un dominio es el camino más simple. Vea Conexiones de WhatsApp.

Instalación con la imagen oficial Instalación propia

La instalación es la misma para servidor físico y máquina virtual: descargar la imagen, verificarla, grabarla, responder a las preguntas del instalador y esperar a que termine el primer arranque. No hay línea de comandos, salvo la verificación del archivo.

Paso a paso

1. Descargue la imagen en chatisp.com.br/baixar. La página muestra la ficha de la imagen (archivo, versión, tamaño y el código SHA-256). La descarga admite reanudación: puede pausarla y continuarla después. Descargar no inicia la prueba de 10 días.
2. Verifique el SHA-256 del archivo descargado y compárelo con el publicado en la ficha. Si son diferentes, descárguelo de nuevo: un archivo dañado suele fallar en medio de la instalación con mensajes que no ayudan.
   Linux macOS Windows

   sha256sum <archivo-descargado>.iso

   shasum -a 256 <archivo-descargado>.iso

   certutil -hashfile <archivo-descargado>.iso SHA256

3. Grabe y arranque: grabe la imagen en una memoria USB (máquina física) o monte la ISO como medio virtual en Proxmox, VMware o el hipervisor que utilice, y arranque desde ella. El menú de arranque funciona tanto en BIOS como en UEFI.
4. Responda a las preguntas del instalador: el instalador gráfico pregunta solo lo esencial, y el resto ya viene respondido dentro de la imagen:
   • Idioma: portugués de Brasil, inglés o español. El teclado, la configuración regional y la zona horaria acompañan la elección, y el panel ya nace en ese idioma.
   • Red: dirección IP, máscara, puerta de enlace y DNS, ingresados a mano.
   • Contraseña de root: la única cuenta del sistema operativo.
   • Confirmación del particionado: el instalador usa el disco indicado completo.
5. Deje que termine el primer arranque: al reiniciar, la máquina crea la base de datos, prepara los servicios, emite el certificado interno, activa el firewall y publica el panel. No es necesario hacer nada en esta etapa.
6. Abra el panel en el navegador, en https://IP-del-servidor. La primera pantalla es la creación del administrador (vea Primer acceso).

Después de instalar

• La zona horaria se define a partir del idioma elegido en el instalador (portugués: São Paulo; inglés: Nueva York; español: Ciudad de México). Para otra zona, ajústela en Configuración, pestaña Sistema, campo Zona horaria. Ella alinea los horarios de atención, los informes y la agenda.
• El acceso SSH al servidor está en el puerto 2202, con el usuario root.
• Una versión nueva de ChatISP se aplica en el servidor ya instalado: no es necesario descargar la imagen de nuevo. Vea Servidor.

Primer acceso

Mientras el sistema no tiene ningún usuario, cualquier dirección del panel lleva a la pantalla de bienvenida, Bienvenido a ChatISP, que crea el primer usuario. Muestra el recorrido de tres etapas (Instalar el servidor, Crear el administrador y Configurar la atención) y tiene selector de idioma y botón de tema claro y oscuro.

Crear el usuario administrador

1. Elija el idioma en el selector de la esquina de la pantalla. La página cambia al instante, y ese idioma pasa a ser el idioma del sistema.
2. Complete Nombre y Correo. El correo es su acceso al sistema y el canal de recuperación de contraseña.
3. Defina Contraseña y Confirmar contraseña. El medidor de seguridad acompaña la escritura, y la contraseña debe alcanzar el nivel Fuerte: al menos 8 caracteres, mezclando letras mayúsculas y minúsculas, números y símbolos (o una contraseña más larga). Las palabras obvias, las secuencias y los fragmentos de su nombre o correo reducen la seguridad de la contraseña.
4. Ingrese el WhatsApp (celular), con código de área: recibe los avisos de la atención.
5. Haga clic en Crear e ingresar. Todos los campos son obligatorios; el error aparece debajo del propio campo.

El usuario creado aquí queda en el perfil Administrador, con acceso total. Con él usted invita al equipo y define los perfiles de acceso después, en Usuarios y perfiles. El tema elegido en esta pantalla pasa a ser la preferencia de su cuenta. Al ingresar, el sistema abre el asistente de configuración.

Ingresar al sistema

El acceso a ChatISP se hace con Correo y Contraseña: no existe un "nombre de usuario" aparte.

• Mantener la sesión en este navegador: con la opción marcada, usted sigue conectado durante 30 días sin ingresar el correo y la contraseña de nuevo. No la marque en computadoras compartidas.
• Olvidé mi contraseña: el sistema envía un código al WhatsApp verificado y al correo de la cuenta; con el código, usted define la nueva contraseña.
• Si la cuenta tiene verificación en dos pasos, la pantalla Confirma tu identidad pide el código de la aplicación autenticadora. Vea Mi cuenta.
• Después de varios intentos fallidos, la pantalla avisa Demasiados intentos. Espere un momento e intente de nuevo.
• Un enlace del sistema abierto sin iniciar sesión (por ejemplo, el enlace de una OS) lleva a la pantalla de ingreso y, después de iniciar sesión, continúa a la página solicitada.

A dónde llega cada uno al ingresar

• Quien tiene el permiso Supervisar todas las conversaciones (Administrador y Supervisor, de forma predeterminada) llega a la pantalla Conversaciones, abierta en la Visión general de la atención.
• El agente sin ese permiso trabaja directamente en el Modo atención, la pantalla dedicada a la atención.
• En una instalación sin ningún número conectado y sin historial, la pantalla Conversaciones muestra Bienvenido a ChatISP con los accesos directos Conectar WhatsApp, Armar el equipo y Ajustar la atención.

La orientación completa por la pantalla está en Interfaz y navegación.

Asistente de configuración

Justo después de crear el administrador, ChatISP abre el Asistente de configuración: Vamos a dejar todo listo. En siete pasos la atención nace configurada (integración, horario, sectores, flujo, base de conocimiento, equipo y WhatsApp). Cada paso guarda de verdad, y todo puede ajustarse después en las pantallas del panel.

Los siete pasos

Navegación y reanudación

• Los botones Continuar y Volver se mueven entre los pasos, y Omitir este paso deja el elemento para después.
• Terminar después cierra el asistente y lleva al panel. El progreso queda guardado.
• Mientras el asistente no se concluya, el administrador ve en la parte superior del panel el botón de brújula Asistente de configuración, con un punto pulsante. Reabre el asistente en el paso donde usted se quedó, ya con lo que se guardó de verdad en las pantallas.
• Rehacer un paso actualiza lo que este creó (el mismo flujo, las mismas invitaciones), sin duplicar.

Prueba gratuita de 10 días Instalación propia

Toda instalación propia nace en Prueba gratuita: 10 días con todos los recursos habilitados, sin límite de agentes, números, flujos ni claves de API. No es una versión reducida: es ChatISP atendiendo a sus clientes de verdad.

• El conteo comienza con la instalación, no con la descarga.
• Durante la prueba, quien tiene el permiso Configuración ve en la parte superior del panel la franja de conteo (Su prueba expira en N días., después Su prueba expira MAÑANA. y ¡Su prueba expira HOY! Regístrese para continuar.) con el botón ¡Registrar ahora!. Los demás usuarios no ven la franja.
• Al terminar el plazo sin registro, el panel abre la pantalla Período de prueba finalizado para todos. Las conversaciones y la configuración siguen guardadas, y los mensajes que llegan se siguen registrando; la IA, la distribución de la cola y los envíos automáticos quedan en espera hasta que vuelva la licencia.

Licencia y registro

Cada instalación tiene un Token de la instalación: una clave única, creada en el primer uso, que nunca cambia. Identifica su servidor ante Ravi Systems en el registro del plan, en el soporte y en las copias de seguridad.

Dónde ver el token y el plan

En Configuración, pestaña Sistema, la tarjeta de registro de la instalación ("Clave única que identifica esta instalación ante Ravi Systems") muestra:

Registrar y activar un plan

1. Haga clic en ¡Registrar ahora! (en la franja superior durante la prueba, en la tarjeta de registro o en la pantalla de bloqueo). Se abre la página de registro en chatisp.com.br, que ya identifica su servidor por el token.
2. Elija el plan y la forma de pago y concluya el registro.
3. Vuelva a la tarjeta de registro en Configuración y haga clic en Actualizar: el servidor se sincroniza con la central en el momento y el nuevo plan entra en vigor. Sin ese clic, se aplica en la próxima sincronización automática, que ocurre cada 10 minutos.

Sincronización con la central

El servidor sincroniza la licencia con la central de Ravi Systems cada 10 minutos, por un canal cifrado. La validación tiene margen para caídas de internet:

• Después de 24 horas sin lograr sincronizar, quien administra ve la franja roja Sin comunicación con la central de Ravi Systems desde hace N h., con el botón Actualizar.
• Después de más de 3 días sin sincronizar, el panel abre la pantalla Sin comunicación con la central. La licencia vuelve sola en la próxima sincronización exitosa.

Pantalla de licencia bloqueada

Cuando la licencia no está habilitada, todas las pantallas llevan a la pantalla de licencia, que explica el motivo y qué hacer:

En todas ellas aparecen el token con Copiar, el enlace ¿Dudas sobre planes? Hable con Ravi Systems y Salir del sistema. Quien tiene el permiso Configuración ve también Sincronizar ahora, para verificar en el momento después de regularizar.

Planes y límites

El plan se define en la central de Ravi Systems y se sincroniza con su servidor. Los límites se aplican al momento de crear o reactivar cada recurso.

El plan anual equivale a 12 mensualidades con 35% de descuento. Los valores anteriores son los de la instalación propia vigentes en Brasil y publicados en chatisp.com.br/planos; ChatISP Cloud tiene una tabla propia, que ya incluye el alojamiento. La prueba gratuita equivale al plan más alto, sin límites.

Plan CUSTOM. Por encima de 18 agentes, Ravi Systems negocia un plan propio, caso por caso: el valor y la cantidad de agentes se definen en el registro de la licencia, y el resto de la tabla sigue sin límite, como en ENTERPRISE. El panel muestra el nombre CUSTOM en la tarjeta Registro Ravi y aplica el tope acordado en el medidor de agentes.

Cómo aparecen los límites en la pantalla

• Los números de WhatsApp cuentan por número: un mismo número conectado por QR y por la API oficial al mismo tiempo cuenta como uno solo.
• Las pantallas de agentes, conexiones, flujos y claves de API muestran un medidor en el encabezado, con el formato "X de Y de su plan". Al alcanzar el tope, el medidor cambia a Límite del plan alcanzado y el botón de crear desaparece.
• Si alguien intenta crear más allá del límite, el sistema muestra el mensaje de upgrade (por ejemplo, "Límite de agentes alcanzado: el plan BASIC permite 2. Haga upgrade del plan para continuar.") y no concluye el registro.
• Un recurso fuera del plan (como Automatización de envíos en el plan NORMAL) sigue visible en el menú, pero la pantalla se abre bloqueada con Recurso no incluido en su plan y el botón Ver planes.
• Sin la atención autónoma por IA en el plan, las conversaciones que irían a la IA se llevan a la cola humana, con la nota "Atención autónoma por IA no incluida en el plan: conversación llevada a la cola".
• Cambiar a un plan menor nunca borra nada: lo que ya existe sigue funcionando, solo no es posible crear más allá del nuevo límite.

Recurso del plan A lo largo de esta documentación, esta etiqueta marca los recursos que dependen del plan contratado.

Próximos pasos

Con el sistema instalado y el asistente concluido, esta es una buena hoja de ruta para poner en marcha la operación:

1. Conozca la pantalla: Interfaz y navegación.
2. Revise los números de WhatsApp: Conexiones de WhatsApp.
3. Revise sectores, horarios y el orden de la cola: Departamentos y Flujos.
4. Ajuste la asistente de IA y la base de conocimiento: Inteligencia artificial y Base de conocimiento.
5. Conecte Ravicor y el ERP, si todavía no lo hizo: Integraciones.
6. Arme el equipo y los perfiles de acceso: Usuarios y perfiles.
7. Registre etiquetas, mensajes rápidos y motivos de cierre: Registros.
8. Comience a atender: Atención y Ficha del cliente.