Aquiles

Guía de Aquiles

Preguntas frecuentes

Cómo comprar e instalar Aquiles en WordPress o en tu servidor. Si algo no está claro, ábrelo abajo o pregunta en el chat.

De la compra a tu sitio, en orden

  1. 1

    Compra o demo

    Crea tu cuenta en aquiles-app.com. La demo de 15 días es el panel en esta web (sin tarjeta). Para poner el chat en TU página hay que pagar el plan ($99.99 USD/mes o $959.90 USD/año (20% dto vs 12 meses)). El setup ($50.00 USD) es opcional: lo pagas solo si quieres que lo instalemos.

  2. 2

    Descarga el plugin o el ZIP

    En Mi cuenta descarga el plugin de WordPress (cPanel / hosting web) o el ZIP Docker (VPS o servidor propio) y copia tu clave SAAS-XXXX.

  3. 3

    Instálalo en tu sitio o servidor

    WordPress: Plugins → Subir el ZIP → activar → pegar la clave SAAS y tu API Key de OpenAI. En Ajustes → Correo configura SMTP del hosting y envía una prueba. Catálogo y leads se quedan en tu MySQL. VPS: INSTALAR.bat o ./install.sh. aquiles-app.com solo valida la licencia; no guarda tu catálogo.

  4. 4

    Configura tu negocio

    En el plugin: Aquiles → Catálogo y Conocimiento. En Ajustes pega OpenAI y SMTP (correo de prueba). En Docker: panel del servidor, Copiloto y Ajustes. Si vendes en Shopify, conecta la tienda en Catálogo para leer precio y stock. El chat en TU web vende TU negocio. Los datos no se envían a aquiles-app.com.

Qué es Aquiles

¿Qué es Aquiles?
Aquiles es un agente comercial autónomo que instalas en tu WordPress o en tu servidor. Atiende a tus clientes 24/7: lee tus documentos, responde con tus precios y califica prospectos. En hosting WordPress/cPanel usas el plugin (sin VPS). Catálogo, leads y documentos se quedan en tu MySQL. aquiles-app.com solo valida la licencia. Si tienes VPS, el ZIP Docker incluye el panel completo (CRM, cotizaciones, citas, copiloto).
¿Qué incluye la aplicación?
El panel comercial de Aquiles incluye: • Chat público (widget) para tu sitio web, con transferencia a WhatsApp. • CRM de prospectos (leads) capturados por el agente. • Cotizaciones (CPQ) con PDF y reglas de aprobación. • Agenda de citas con confirmación por correo. • Copiloto interno para tu equipo de ventas (RAG sobre tus documentos). • Catálogo de productos y servicios. • Equipo y permisos (invitar personal). • Ajustes: marca, correos SMTP, idioma, widget para incrustar, política de descuentos. Tú pones tu propia clave de OpenAI (BYOK). Aquiles no guarda tu cartera en aquiles-app.com: el CRM corre donde lo instalas.
¿En qué se diferencia de un chatbot normal?
Un chatbot típico improvisa y se inventa precios. Aquiles cotiza solo con tu catálogo y documentos, puede dejar una cotización pendiente si el descuento o el monto superan lo que tú autorizaste, y pasa a un humano por WhatsApp cuando hace falta. También captura el lead (nombre, correo, empresa) y te deja el historial en tu CRM.
¿Dónde quedan mis datos?
En tu WordPress (MySQL) si usas el plugin, o en tu servidor Docker (SQLite) si instalas el ZIP. Prospectos, documentos, catálogo y la API Key de OpenAI no se envían a aquiles-app.com. aquiles-app.com solo gestiona pago, licencia SAAS y descargas.
¿Esta guía aparece en la página web de mi empresa?
No. Estas preguntas frecuentes y el chat de instalación existen solo en aquiles-app.com (y en Mi cuenta, para quien compra el paquete). En el sitio de cada empresa va el widget de ESE negocio: habla de sus productos, precios y documentos. No explica cómo instalar Aquiles ni cotiza el software.

