Aura Home SDK

Inteligencia inmobiliaria de marca blanca, integrada en una línea.

Un asistente conversacional que conoce el mercado, habla en nombre de su marca y vive dentro de su portal. Creado para inmobiliarias, portales, desarrolladoras, franquicias y plataformas regionales.

Pruebe la demo en vivo Ver documentación

La experiencia

Sus visitantes preguntan como le preguntarían a un agente local.

Aura Home convierte un deseo vago en una selección fundamentada. Explica ventajas y desventajas, mantiene la búsqueda dentro del presupuesto y entrega leads calificados y con interés real a su equipo.

Orientación inmobiliaria por chat basada en anuncios reales
Contexto de perfil y herramientas detrás de contratos de producto estables
Selección de modelo y caché semántica para controlar velocidad y costo

aura-home · embedded via cadisa sdk

Busco un alquiler de dos habitaciones cerca de Perrystown o Tallaght, con buen transporte y zona tranquila para la familia.

Empiece por Dublin 12 para Perrystown y compárelo con Tallaght en precio y transporte. Tres opciones dentro de su presupuesto:

Perrystown2 hab. · Luas 9 min

Tallaght2 hab. · Red Line

Templeogue2 hab. · calle tranquila

Demo en vivo

Converse con Aura Home ahora mismo.

Este es el runtime de producción, especializado en los mercados de vivienda de Irlanda. Pídale una vivienda como se la pediría a un agente local.

Runtime de producción · Irlanda Abrir en pantalla completa

Pruebe las opciones del SDK

Adapte Aura Home a su portal.

Elija el tema, el color de marca y los módulos que su portal necesita. La vista previa y el código de inserción se actualizan con cada clic.

Esquema de color

Color de marca

Áreas visibles

Chat Perfil Herramientas Barra de navegación

Identidad

Esta es una simulación visual de las opciones del SDK. El runtime real está en la página de Aura Home.

Hola, soy el asistente de Harbour Homes. ¿Qué estás buscando?

Algo tranquilo para la familia, cerca del transporte.

Perrystown, en Dublin 12, encaja muy bien: calles tranquilas, el Luas a 9 minutos y viviendas de dos habitaciones dentro de su presupuesto. ¿Quiere que lo compare con Tallaght?

Pregunta por cualquier zona…

SSO · token vía callback

embed.ts · generado en vivo

Arquitectura

Arquitectura genérica para inteligencia inmobiliaria white label.

Aura Home está estructurado como una plataforma B2B reutilizable: el sitio del cliente controla la experiencia del portal, el SDK incorpora el asistente con su marca y el backend conecta varios portales inmobiliarios, proveedores de LLM, flujos de telemetría y controles de seguridad detrás de una superficie de integración estable.

01

Sitio del cliente + SDK

El sitio host carga el SDK, elige la implementación de Aura Home, controla las secciones visibles y puede solicitar un tema aprobado sin operar el runtime incorporado.

02

Runtime incorporado

Aura Home funciona como una experiencia incorporada y controlada. Puede mostrar el asistente completo o una capa reducida de chat y perfil que se siente nativa dentro del portal.

03

Orquestación de agentes

El backend conversacional coordina el contexto de perfil, las herramientas, la búsqueda de inmuebles, la selección de modelo, la caché semántica y la generación de respuestas detrás de contratos de producto estables.

04

Malla de adaptadores de portal

Los datos de mercado entran por contratos normalizados de adaptadores. Un nuevo mercado puede sumar feeds oficiales, APIs de portales o crawlers controlados manteniendo un único modelo estructurado de inmueble.

05

Telemetría + auditoría

Eventos operativos, traces, uso de proveedores, resultados de herramientas, actividad por usuario y eventos de auditoría alimentan paneles de observabilidad y gobernanza.

Modelo de expansión de mercado

Una base de producto, muchos mercados inmobiliarios.

La arquitectura trata cada mercado como una implementación configurada del mismo patrón de producto. Adaptadores de portal locales, feeds de datos oficiales, proveedores de identidad, requisitos legales, idioma y políticas de modelo pueden variar por tenant, mientras el contrato del SDK sigue estable para los equipos de ingeniería del cliente.

Portales localesMarca del tenantPolíticas de proveedor

Multiportal por diseño

Los portales se integran detrás de contratos de adaptador, así cada mercado puede combinar fuentes locales de anuncios, feeds de datos canónicos, resolución de ubicación y enriquecimiento de inmuebles sin cambiar el SDK del cliente.

Flexibilidad de proveedor de LLM

La arquitectura de agentes separa la elección del proveedor de la incorporación en el cliente. Los equipos pueden repartir el trabajo entre los proveedores de LLM soportados, evolucionar políticas de precio y calidad y observar el rendimiento de cada proveedor de forma centralizada.

