Saltar al contenido
Documentación de Aura Home

Documentación del Aura Home SDK

El Aura Home SDK es la capa de integración del lado del cliente para incorporar Aura Home en sitios web de socios, corredores, portales o empresas.

Instalación

Instale el paquete, cree un contenedor anfitrión e inicialice un despliegue del runtime.

Lista de verificación de incorporación

Prepare la información del portal, la identidad, el entorno, los certificados y el soporte antes de la implementación.

Referencia de la API

Revise las opciones admitidas, los métodos de instancia, los eventos del ciclo de vida, los metadatos de apariencia resueltos y los contratos de configuración.

Apariencia y temas

Configure las solicitudes de tema del SDK, los perfiles de chatbot publicados desde el panel, los tokens de tarjetas de resultados y las revisiones de tema sin HTML ni scripts sin procesar.

Claims del token

Conozca los claims OIDC/JWT obligatorios y recomendados para el SSO empresarial.

Tutorial

Siga un flujo práctico de integración de marca blanca, desde la configuración del contenedor hasta las verificaciones de lanzamiento.

SSO y HTTPS

Implemente SSO en el portal, autenticación mediante puente SAML, certificados SSL, integraciones por HTTPS y validación del lanzamiento.

Entornos

Planifique la configuración del runtime para dev, staging y producción.

Solución de problemas

Diagnostique las fallas de integración más comunes de los clientes.

Arquitectura

Comprenda cómo se ubica el SDK dentro de la plataforma de agentes de Aura Home en su conjunto.

Manual de Celestial Observer

Abra el tutorial independiente para operadores sobre los flujos de trabajo de la consola, la gobernanza de la wiki, la inspección de trazas, la evidencia de auditoría y la configuración de entornos.

Capacidades principales

  • Integre Aura Home en un iframe controlado por el ciclo de vida del SDK.
  • Elija las secciones visibles, como chat, perfil, navegación, incorporación, precios y páginas legales.
  • Solicite temas aprobados por el runtime, como cadisa, mediante theme.id.
  • Aplique la identidad de marca del cliente mediante configuraciones permitidas de color, tipografía, indicador de carga, tarjetas de resultados y, de forma opcional, una hoja de estilo alojada.
  • Transmita la identidad empresarial mediante un callback de token, sin incluir tokens en las URL.
  • Escuche los eventos del ciclo de vida y ejecute comandos como openChat() y openProfile().
  • Lea los metadatos de apariencia resueltos mediante appearanceResolved y getResolvedAppearance().
  • Inspeccione la habilitación de las tarjetas de resultados, los metadatos del catálogo de renderizadores, los tokens de tarjeta y el themeRevision activo para tareas de soporte.

Orden de lectura recomendado

  1. Lista de verificación de incorporación
  2. Instalación
  3. Referencia de la API
  4. Apariencia y temas
  5. Claims del token
  6. SSO y HTTPS
  7. Entornos
  8. Solución de problemas
  9. Tutorial
  10. Manual de Celestial Observer