Organización
Copia un prompt de configuración con los pasos de instalación y la guía completa en markdown para este plugin.
¿Qué es una organización?
Sección titulada «¿Qué es la organización?»La organización te permite compartir apps con tu equipo mientras controlas exactamente quién puede hacer qué. Cada cuenta de Capgo pertenece a al menos una organización, y puedes crear tantas organizaciones como necesites.
El acceso se gestiona a través de control de acceso basado en roles (RBAC). A cada miembro del equipo se le asigna un rol, ya sea a nivel de organización o limitado a una app específica, que determina lo que puede ver y hacer. El acceso a canales puede ajustarse aún más con sobrescrituras de permisos por canal.
Resumen de la configuración de la organización
Sección titulada “Resumen de la configuración de la organización”
Accede a la configuración de la organización haciendo clic Configuración en la barra lateral izquierda y luego seleccionando la Organización en la parte superior. Desde ahí, puedes navegar por las siguientes secciones:
| Pestaña | Descripción |
|---|---|
| General | Ver y editar nombre, logo, email de gestión de la organización |
| Miembros | Gestionar miembros del equipo y sus permisos |
| Grupos | Crea y gestiona grupos de usuarios para asignar roles en lote |
| Claves de API | Gestiona las claves de API para acceso programático |
| Planes | Consulta y gestiona tu plan de suscripción |
| Créditos | Consulta y compra créditos adicionales |
| Seguridad | Configura políticas de seguridad (2FA, requisitos de contraseña) |
| Uso | Monitorea las estadísticas de uso de tu organización |
| Logs de auditoría | Ver los logs de actividad de tu organización |
| Webhooks | Configurar integraciones de webhooks |
| Facturación | Gestionar información de facturación y facturas |
Cómo cambiar de organización
Sección titulada “Cómo cambiar de organización”Haz clic en el selector de organización el desplegable en la parte superior izquierda de la barra lateral para ver y cambiar entre las organizaciones a las que tienes acceso.
Gestión de miembros
Sección titulada “Gestión de miembros”Ver miembros
Sección titulada “Ver miembros”
La sección Miembros muestra todos los usuarios que tienen acceso a tu organización, junto con:
- Miembro: Avatar y nombre
- Rol: Rol actual (Super Admin, Admin, Billing Manager o Member) con un Activo o Pendiente etiqueta
- Acciones: Editar rol, gestionar acceso a nivel de app o eliminar de la organización
Los miembros activos se ordenan por prioridad de rol. Las invitaciones pendientes aparecen con un Pendiente badge.
Invitar a un miembro
Sección titulada “Invitar a un miembro”- Haz clic en + Añadir botón en la sección Miembros
- Una Selecciona un rol aparecerá un modal — elige el rol a nivel de organización para el nuevo miembro:

Los roles disponibles a nivel de organización son:
- Miembro — Acceso de solo lectura
- Gestor de facturación — Solo acceso a facturación
- Administrador — Administración completa (sin facturación ni eliminación)
- Superadministrador — Control total
- Haz clic Confirmar, luego completa el formulario de invitación (correo electrónico, nombre y apellido opcionales, captcha) y haz clic en Enviar invitación.
El usuario invitado recibirá un correo con un enlace mágico. Al aceptarlo, se añadirá a la organización con el rol seleccionado.
Asignar roles a nivel de app
Sección titulada “Asignación de roles a nivel de app”Además del rol a nivel de organización, puedes otorgar a un miembro acceso a apps específicas con un rol más específico. Haz clic en Control de acceso botón (icono de escudo) junto a un miembro para abrir el modal de acceso a la app:

Desde este modal puedes:
- Buscar y seleccionar una app
- Elegir un rol a nivel de app en el desplegable

