{
  "kb_info": {
    "title": "Base de Conocimiento SIGNOS para Bot de Soporte y RAG",
    "version": "2.5.0",
    "updated_at": "2026-07-02",
    "platform": "SIGNOS Enterprise Omnichannel & AI Platform"
  },
  "modules": [
    {
      "id": "ai-agents",
      "name": "AI Agents & Copilot",
      "summary": "Asistentes conversacionales autónomos con RAG (Retrieval-Augmented Generation) y Function Calling.",
      "key_points": [
        "Soporte para Google Gemini, OpenAI y Anthropic Claude.",
        "Integración con Base de Conocimiento PDF/Markdown/TXT via embeddings.",
        "Escalada automática a operadores humanos al detectar frustración en el usuario."
      ],
      "endpoints": ["/ai-agents"],
      "troubleshooting": [
        {
          "problem": "El AI Agent responde 'Dame un momento' continuamente.",
          "solution": "Verifique que la API Key configurada en Configuración -> AI Settings sea válida y tenga cuota disponible."
        }
      ]
    },
    {
      "id": "workflows",
      "name": "Visual Workflow Builder",
      "summary": "Motor conversacional gráfico por nodos para orquestación de interacciones entrantes y salientes.",
      "nodes_available": [
        "Trigger (WhatsApp/Webhook/SIP)",
        "AI Agent",
        "Decision/Condition",
        "HTTP Request",
        "Send Message",
        "Queue Transfer",
        "CRM Update"
      ],
      "troubleshooting": [
        {
          "problem": "El flujo se detiene en un nodo HTTP Request.",
          "solution": "Verifique que el endpoint externo retorne status 200/201 dentro del timeout de 10 segundos y el JSON sea válido."
        }
      ]
    },
    {
      "id": "inbox",
      "name": "Omnichannel Smart Inbox",
      "summary": "Bandeja de atención para operadores humanos y supervisores con asistencia de IA.",
      "features": [
        "Resumen de conversación con 1 clic impulsado por IA.",
        "Sugerencias de respuesta automática (Copilot).",
        "Modo susurro y monitoreo en vivo para supervisores."
      ]
    },
    {
      "id": "channels",
      "name": "Omnichannel Channels (WhatsApp, Instagram, SIP)",
      "summary": "Conectores oficiales multi-canal para mensajería y telefonía VoIP.",
      "key_points": [
        "Conexión directa con Meta Cloud API para WhatsApp Business.",
        "Soporte SIP/WebRTC para centrales telefónicas e IVR conversacional con Speech-to-Text."
      ]
    },
    {
      "id": "erp-orders",
      "name": "ERP & E-Commerce Integration",
      "summary": "Sincronización de catálogo, stock e historial de pedidos con MercadoLibre y sistemas ERP.",
      "features": [
        "Consulta automática de stock en tiempo real desde workflows conversacionales.",
        "Confirmación de despacho por WhatsApp al actualizarse la orden."
      ]
    },
    {
      "id": "vault",
      "name": "Secure Tenant Vault",
      "summary": "Almacén encriptado AES-256 para credenciales de terceros y API keys por tenant.",
      "key_points": [
        "Aislamiento estricto entre clientes empresariales.",
        "Auditoría inmutable de accesos en el módulo de logs."
      ]
    },
    {
      "id": "pbx-gateway",
      "name": "Gateway PBX SIGNOS (SBC Local Instalable)",
      "summary": "Session Border Controller (SBC) instalable en local para interconectar centrales SIP (FreePBX/Asterisk) con SIGNOS Cloud.",
      "key_points": [
        "Se ejecuta mediante Node.js en la red local del cliente.",
        "Puerto 3456: Interfaz Web de Administración Local.",
        "Puerto 3457: Servidor saliente / Webhook que conecta con SIGNOS vía Ngrok o túnel directo.",
        "Puerto 5080: Receptor SIP para llamadas desde FreePBX."
      ],
      "troubleshooting": [
        {
          "problem": "Rechazo 403 Forbidden desde el SBC local.",
          "solution": "Verifique que la IP de su FreePBX esté incluida en 'allowedIps' dentro de config.json en el servidor Gateway."
        }
      ]
    }
  ],
  "feature_combinations": [
    {
      "title": "Atención Híbrida: AI Agent RAG + Escalada Inteligente a Humano",
      "flow": "Ingreso por WhatsApp -> AI Agent responde con Base de Conocimiento -> Si el sentimiento cae a negativo o el usuario pide humano -> Transfiere a Cola -> Operador recibe Resumen IA en su Inbox."
    },
    {
      "title": "E-Commerce Order Status Automation",
      "flow": "Cliente consulta estado de pedido por WhatsApp -> AI Agent llama función de ERP/MercadoLibre -> Retorna estado actual y número de tracking automáticamente."
    },
    {
      "title": "Auditoría de Voz SIP en Tiempo Real",
      "flow": "Llamada telefónica SIP -> Speech-to-Text convierte audio a texto -> AI evalúa palabras clave críticas -> Emite alerta en vivo al Supervisor Dashboard."
    }
  ],
  "faqs": [
    {
      "q": "¿Cómo conecto mi número de WhatsApp a SIGNOS?",
      "a": "Ingresa a Canales -> WhatsApp -> Conectar con Meta Cloud API. Necesitarás un ID de App de Meta y un Token de Acceso Permanente o configurar el Webhook oficial con la URL de tu instancia SIGNOS."
    },
    {
      "q": "¿Qué pasa si se cae mi proveedor de Inteligencia Artificial?",
      "a": "El motor de Workflows cuenta con desbordamiento (Fallback): si el nodo AI Agent falla o da timeout tras 3 intentos, la interacción se enruta automáticamente a la Cola humana de respaldo."
    },
    {
      "q": "¿Puedo llamar a un API externa o CRM interno desde un chat?",
      "a": "Sí, utilizando el nodo 'HTTP Request' en los Workflows o mediante Function Calling en los AI Agents conectando al Vault seguro para autenticación."
    },
    {
      "q": "¿Cómo conecto mi central telefónica local (FreePBX / Asterisk) a SIGNOS?",
      "a": "Descargue e instale localmente el paquete 'Gateway PBX SIGNOS (signospbx-int)'. Ejecute 'npm install && npm start' en un servidor de su red local. Acceda a http://localhost:3456 para configurar su Troncal e ingrese su instanceId y webhookUrl. En FreePBX, apunte una troncal SIP al puerto 5080 del Gateway."
    }
  ]
}