Skip to content

Configuración

El módulo Configuración es el único lugar al que un administrador acude para cambiar cualquier cosa que afecte a toda la organización — cómo se ve la aplicación, quién puede iniciar sesión en qué, cómo se envían los correos salientes, qué funciones aparecen en la barra lateral. La mayor parte del trabajo ocurre en Configuración dentro de la barra lateral, con algunas superficies relacionadas separadas en sus propias páginas (Módulos, App PWA, Canales, Accesibilidad) porque necesitan más espacio en pantalla del que permite una franja de pestañas.

Página principal de configuración

Cómo está organizada la Configuración

Abre la barra lateral y haz clic en Configuración. Verás una franja de pestañas en la parte superior — marca primero, luego correo, mapa, pagos, dominio, recordatorios, campos personalizados, completitud, integraciones, WhatsApp, almacenamiento, sin conexión, legal, general, accesibilidad. La franja se desplaza horizontalmente en móvil para que nada quede oculto.

Algunas pestañas solo aparecen cuando tienes permiso o cuando tu plan soporta la función:

  • Correo, Pagos, Recordatorios, Campos personalizados, Integraciones, WhatsApp, Almacenamiento, Accesibilidad — solo administradores.
  • Mapa — cualquiera con el permiso map.manage.
  • Dominio — solo planes Growth, Network o Unlimited.
  • Sin conexión — planes Growth+, y solo cuando VITE_POWERSYNC_URL está configurado en esta compilación.

Si no ves una pestaña que este documento menciona, es porque tu rol o plan no la incluye.

Páginas relacionadas fuera de Configuración

Algunas pantallas relacionadas viven en otra parte de la barra lateral porque necesitan una página completa:

PáginaQué hace
MódulosActiva o desactiva funciones completas para tu organización.
App PWAConfigura la aplicación instalable — nombre, íconos, colores del tema, push.
CanalesConecta proveedores de WhatsApp, SMS, correo, push e in-app.
AccesibilidadPreferencias visuales y de movimiento por usuario, más predeterminados de la organización.

Cada una tiene su propio artículo porque son flujos de trabajo significativos por sí mismos.

Dónde viven realmente las configuraciones

Para los curiosos (y para cualquiera que esté depurando), las configuraciones se almacenan en tres lugares:

  • app_settings — una tabla clave/valor para todo lo que no merece una columna dedicada. Marca, PWA, configuración del proveedor de correo, reglas de envío de mensajes, texto del pie de página. Una fila por (organization_id, key). Las ediciones pasan por el ayudante upsertAppSettings para que RLS limite el alcance por current_org_id().
  • organizations — las columnas a las que otras tablas hacen referencia. Nombre de la organización, plan, idioma predeterminado, país predeterminado, zona horaria (usada por edge functions).
  • Tablas específicas de funcionesorg_channel_config (canales), event_reminder_config (recordatorios), org_custom_domains (dominio), reserved_slugs (gestionado por la plataforma), preferencias de accesibilidad en user_accessibility_preferences y org_accessibility_defaults.

No necesitas saber nada de esto para usar la interfaz — pero si alguna vez estás exportando una organización o resolviendo por qué una configuración "no se guardó", saber dónde mirar ayuda.

Una nota sobre la trampa de la zona horaria

organizations.timezone es la fuente de verdad que leen las edge functions. El frontend lee app_settings.app_timezone a través de BrandingContext. El artículo de Marca escribe ambos a la vez cuando guardas el formulario regional, así que se mantienen sincronizados — pero si alguna vez editas uno directamente en SQL, edita el otro también.

Quién puede cambiar qué

La mayoría de las pestañas solo para administradores están protegidas por el sistema de permisos RBAC v2. La matriz:

PestañaPermiso requerido
Marcacualquier usuario autenticado puede ver; los administradores guardan
Correo, Recordatorios, Campos personalizados, Integraciones, WhatsAppisAdmin
Mapamap.manage
PagosisAdmin (sensible para PCI)
DominioisAdmin + plan Growth+
AlmacenamientoisAdmin
Módulosactivaciones por isAdmin; los no administradores ven solo lectura
Accesibilidaduno mismo siempre; predeterminados de la organización para administradores

Las mismas verificaciones se ejecutan del lado del servidor vía assertPermission en las edge functions que respaldan cada formulario, así que una solicitud hecha a mano no puede saltarse la protección de la interfaz.

Guardar y la barra de cambios sin guardar

Cada pestaña que muta datos usa una barra fija de Cambios sin guardar en la parte inferior de la página. Se mantiene visible mientras te desplazas para que no tengas que buscar un botón Guardar al final de un formulario largo. Al refrescar la página (o navegar fuera) te pide confirmar — la protección del formulario sin guardar es intencional, ya que algunas de estas configuraciones afectan cada correo que enviarás mañana por la mañana.

Próximos pasos

  1. Datos básicos de la organización — establece nombre legal, configuración regional, zona horaria.
  2. Marca — logo, favicon, colores, pie de página.
  3. Correo + notificaciones — conecta la identidad del remitente.
  4. Canales — configuración por proveedor para mensajería.
  5. Configuración PWA — haz la aplicación instalable.
  6. Activar / desactivar módulos — mantén la barra lateral relevante.