IPFlow Docs
Primeros Pasos

[Básico] 1 · Instalación y Primer Acceso

Cómo completar el Setup Wizard y configurar las credenciales base de tu entorno IPFlow.

Instalación y Primer Acceso

Una vez que la infraestructura de IPFlow esté desplegada en tu servidor (o si un integrador te ha entregado tu instancia lista), el primer paso es acceder al sistema y configurarlo.

Por seguridad, las cuentas de administrador no vienen pre-creadas "por defecto" con contraseñas inseguras. Tienes que realizar el proceso de configuración inicial conocido como el Setup Wizard.


1. Completar el Setup Wizard

  1. Abre tu navegador y dirígete a la URL de tu instalación (ej: https://app.tuempresa.com).
  2. Si es la primera vez que arranca el sistema, IPFlow detectará que no hay ningún administrador y te redirigirá automáticamente a la pantalla de Setup (/setup).
  3. Verás un formulario solicitando tus datos para crear la cuenta maestra:
    • Nombre completo
    • Correo electrónico (este será tu usuario de administrador)
    • Contraseña (asegúrate de que sea una contraseña fuerte)
  4. Haz clic en el botón de confirmación.
Proceso Seguro

Una vez completado el Setup, IPFlow bloqueará esta pantalla permanentemente. Nadie más podrá acceder a /setup para intentar crear otro administrador. Si necesitas agregar más miembros a tu equipo, lo harás desde el Panel de Equipo una vez dentro.


2. Configurar las Claves de IA

Después de crear tu cuenta, entrarás al Dashboard de IPFlow. Notarás que el sistema te indicará que necesitas configurar tus proveedores de Inteligencia Artificial antes de poder crear un agente.

  1. En el menú lateral izquierdo, ve a Configuración del Sistema (el ícono de engranaje).
  2. Busca la sección de Configuración de IA.
  3. Pega tu OpenAI API Key o tu Anthropic API Key en los campos correspondientes. Puedes usar ambas si deseas darle a tus agentes la opción de elegir qué modelo usar.
  4. Presiona el botón de guardar.

IPFlow ahora tiene el "cerebro" habilitado para operar.


3. Configurar Chatwoot (El Motor de Mensajería)

Para que tus agentes puedan recibir mensajes de WhatsApp o Instagram, IPFlow necesita conectarse a tu instancia de Chatwoot.

  1. En la misma pantalla de Configuración del Sistema, baja hasta la sección de Chatwoot.
  2. Ingresa la URL de la API de Chatwoot (ej: https://chat.tuempresa.com).
  3. Ingresa el Access Token de Chatwoot (lo encuentras dentro de Chatwoot > Ajustes de Perfil > Access Token).
  4. Guarda los cambios.
Verificación de Conexión

No te preocupes si no estás seguro de haber pegado bien el Token. Cuando intentes conectar un canal en el siguiente paso, IPFlow te avisará si logra comunicarse exitosamente con Chatwoot o si hubo algún error.


Checklist de Setup — Confirma que todo está listo

Antes de pasar al siguiente paso, verificá que completaste cada punto:

  • Completaste el Setup Wizard en /setup y creaste tu cuenta de administrador.
  • Guardaste tu OpenAI API Key o Anthropic API Key en Configuración del Sistema > IA.
  • Conectaste Chatwoot: pegaste la URL y el Access Token en Configuración del Sistema > Chatwoot.
  • Hiciste una prueba de envío desde Chatwoot para confirmar que los mensajes entran correctamente.
¿No podés continuar?
Si el token de Chatwoot no funciona, verificá que el usuario tenga permisos de administrador en Chatwoot. Solo los administradores pueden generar Access Tokens válidos.

➡️ Siguiente paso: 2 · Crea tu primer Agente.