Prueba, compra y licencia

¿Cómo funciona la demo de 15 días?
Regístrate en aquiles-app.com y entras al panel de demostración durante 15 días, sin tarjeta. Sirve para ver cómo se ve el producto. La demo no instala el chat en tu página ni entrega el plugin, el ZIP Docker ni una clave SAAS de producción. Para eso hay que comprar el paquete e instalarlo en tu WordPress o en tu servidor.
¿Qué recibo cuando pago?
El plan es $99.99 USD al mes, o $959.90 USD/año (20% dto vs 12 meses). El pago único de instalación ($50.00 USD) es opcional: lo eliges en el checkout si quieres que lo instalemos; si no, lo instalas tú con la guía. Después del pago, en Mi cuenta aparece: 1. El plugin de WordPress (instalación estándar, sin VPS). 2. El ZIP Docker (opcional, si tienes servidor propio). 3. Tu clave de licencia (formato SAAS-XXXX-XXXX-XXXX). 4. Facturación (cambiar tarjeta o ver facturas). Pagas con tarjeta en Stripe.
¿Para qué sirve la clave SAAS?
Activa el plugin o el instalador Docker. En WordPress: Aquiles → Ajustes. En Docker: el instalador o /activation. Sin licencia pagada el chat no responde. aquiles-app.com solo comprueba esa clave; no recibe tu catálogo. No la compartas.
¿Me dan factura CFDI?
Stripe emite el comprobante de pago al cobrar. Una factura fiscal mexicana (CFDI) no se genera sola. Si la necesitas, escribe a soporte@aquiles-app.com con tu razón social, RFC y domicilio fiscal. El emisor es PUERTAS Y BARRERAS INTELIGENTES, S.A. DE C.V., RFC PBI130529NY0.

Instalación