Los roles a nivel de app disponibles son:
- Admin de app — Administración completa de una app
- Desarrollador de app — Subir bundles y gestionar dispositivos, sin operaciones destructivas
- Uploader de app — Leer datos de la app y subir bundles
- Lector de app — Acceso de solo lectura a una app
- Haz clic Asignar para otorgar el rol.
Editar el rol de un miembro
Sección titulada «Editar el rol de un miembro»Haz clic en el botón de edición (icono de llave inglesa) junto a un miembro para cambiar su rol a nivel de organización. El mismo Selecciona un rol modal con el rol actual preseleccionado.
Restricciones:
- No puedes cambiar el rol del creador de la organización
- No puedes eliminar al último Super Admin: siempre debe haber al menos uno
- Para ascender o degradar a un Super Admin, debes ser Super Admin tú mismo
Eliminar un miembro
Sección titulada “Eliminar a un miembro”
Haz clic en el botón de eliminar (icono de papelera) junto a un miembro. Aparecerá un diálogo de confirmación advirtiendo que esta acción no se puede deshacer. Haz clic Eliminar para confirmar. Esto revocará inmediatamente todo su acceso a la organización, sus apps y sus canales.
Resumen de roles
Sección titulada “Resumen de roles”Capgo utiliza control de acceso basado en roles con roles organizados por alcance. Puedes asignar un rol a nivel de organización nivel (acceso total), o limítalo a un solo app. El acceso al canal se puede personalizar aún más con sobrescrituras de permisos por canal.
Roles de la organización
Sección titulada “Roles de la organización”Se asignan cuando invitas a un miembro. Se aplican en toda la organización.
| Rol | Nombre interno | Descripción |
|---|---|---|
| Superadministrador | org_super_admin | Control total: facturación, eliminación y transferencia. Se otorga automáticamente al creador de la organización. |
| Administrador | org_admin | Administración completa: gestiona miembros, apps y canales. Sin facturación ni eliminación. |
| Gestor de facturación | org_billing_admin | Solo facturación: ver/actualizar pagos, facturas y auditoría de facturación. Sin acceso a apps ni miembros. |
| Miembro | org_member | Acceso de solo lectura en toda la organización y todas sus apps. |
Roles de la app
Sección titulada “Roles de la app”Limitado a una sola app. Úsalos cuando un miembro del equipo deba trabajar solo en una app y no en toda la organización.
| Rol | Nombre interno | Descripción |
|---|---|---|
| Admin de app | app_admin | Control total de una app: canales, dispositivos y equipo. No se puede eliminar ni transferir la app. |
| Desarrollador de app | app_developer | Sube bundles, gestiona dispositivos, inicia builds y actualiza canales. Sin eliminaciones ni cambios de configuración. |
| Uploader de app | app_uploader | Acceso de lectura + subida de nuevas versiones de bundles. |
| Lector de app | app_reader | Solo lectura: estadísticas, bundles, canales, logs y dispositivos. |
Excepciones de permisos por canal
Sección titulada “Sobrescritura de permisos de canal”Por defecto, el acceso al canal se hereda del rol de la app. Puedes sobrescribir permisos específicos de canal por usuario o grupo; por ejemplo, permitir que un App Reader también asocie bundles en el staging canal. Ver Gestión de acceso a nivel de app a continuación para saber cómo configurarlo.
Gestión de acceso a nivel de app
Sección “Gestión de acceso a nivel de app”Cada app tiene una Acceso pestaña donde puedes gestionar quién tiene acceso a la app y qué puede hacer, incluyendo roles de la app y permisos específicos por canal.
Ver el acceso a la app
Sección “Ver el acceso a la app”
Ve a tu app y haz clic en la Acceso pestaña. La lista de acceso muestra cada usuario o grupo con su:
- Email — el email del usuario (o nombre del grupo)
- Rol — su rol en la app (App Admin, App Developer, App Uploader o App Reader)
- Otorgado en — cuándo se asignó el rol
- Acciones — permisos de canal (icono de escudo), editar rol (icono de llave inglesa) y eliminar (icono de papelera)
Cambiar un rol de la app
Sección titulada “Cambiar el rol de una app”Haz clic en editar botón (icono de llave inglesa) junto a un usuario para cambiar su rol a nivel de app:

Selecciona el nuevo rol y haz clic en Confirmar. Los roles disponibles son:
- Desarrollador de app — Subir bundles y gestionar dispositivos, sin operaciones destructivas
- Uploader de app — Leer datos de la app y subir bundles
- Lector de app — Acceso de solo lectura
Sobrescribir permisos de canal
Sección titulada “Sobrescribir permisos de canal”Haz clic en permisos de canal botón (icono de escudo) junto a un usuario para sobrescribir sus permisos de canal predeterminados:

El modal muestra el rol actual del usuario en la app y enumera todos los canales con tres permisos que se pueden sobrescribir individualmente:
| Permiso | Descripción |
|---|---|
| Consulta la | Ver el canal y su bundle actual |
| Historial | Ver el historial de asignación de bundles |
| Asociar bundle | Establecer o cambiar el bundle activo del canal |
Cada permiso por defecto es Predeterminado (permitir) — lo que significa que hereda del rol de la app. Puedes cambiar cualquier permiso para Permitir o Denegar explícitamente en un canal específico, dándote un control granular sin cambiar el rol general del usuario en la app.
Los grupos te permiten asignar roles a un conjunto de usuarios a la vez en lugar de gestionar a cada miembro individualmente. Un grupo pertenece a una organización y puede tener asignaciones de roles en cualquier ámbito: org o app.
Ejemplo: Crea un grupo “QA Team” y asígnale el Desarrollador de app rol en tu app de producción, y cada miembro de ese grupo obtiene acceso Developer a esa app al instante. Cuando alguien se une o sale del equipo, solo tienes que añadirlo o quitarlo del grupo: no necesitas tocar las asignaciones de roles individuales.
Cómo funcionan los grupos
Sección titulada “Cómo funcionan los grupos”- Un grupo es org-scoped — pertenece a una sola organización y no puede abarcar varias.
- Asignas roles a un grupo de la misma manera que a un usuario: el grupo aparece como principal en las vinculaciones de roles.
- Al verificar los permisos de un usuario, sus membresías de grupo se resuelven automáticamente. Si alguno de sus grupos tiene un rol que otorga el permiso requerido, se concede el acceso.
- Un usuario puede pertenecer a varios grupos, y los permisos de todos los grupos se combinan.
Ver grupos
Sección titulada “Ver grupos”
Navigate to the Grupos pestaña en la configuración de tu organización. La lista de grupos muestra el nombre,, la descripción,, el rol,, la fecha de creación, y y las acciones (editar o eliminar).
Crear un grupo
Sección titulada “Crear un grupo”Haz clic en + Añadir botón para abrir la página de creación de grupo:

Completa:
- Nombre (obligatorio) y Descripción (opcional)
- Rol de la organización — opcionalmente, asigna un rol a nivel de organización (None, Admin, Billing Manager o Member)
- Control de acceso pestaña — asigna roles a nivel de app haciendo clic + Añadir app, seleccionando una app y eligiendo un rol (p. ej., App Uploader, App Developer)
Necesitas Superadministrador o Administrador para crear grupos.
Gestionar miembros del grupo
Sección titulada “Gestión de miembros del grupo”Haz clic en un grupo para abrir su vista de detalle. Cambia a la Miembros pestaña:

Desde aquí puedes ver los miembros actuales y sus correos. Haz clic en + Añadir para añadir miembros:

El modal muestra todos los miembros de la organización. Busca por nombre, selecciona los miembros que quieras añadir y haz clic en Añadir miembros.
Facturación
Sección titulada “Facturación”Solo Superadministrador (org_super_admin) y Gestor de facturación (org_billing_admin) pueden gestionar la facturación. Los planes están vinculados a una organización, no a tu cuenta personal.
¿Puedo crear más de una organización?
Sección titulada “¿Puedo crear más de una organización?”Sí. Puedes crear tantas organizaciones como necesites y cambiar entre ellas usando el selector de organizaciones en la barra lateral.
¿Cómo configuro las políticas de seguridad?
Sección titulada “¿Cómo configuro las políticas de seguridad?”Los Super Admins pueden configurar la obligatoriedad de 2FA, políticas de contraseñas y la seguridad de las claves API desde el Seguridad pestaña. Ver Seguridad de la organización para más detalles.
¿Puedo dar a alguien acceso a una sola app o canal?
Sección titulada “¿Puedo dar a alguien acceso a una sola app o canal?”Sí — asígnales un rol con alcance de app (como Desarrollador de app o Lector de app) a través de la página Members o la pestaña Access de la app. Puedes ajustar aún más su acceso por canal usando los overrides de permisos de canal. Referencia de control de acceso para la lista completa de roles.
¿Cuál es la diferencia entre Admin y App Admin?
Sección titulada «¿Cuál es la diferencia entre Admin y App Admin?»Administrador (org_admin) tiene autoridad sobre toda la organización: todas las apps, todos los canales y todos los miembros. Admin de app (app_admin) tiene el mismo nivel de control, pero solo sobre una app específica y sus canales. Usa App Admin cuando quieras delegar el control total de una app sin dar acceso al resto de la organización.
Continuar desde la organización
Sección titulada “Continuar desde Organization”Si estás usando Organización para planificar las operaciones del dashboard y de API, conéctalo con Resumen de API para los detalles de implementación en API Overview, Introducción para los detalles de implementación en la Introducción, Claves de API para el detalle de implementación en API Keys, Dispositivos para el detalle de implementación en Devices, y Bundles para el detalle de implementación en Bundles.