Superficie B2B white label

El SDK admite implementaciones configurables, temas aprobados en runtime, identidad de marca vía CSS y control por sección, lo que hace a Aura Home adecuado para inmobiliarias, desarrolladoras, portales, franquicias y plataformas inmobiliarias regionales.

Localización por mercado

Un nuevo país o segmento puede traer sus propios portales, restricciones de compliance, terminología, contexto de prompt, criterios de QA y conectores de datos, manteniendo la misma estructura de producto incorporada.

Documentación de Aura Home

Integración del SDK del lado del cliente.

Este es el contrato de implementación que necesita el equipo del cliente: instalar el paquete, elegir la implementación de Aura Home, decidir qué superficies son visibles, solicitar temas aprobados y pasar la identidad por un callback de token seguro para uso empresarial.

Instale el SDK y cree un contenedor en el host.

El equipo del cliente agrega un elemento vacío a la página e inicializa Aura Home cuando ese elemento ya existe. El SDK se encarga de crear el iframe, de los eventos de ciclo de vida y de la entrega segura de la configuración.

Instale desde el registro de paquetes o un feed privado.
Cree un contenedor estable, como #aura-home.
Inicialice una vez por cada superficie de incorporación visible.
Mantenga las URLs de runtime y los IDs de temas aprobados en la configuración del entorno del cliente.

Install + init

npm install @aura-home/sdk

import { AuraHome } from "@aura-home/sdk";

const aura = AuraHome.init({
  container: "#aura-home",
  baseUrl: "https://prod-ai-agent-ui-hztgrud75a-ew.a.run.app/",
  sdkHost: "customer.example",
  sections: {
    chat: true,
    profile: true,
    navbar: false,
    footer: false,
    exploreTools: false,
    onboarding: false
  },
  theme: {
    id: "cadisa",
    mode: "dark",
    cssVariables: {
      "--color-brand-primary": "#2F6FED",
      "--color-brand-primary-hover": "#1F56C6",
      "--color-brand-accent": "#8AB4F8",
      "--aura-chat-header-background": "#0b1f4d",
      "--aura-card-accent": "#2F6FED",
      "--aura-card-focus-ring": "#8AB4F8"
    }
  }
});

Muestre solo las superficies de Aura Home que el cliente quiere.

El cliente puede incorporar el producto completo o reducirlo a una experiencia transparente de chat y perfil. Ocultar todas las secciones es válido para launchers controlados por el host y para pruebas de integración.

Empiece las incorporaciones transparentes solo con chat y perfil.
Oculte navbar, pie de página, onboarding, precios y páginas legales dentro de los sitios del cliente.
Use el comportamiento sections=none cuando el host controla todos los launchers visibles.
Actualice las secciones en tiempo de ejecución con aura.updateConfig(...).

Section flags

AuraHome.init({
  container: "#aura-home",
  baseUrl: AURA_HOME_URL,
  sections: {
    chat: true,
    profile: true,
    exploreTools: false,
    navbar: false,
    footer: false,
    onboarding: false,
    pricing: false,
    legalPages: false
  }
});

// later, at runtime
aura.updateConfig({ sections: { profile: false } });

Publique la marca del tenant con el SDK y el Appearance Studio.

El SDK puede solicitar un tema con nombre, como cadisa, mientras los operadores usan el Appearance Editor del panel para guardar borradores, previsualizar los modos claro, oscuro y sistema, editar colores, tipografía y tokens de tarjetas, y publicar el perfil activo del chatbot con una revisión de tema rastreable.

Use theme.id solo como pedido visual: el aislamiento del tenant sigue siendo la baseUrl del runtime.
Prefiera variables CSS de la lista permitida para color de marca, mensajes, campos, botones, tipografía y tarjetas de resultados.
Use cardTokens para alinear tarjetas, botones de acción, acentos y anillos de foco con el perfil activo.
Use stylesheetUrl solo para ajustes visuales más amplios y aprobados.
Nunca ponga secretos, datos de usuarios, HTML sin procesar ni scripts en los valores del tema.

Appearance contract

AuraHome.init({
  container: "#aura-home",
  baseUrl: AURA_HOME_URL,
  theme: {
    id: "cadisa",
    mode: "dark",
    cssVariables: {
      "--color-brand-primary": "#2F6FED",
      "--color-brand-primary-hover": "#1F56C6",
      "--color-brand-accent": "#8AB4F8",
      "--aura-home-loader-background": "#f5f9ff",
      "--aura-home-loader-text": "#0b1f4d",
      "--aura-chat-header-background": "#0b1f4d",
      "--aura-chat-message-font-size": "15px",
      "--aura-chat-button-font-weight": "700",
      "--aura-card-accent": "#2F6FED",
      "--aura-card-action-background": "#2F6FED",
      "--aura-card-focus-ring": "#8AB4F8"
    },
    stylesheetUrl: "https://customer.example/aura-theme.css"
  }
});

