> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ouraicalling.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Inquilinos y marca blanca

> La jerarquía de roles, los espacios de trabajo de marca blanca y la suplantación

La plataforma es multi-tenant por diseño: las agencias y los revendedores ("inquilinos") gestionan su propia instancia de marca en su propio dominio, con usuarios, planes y precios propios.

## Jerarquía de roles

```text theme={null}
Platform admin (the operator)
├── Tenants (white-label customers: own domain & branding)
│   └── Tenant users (the tenant's end customers)
└── Direct users (no tenant; use the main domain)
```

* **Un único inicio de sesión para todos**: el rol determina lo que ve cada usuario.
* Los **administradores de la plataforma** gestionan todos los usuarios, inquilinos, planes de la plataforma y el catálogo de modelos en `/admin`.
* Los **administradores de inquilino** (propietario/administrador de un inquilino) cuentan con un área de administración de inquilino dedicada: un panel con los KPI del inquilino, el historial de llamadas de todos sus usuarios, gestión de usuarios, plantillas de prompts, planes, facturación, migración de datos y configuración de marca.

## Marca blanca

El espacio de trabajo de un inquilino funciona completamente bajo su propia identidad:

* **Dominio**: la app, el inicio de sesión, la API (`/api/v1`) e incluso el [endpoint de MCP](/api/mcp) funcionan bajo el dominio del inquilino.
* **Marca**: logo, favicon, colores y nombre de la app; se aplica a la app, la pestaña del navegador, las páginas de inicio de sesión y registro, y las pantallas de consentimiento de OAuth. Los dominios de los inquilinos usan su propio favicon y recurren al favicon de la plataforma cuando no hay ninguno configurado.
* **Correo de soporte**: se muestra a los usuarios del inquilino.
* **Planes y precios**: los inquilinos definen sus propios planes y precios; consulta [Planes y límites](/admin/plans-and-limits) y [Stripe Connect](/admin/stripe).

La administración de la marca blanca está controlada por un interruptor del plan de la plataforma (`whitelabel_enabled`), un complemento de plataforma contratado (`feature_key=whitelabel`), una excepción por derechos adquiridos de Domain/Connect, o una anulación a nivel de espacio de trabajo por parte de un administrador. Los planes de reventa de los inquilinos no pueden otorgar ni revender la marca blanca.

### Verificación de dominio personalizado

Agrega el nombre de host completo en **Administrador de inquilino → Configuración**, por ejemplo `app.famulor.io`. La plataforma lo asocia entonces a su capa de enrutamiento y comprueba dos requisitos independientes:

1. **Propiedad**: si se solicita una verificación, publica el registro TXT exacto que se muestra en la página de configuración.
2. **DNS y TLS**: publica el registro A recomendado para un dominio apex o el CNAME para un subdominio. La página lee la configuración DNS en vivo y solo habilita el dominio cuando el enrutamiento es correcto y se puede emitir el TLS.

Usa **Verificar DNS** después de hacer cambios. La propagación del DNS puede tardar. El estado nunca se infiere de una casilla guardada: la plataforma vuelve a comprobar la configuración en vivo y sincroniza `custom_domain_verified` solo cuando ambas verificaciones pasan. Eliminar el dominio lo desvincula y desactiva de inmediato el enrutamiento de inquilinos basado en host.

El mismo ciclo de vida está disponible mediante `GET`, `POST` y `DELETE /api/v1/custom-domain`, con `POST /api/v1/custom-domain/verify` para forzar una nueva verificación, y a través de las herramientas MCP correspondientes.

## Cuentas gratuitas

Los inquilinos pueden permitir **registros gratuitos** con límites predeterminados configurables (por ejemplo, 1 asistente, 5 campañas, 1 número) y un precio por minuto para el uso de pago por consumo. El mismo mecanismo existe a nivel de plataforma para los usuarios directos. Registrarse en un dominio de inquilino crea automáticamente la membresía del inquilino con esos valores predeterminados.

## Suplantación ("Vista de usuario")

Los administradores pueden iniciar sesión **como** un usuario para ver exactamente lo que ve — el flujo de trabajo esencial de soporte:

* Los administradores de la plataforma pueden suplantar a cualquier usuario; los administradores de inquilino solo pueden suplantar a los usuarios de su propio inquilino.
* Un banner muestra todo el tiempo "Has iniciado sesión como X — volver al administrador".
* Cada suplantación queda **registrada en la auditoría**.

## Plantillas de prompts

Los administradores de la plataforma gestionan plantillas **globales** en `/admin/prompt-templates` (visibilidad: todos los espacios de trabajo, o solo los espacios de trabajo raíz de la plataforma). Los administradores de inquilino mantienen plantillas de espacio de trabajo en `/tenant-admin/prompt-templates`, visibles para los miembros de ese espacio de trabajo y para los espacios de trabajo de los clientes del revendedor.

Los usuarios finales abren **Elegir plantilla** al crear un asistente o desde la tarjeta de prompt del sistema (modo Prompt), filtran por idioma, tema o rama, la previsualizan y la aplican (se copia al seleccionarla en `system_prompt` y, opcionalmente, en `first_message`). Misma lista: `GET /api/v1/prompt-templates` y el MCP `list_prompt_templates`.

## Migración de datos

Los administradores de inquilino pueden transferir recursos (asistentes, herramientas, bases de conocimientos, números) **de un usuario a otro** dentro del inquilino, algo útil cuando una agencia construye sobre un usuario de staging y luego lo entrega a la cuenta del cliente. Los administradores de la plataforma pueden hacer esto de forma global.