¿Lo instalo yo o pagan la instalación?
Puedes elegir en el checkout. Lo instalas tú: pagas solo el plan ($99.99 USD/mes o $959.90 USD/año (20% dto vs 12 meses)). En Mi cuenta bajas el plugin o el ZIP y sigues esta guía. Que lo instalemos: sumas $50.00 USD una vez. Te contactamos para dejarlo funcionando en tu WordPress o servidor. En ambos casos recibes plugin, ZIP Docker y clave SAAS.
¿Dónde se instala Aquiles?
En el sitio o servidor de la empresa, no en aquiles-app.com. Camino estándar (WordPress / cPanel): plugin de WordPress. No necesitas VPS ni Docker. Catálogo, leads y documentos se quedan en el MySQL de tu WordPress. aquiles-app.com solo confirma que la clave SAAS está pagada. Camino opcional (VPS / Windows / Linux con Docker): ZIP On-Premise con INSTALAR.bat o ./install.sh, para el panel completo. No hace falta GitHub ni Vercel.
¿Cómo se instala en WordPress o cPanel?
1. En Mi cuenta descarga el plugin WordPress y copia tu clave SAAS. 2. WordPress → Plugins → Añadir nuevo → Subir el ZIP → Activar Aquiles Chat. 3. Aquiles → Ajustes: pega la clave y tu API Key de OpenAI (empieza con sk-). Sin OpenAI el chat no responde. 4. Ajustes → Correo: SMTP de tu hosting (buzón del dominio). Guarda y pulsa Enviar correo de prueba. Sin SMTP el chat sí funciona; no salen avisos. 5. Carga catálogo y conocimiento. El chat aparece en tu sitio. 6. Los leads quedan en Aquiles → Leads, en tu WordPress. No subas el plugin a public_html a mano: úsalo como plugin. No necesitas Terminal ni Docker.
¿Cuáles son los pasos en un VPS o servidor con Docker?
Solo si no usas el plugin de WordPress. 1. En Mi cuenta descarga el ZIP Docker y copia la clave SAAS. 2. Súbelo al servidor y descomprímelo. 3. Windows: INSTALAR.bat. Linux: chmod +x install.sh && ./install.sh 4. Empresa, correo admin, contraseña, URL de ese servidor y clave SAAS. 5. Entra al panel, pega OpenAI y carga tu catálogo. Ejemplos de URL: http://IP:3000 o https://aquiles.tuempresa.com.
¿Cómo se instala en un servidor Windows normal?
Esa es la ruta más común si la empresa ya tiene un servidor o un PC de oficina con Windows. 1. En esa máquina (no en tu laptop), descomprime el ZIP. 2. Doble clic en INSTALAR.bat. Acepta administrador si Windows lo pide. 3. Si no hay Docker Desktop, el instalador lo descarga e instala. Suele pedir WSL2 y un reinicio: reinicia, vuelve a ejecutar INSTALAR.bat sobre la misma carpeta. 4. Completa empresa, correo admin, contraseña, URL de esa máquina y clave SAAS. 5. Deja el equipo encendido. El chat de la página web de la empresa apunta a este servidor. Si solo quieres probar en tu propia PC, usa http://localhost:3000; para clientes reales usa la IP o el nombre del servidor de la oficina.
¿Funciona con cualquier hosting?
Si el sitio es WordPress (la mayoría de cPanel), sí: instalas el plugin. No hace falta VPS. Si no es WordPress y quieres el panel completo, necesitas un servidor donde corra Docker (Windows de oficina, VPS o nube). Tus datos del negocio no se guardan en aquiles-app.com.
¿Cómo se instala en Linux, VPS o hosting con SSH?
Sube el ZIP (SCP, SFTP o el panel del hosting), descomprime y: chmod +x install.sh ./install.sh Si no hay Docker, el script puede instalarlo. Cierra sesión, vuelve a entrar y ejecuta ./install.sh otra vez. Si el sitio es público, usa un dominio con HTTPS (hay un nginx.example.conf en el paquete) y pon esa URL en APP_URL.
¿Docker viene dentro del ZIP?
No. Docker es lo que corre Aquiles en el servidor. Meterlo en el ZIP haría la descarga enorme. En Windows, INSTALAR.bat puede instalar Docker Desktop (oficial, unos 500 MB la primera vez). En Linux, install.sh puede instalarlo con get.docker.com. Si el equipo no tiene internet, en Windows puedes poner DockerDesktopInstaller.exe en la carpeta instaladores\ del ZIP descomprimido.
¿El servidor necesita internet?
Sí, al menos para instalar Docker/la imagen la primera vez y para que el agente hable con OpenAI (tu API Key). Los datos del CRM se quedan en el servidor. Si configuras SMTP, también salen correos hacia tus clientes.

Después de instalar

