AnswerProAnswerPro

Integration Hub

Super Admin

Tu guía paso a paso para activar Agentes Élite en los negocios clientes

Esta página es tu manual de operaciones. Cada vez que un cliente activa un plan con Agente Élite, sigue los pasos de arriba hacia abajo. No necesitas saber programar — solo copiar, pegar y cambiar los datos del cliente.

El proceso completo — de cliente nuevo a agente funcionando

1

Verificar que el cliente tiene Organización creada

En ManageOrganizations, confirmar que el negocio está creado y tiene usuario vinculado con el plan correcto.

2

Crear el archivo del Agente (vía el desarrollador)

Configurar en AgentBuilder → copiar el JSON generado → enviarlo al desarrollador de Base44 para que cree agents/nombre_cliente.json. Los archivos de agentes no se pueden crear automáticamente desde el sistema.

3

Configurar en el AgentBuilder

Ir al Configurador Agente Élite → seleccionar la org del cliente → escribir el system prompt detallado → guardar.

4

Elegir cómo se integrará en la web del cliente

¿El cliente tiene web? → Chat Flotante. ¿Solo WhatsApp? → WhatsApp Gestionado (Ycloud). ¿Quiere ambos? → Ambos.

5

Entregar el código al desarrollador del cliente (o integrarlo tú)

Copiar el snippet correspondiente, cambiar AGENT_NAME por el nombre del agente, y enviárselo al dev del cliente.

6

Probar que funciona

En el AgentBuilder → pestaña 'Probar Agente' → hacer preguntas de prueba. Verificar que el agente responde correctamente.

Si el cliente no tiene estos requisitos, el agente NO funcionará correctamente. Verifica cada punto antes de continuar.
Organización creada

El negocio debe aparecer en ManageOrganizations con estado Activo.

📌 Cómo verificar: Ir a ManageOrganizations → verificar que existe → si no, crear con el botón 'Nueva Organización'.
Usuario del cliente vinculado a esa organización

El usuario del cliente debe tener el organization_id correcto en su perfil.

📌 Cómo verificar: En SuperAdmin → pestaña Usuarios → buscar el email del cliente → verificar que tiene organization_id asignado.
Plan activo con Agente Élite

Solo los planes Básico, Pro y Advance incluyen Agente Élite. El plan Free no.

📌 Cómo verificar: En SuperAdmin → Usuarios → verificar subscription_plan_id y subscription_status = 'active'.

¿Qué plan incluye qué tipo de agente?

PlanTipo de AgenteModelo IAMensajes/mes
Free❌ Sin Agente Élite—100
AnswerBásico1 Agente Élite BásicoGemini Flash500
AnswerPro2 Agentes Élite AvanzadosGPT-52,500
AnswerAdvanceHasta 5 Agentes ÉliteGemini Pro5,000
🚨 REGLA FUNDAMENTAL: El archivo agents/nombre_cliente.json DEBE existir en la app del cliente, no en tu app.

Si el cliente usa el widget flotante y ves el error "Agent 'nombre' not found", es porque el archivo NO está en su proyecto Base44.
⚠️ El proceso correcto:
  1. Tú (AuraTrends): Configuras el agente aquí en el Configurador Agente Élite → copias el JSON generado
  2. El cliente (o su dev): Crea el archivo agents/nombre_cliente.json en SU propia app de Base44 → Código → carpeta agents/
  3. El cliente: Publica su app → el widget flotante ya encuentra el agente

📍 Ubicación exacta donde crear el archivo:

App Base44 del cliente
        └─ Código
        └─ agents/
        └─ nombre_cliente.json  ← AQUÍ va el archivo
Este es el paso más crítico. Sin el archivo en la app del cliente, obtendrá el error "agent not found". El nombre del archivo (sin .json) es lo que se pone en AGENT_NAME en el código del widget.

Regla de nombres — MUY IMPORTANTE

Nombre del archivo:restaurante_miami.json
AGENT_NAME en el código:"restaurante_miami"← sin el .json
Buenas convenciones:farmacia_san_pedro · clinica_dental_dr_perez · tienda_ropa_luna

📋 Plantilla — Copiar y rellenar con los datos del cliente

json
{
  "name": "nombre_del_cliente",
  "description": "Agente IA para [Nombre del Negocio del Cliente]",
  "instructions": "Eres el asistente de [Nombre del Negocio]. Tu objetivo es ayudar a los clientes.

Información del negocio:
- Horario: Lunes a Viernes 8am-6pm
- Teléfono: [número de contacto]
- Dirección: [dirección del negocio]
- Servicios: [listar los servicios principales]
- Precios: [información de precios si aplica]

Regla importante: Si el cliente quiere comprar, agendar o tiene preguntas complejas, 
dile que lo contacten al WhatsApp: [número] o Email: [correo].

Responde siempre en español. Sé amable y conciso (máximo 3-4 oraciones por respuesta).",

  "tool_configs": [],

  "whatsapp_greeting": "¡Hola! Soy el asistente de [Nombre del Negocio] 👋 ¿En qué puedo ayudarte hoy?"
}

📌 Proceso paso a paso

1Ir al Configurador Agente Élite → seleccionar la organización del cliente
2Llenar nombre del agente (ej: farmacia_lopez), prompt del sistema con los datos del negocio, y seleccionar herramientas
3Hacer clic en 'Guardar' → el sistema guarda en base de datos y muestra el JSON generado
4Copiar ese JSON y abrír el chat de desarrollo de Base44 (donde está el asistente IA del código)
5Enviar el JSON con el mensaje: 'Crea el archivo agents/farmacia_lopez.json con este contenido'
6El desarrollador lo crea en segundos — el agente queda activo de inmediato
Tip: Entre más detalladas sean las instrucciones, mejor responderá el agente. Incluye horarios exactos, precios, políticas de devolución, nombres de productos, preguntas frecuentes, etc. Puedes actualizar el archivo en cualquier momento y los cambios aplican de inmediato.

Referencia rápida — ¿Qué hacer según la situación?

El cliente dice...Tú haces...Dificultad
Quiero el chat flotando en toda mi webPaso 1 + modalidad Chat FlotanteFácil
Quiero el chat en mi sección de ContactoPaso 1 + modalidad Chat IncrustadoFácil
Quiero una página entera solo para el chatPaso 1 + modalidad Página DedicadaFácil
Mi web es Wix/WordPress, no tengo devPaso 1 + modalidad Botón/Link HTMLMuy fácil
Solo quiero atender por WhatsAppPaso 1 + solicitar número en Canales (Ycloud gestionado)Muy fácil
Quiero web Y WhatsAppPaso 1 + cualquier modalidad web + WhatsApp Gestionado (Ycloud)Fácil
El agente dice cosas incorrectasEditar agents/nombre.json con más detalle y guardarFácil
El chat dice 'agent not found'Verificar que AGENT_NAME coincide exactamente con el nombre del archivo (sin .json)Fácil