Deje que el proveedor de identidad del host autentique al usuario.

El runtime le pide un token al SDK solo cuando lo necesita. El SDK llama al proveedor de tokens del cliente y envía el token por postMessage a la app Aura Home incorporada.

Use el modo oidc en integraciones de SSO empresarial.
Devuelva un token JWT/OIDC de corta duración en getToken.
No ponga tokens en query strings, atributos HTML, CSS ni logs.
El backend de Aura Home sigue siendo la autoridad en la validación de tokens.

OIDC token callback

AuraHome.init({
  container: "#aura-home",
  baseUrl: AURA_HOME_URL,
  auth: {
    mode: "oidc",
    getToken: async () => {
      return await customerIdentity.getIdToken();
    }
  }
});

Coordine Aura Home con la página del cliente.

Los eventos permiten que la página host actualice indicadores de carga, inspeccione los metadatos de apariencia resueltos, abra el perfil desde botones externos, oculte secciones después del onboarding o capture errores de integración.

Use ready para quitar los estados de skeleton del host.
Use appearanceResolved o getResolvedAppearance() para ver tarjetas de resultados, catálogo de renderers, tokens de tarjetas y themeRevision.
Use configAck para confirmar que la configuración llegó al runtime.
Use openProfile y openChat en launchers nativos de la página del cliente.
Cancele siempre los listeners al destruir incorporaciones dinámicas.

Events + commands

aura.on("ready", () => {
  console.log("Aura Home is ready");
});

aura.on("appearanceResolved", (event) => {
  console.log(event.payload?.resolvedThemeId);
  console.log(event.payload?.features?.resultCardsEnabled);
});

const appearance = aura.getResolvedAppearance();
console.log(appearance?.themeRevision);

aura.openProfile();
aura.updateConfig({
  sections: { profile: false }
});

Elija la implementación de Aura Home al momento de integrar.

El SDK no fija entornos en el código. Clientes u operadores indican baseUrl, sdkHost, allowedOrigin y los IDs de temas aprobados de cada implementación.

Use URLs de dev para pruebas de integración.
Use URLs por tenant cuando el cliente exija aislamiento.
Defina allowedOrigin con el origen del runtime de Aura Home.
Las implementaciones de runtime también deben exigir orígenes padre aprobados.

Runtime target

AuraHome.init({
  container: "#aura-home",
  baseUrl: "https://prod-ai-agent-ui-hztgrud75a-ew.a.run.app/",
  allowedOrigin: "https://prod-ai-agent-ui-hztgrud75a-ew.a.run.app",
  sdkHost: "customer.example"
});

Guía de instalación Referencia de la API

Seguridad

Identidad empresarial, telemetría y auditoría integradas.

Mensajería con origen validado

Orígenes principales aprobados, validación de tokens en el backend y límites de tasa mantienen estricto el contrato de integración.

La identidad sigue siendo suya

Las estrategias con OIDC y SAML mantienen a su proveedor de identidad como fuente de verdad. Los tokens llegan mediante callbacks del SDK.

Trazable por diseño

Los eventos relevantes para la seguridad y la actividad de los agentes son trazables, sin exponer secretos en logs, URLs ni temas.

Preguntas frecuentes

Lo que los equipos preguntan primero.

Hable con Cadisa

¿Qué es Aura Home SDK?

Aura Home SDK es la capa de incorporación del lado del cliente que coloca Aura Home dentro del sitio del cliente, con secciones configurables, estilo white label, identidad empresarial, telemetría y controles de auditoría.

¿Aura Home funciona con varios portales inmobiliarios?

Sí. La arquitectura usa contratos normalizados de adaptadores de inmuebles, así cada mercado puede conectar portales locales, feeds oficiales, APIs o crawlers controlados sin cambiar la superficie del SDK.

¿Cadisa admite más de un proveedor de LLM?

Sí. La orquestación de agentes está diseñada en torno a la abstracción de proveedores, lo que permite evolucionar la elección de modelo, las políticas de costo, los controles de calidad y la observabilidad de cada proveedor con el tiempo.

Piloto de Aura Home

Lleve Aura Home a su portal.

Cuéntenos su mercado, sus fuentes de anuncios y su proveedor de identidad. Mapeamos la integración junto con usted.

Inicie un piloto Ver tutorial