¿Qué hago en el primer acceso?
WordPress: Aquiles → Ajustes (clave SAAS + OpenAI) → Correo SMTP y prueba de envío → Catálogo → Conocimiento. El chat ya está en tu sitio. Leads en Aquiles → Leads. Docker: entra al panel de TU SERVIDOR, pega OpenAI en Copiloto, carga catálogo y documentos. Si tu tienda es Shopify, en Catálogo pega el dominio myshopify.com y el token de la app.
¿Por qué pido una API Key de OpenAI?
Es BYOK (Bring Your Own Key): cada negocio usa su propia cuenta de OpenAI. Así el consumo lo controlas tú y las conversaciones no pasan por una llave compartida de Aquiles. Crea la clave en platform.openai.com (empieza con sk-) y pégala en WordPress: Aquiles → Ajustes. En Docker: Copiloto o Configuración. Sin ella el chat no responde. El cobro de tokens es de OpenAI, no de Aquiles. No la pongas en el código de tu tienda: el widget habla con tu WordPress o servidor.
¿Cómo pongo el chat en mi página?
Con el plugin de WordPress el chat aparece solo al activarlo. No hay que pegar código. Si usas Docker u otra web (Shopify, HTML): Dashboard → Ajustes → Instalar en tu sitio web y copia el script. Ese chat vende TU negocio; no explica cómo instalar Aquiles.
¿Cómo lee Aquiles el inventario de Shopify?
En el panel Docker: Ajustes → Catálogo → Leer catálogo de Shopify. 1. En Shopify crea una app (Ajustes → Apps → Desarrollar apps). 2. Activa read_products y read_inventory, instálala y copia el Admin API access token (empieza con shpat_). 3. Pega tu-tienda.myshopify.com y el token. Aquiles importa productos, precios y stock al guardar, y los refresca cuando alguien pregunta en el chat. El plugin de WordPress ya lee WooCommerce en vivo. Shopify no corre dentro de WordPress: usa el ZIP Docker y el widget en theme.liquid.
¿Cómo se envían correos a mis clientes?
En el plugin WordPress: Aquiles → Ajustes → Correo. Los avisos salen del buzón de TU dominio, no de aquiles-app.com. En cPanel crea ventas@tudominio.com. Servidor: Outgoing Server (serverXXX.web-hosting.com), no mail.tudominio.com. Puerto 465 con SSL o 587 sin la casilla. Usuario = el correo completo. Guarda y pulsa Enviar correo de prueba. Sin SMTP el chat sí funciona; solo no llegan leads, citas ni cotizaciones por correo. En Docker: Ajustes → Notificaciones. No mezcles un correo de cPanel con smtp-mail.outlook.com.

El panel día a día

¿Qué hace cada sección del panel?
• Métricas: volumen de conversaciones y prospectos. • CRM: fichas de leads que capturó el chat. • Citas: agenda nativa (lista), confirmación y recordatorios. • Cotizaciones: PDF, estados y aprobación si el monto o el descuento lo requieren. • Personal: usuarios y permisos de cada área. • Copiloto: asistente interno para tu equipo, con tus documentos. • Configuración: marca, catálogo, correos, widget, descuentos, idioma y licencia.
¿El chat ofrece descuentos solo?
No, salvo que tú lo actives. En Configuración → CPQ puedes permitir descuentos y fijar el porcentaje máximo autorizado. Si está apagado, el agente cotiza a precio de lista y no pide descuento. Si el cliente pide más del porcentaje autorizado, la cotización queda pendiente de gerencia.

Problemas frecuentes

El instalador se detiene en Docker o pide reiniciar
Es normal la primera vez. En un servidor Windows: abre Docker Desktop y espera el icono en verde. Si Windows pidió reinicio por WSL2, reinicia esa máquina y vuelve a ejecutar INSTALAR.bat en la misma carpeta del ZIP. En Linux/VPS: cierra la sesión SSH, vuelve a entrar (grupo docker) y ejecuta ./install.sh otra vez. Comprueba con sudo docker info.
El puerto 3000 está ocupado
En el instalador elige otro puerto (por ejemplo 8080) o edita HOST_PORT en el archivo .env y ejecuta docker compose up -d.
El chat no responde
Casi siempre falta la API Key de OpenAI en Aquiles → Ajustes (plugin) o en Copiloto (Docker), o la licencia no está activa. En WordPress el panel de inicio avisa si falta. En Docker revisa /activation con tu SAAS y docker compose logs -f aquiles-app.
Olvidé la contraseña del admin
En Iniciar sesión pulsa «¿Olvidaste tu contraseña?». Te llega un correo con un enlace (2 horas). Si la cuenta es solo de Google, entra con Gmail. En Docker, si el instalador la generó: docker compose logs aquiles-app o /data/admin-credentials.txt. Si el servidor no tiene correo configurado, escribe a soporte@aquiles-app.com.
¿Dónde pido ayuda?
Escríbenos a soporte@aquiles-app.com (licencia, pago, ZIP). En esta misma web abre Preguntas frecuentes o el widget de chat: Aquiles puede guiarte por los pasos. Comandos útiles en el servidor: docker compose logs -f aquiles-app docker compose down docker compose up -d

El widget de Aquiles también explica estos pasos. Ir a Mi cuenta