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

# Roles, permisos y colaboración

> Cómo funcionan los roles de equipo, permisos por propuesta, invitaciones y edición colaborativa en Quikly.ai.

Quikly tiene dos sistemas de permisos separados que trabajan juntos: los **roles de equipo** controlan lo que puedes hacer en toda la organización, y los **permisos de propuesta** controlan lo que puedes hacer en una propuesta específica.

## Roles de equipo

Cada miembro del equipo tiene exactamente un rol organizacional.

| Rol        | Quién lo asigna                 | Capacidades                                                                                                                                                                                                                  |
| ---------- | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Owner**  | Automático (creador del equipo) | Control total: facturación, configuración, miembros, tarjetas de tarifas, todas las propuestas. Solo uno por equipo.                                                                                                         |
| **Admin**  | El Owner promueve a un miembro  | Gestionar miembros (invitar, eliminar, cambiar roles), editar tarjetas de tarifas y margen de agencia, acceder a todas las propuestas y analíticas del equipo. No puede modificar la facturación ni promover a otros admins. |
| **Member** | El Owner o Admin invita         | Crear y editar sus propias propuestas, acceder a plantillas compartidas y tarjetas de tarifas, ver propuestas del equipo (sujeto a la configuración de acceso por defecto), usar la cuota de IA del equipo.                  |

<Note>
  Los roles de equipo solo determinan el acceso a nivel organizacional. Lo que un miembro puede hacer en una propuesta **específica** se controla con los permisos de propuesta (ver más abajo).
</Note>

### Cómo afecta el rol de equipo a tu suscripción

* El **owner** paga el plan Team y gestiona la facturación.
* **Admins y members** heredan acceso nivel Team automáticamente — no necesitan su propio plan pago.
* Si un miembro ya tiene una suscripción personal Pro cuando se une, Quikly envía un correo explicando que el plan Team incluye todas las funcionalidades de Pro. El miembro puede cancelar su plan Pro personal para evitar doble facturación. Quikly no lo cancela automáticamente.
* Si un miembro es eliminado del equipo (o se va voluntariamente), su suscripción personal — si sigue activa — vuelve a tener efecto inmediatamente. No se pierden datos.

## Permisos de propuesta

Cada propuesta tiene su propio nivel de permiso para cada usuario que puede acceder a ella.

| Permiso      | Qué puedes hacer                                                                                                                                                                        |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Owner**    | Control total: editar contenido, precios, configuración, compartir, colaboración y eliminación. Se asigna automáticamente a quien crea la propuesta.                                    |
| **Editor**   | Editar contenido y precios de la propuesta. No puede eliminar la propuesta ni gestionar la configuración de compartir. Solo disponible para miembros del mismo equipo que la propuesta. |
| **Reviewer** | Dejar comentarios y enviar decisiones de revisión (aprobar, solicitar cambios, rechazar). No puede editar el contenido de la propuesta.                                                 |
| **Viewer**   | Acceso de solo lectura. Puede ver la propuesta pero no puede editar, comentar ni revisar.                                                                                               |

### Cómo se resuelven los permisos de propuesta

Quikly resuelve tu permiso efectivo en una propuesta usando esta prioridad:

1. **Owner de la propuesta** — si creaste la propuesta, eres el owner independientemente de otros ajustes.
2. **Colaborador explícito** — si el owner de la propuesta te agregó como colaborador con un permiso específico (editor, reviewer o viewer), ese permiso se aplica.
3. **Admin del equipo** — si eres admin (u owner) del mismo equipo que la propuesta y no existe una entrada de colaborador explícita, obtienes acceso de **editor**.
4. **Acceso por defecto del equipo** — si eres miembro del mismo equipo y no existe una entrada de colaborador explícita, se aplica la configuración de **acceso por defecto a propuestas** del equipo (ver, revisar o editar). El owner lo configura en la configuración del equipo.
5. **Sin acceso** — si ninguno de los anteriores aplica, no puedes ver la propuesta.

<Tip>
  Los owners del equipo pueden configurar el nivel de acceso por defecto a propuestas en **Configuración → Equipo → Valores por defecto de la organización**. Las opciones son: solo ver, puede revisar, puede editar, o sin acceso (restringido).
</Tip>

### Restricción del rol editor

El permiso de **editor** solo puede asignarse a miembros activos del equipo de la propuesta. Esto asegura que los editores trabajen siempre dentro del mismo contexto organizacional — tarjetas de tarifas, roster, plantillas y lista de clientes compartidos.

Si la propuesta no pertenece a un equipo (propuesta personal), la opción de editor no está disponible al agregar colaboradores.

## Invitaciones

### Invitar a alguien a tu equipo

Los owners y admins del equipo pueden invitar nuevos miembros desde **Configuración → Equipo → Miembros**.

1. Ingresa la dirección de correo de la persona y elige un rol (**Admin** o **Member**).
2. Quikly envía un correo con un enlace de invitación.
3. El enlace redirige al invitado a la app, donde aparece un diálogo de confirmación.

<Warning>
  No puedes invitar a alguien que ya pertenece a otro equipo. Debe dejar su equipo actual primero.
</Warning>

### Aceptar una invitación

Cuando recibes una invitación de equipo, aparece una notificación en la **campanita de notificaciones** dentro de la app (además del correo). Al hacer clic en la notificación se abre un diálogo de confirmación.

**Si tienes datos personales existentes** (clientes, plantillas, leads o propuestas), el diálogo te pide elegir qué compartir con el equipo:

* **Los elementos compartidos** se migran al equipo — todos los miembros del equipo pueden verlos y usarlos.
* **Los elementos que mantienes privados** quedan archivados durante tu membresía. Son invisibles mientras estás en el equipo pero se restauran automáticamente si te vas o eres eliminado.

**Si eres un usuario completamente nuevo** sin datos existentes, la invitación se acepta automáticamente cuando te registras a través del enlace de invitación.

### Rechazar una invitación

Puedes rechazar una invitación de equipo desde el diálogo de confirmación. La invitación queda marcada como rechazada permanentemente. El owner del equipo debe enviar una nueva invitación si quiere intentarlo de nuevo.

### Qué sucede cuando te vas o eres eliminado

* Tu `team_id` se limpia. Recuperas acceso a todos los recursos personales que fueron archivados cuando te uniste.
* Tu suscripción personal (si sigue activa) vuelve a tener efecto para determinar tu nivel de plan.
* Tu tipo de perfil (freelancer, equipo o agencia) no cambia — se mantiene como estaba.
* Las propuestas que creaste mientras estabas en el equipo siguen accesibles en tu lista de propuestas personales.

## Propuestas colaborativas

Los miembros del equipo pueden trabajar juntos en propuestas a través de comentarios y revisiones.

### Comentarios

Cualquier colaborador con permiso de **reviewer** o **editor** puede dejar comentarios en una propuesta. Los comentarios están vinculados a secciones específicas y pueden ser:

* **Resueltos** por el owner de la propuesta o el autor del comentario.
* **Respondidos** por cualquier colaborador con acceso a comentarios.

Los comentarios sin resolver aparecen como un badge con contador en la propuesta dentro de la lista de propuestas y en la campanita de notificaciones.

### Revisiones

Los owners de propuestas pueden solicitar una revisión formal a cualquier colaborador. El reviewer recibe una notificación y puede:

* **Aprobar** la propuesta.
* **Solicitar cambios** con un mensaje explicando qué necesita modificarse.
* **Rechazar** la propuesta.

El estado de la revisión (pendiente, aprobado, cambios solicitados, rechazado) es visible en el encabezado de la propuesta y en la lista de propuestas.

### Página de revisión

Los reviewers acceden a la propuesta a través de una **página de revisión** dedicada que muestra la vista previa de la propuesta junto al panel de contexto de revisión con comentarios y el formulario de decisión de revisión. Los viewers ven solo la vista previa — el panel de comentarios está oculto para usuarios de solo lectura.

## Resumen de comportamiento de suscripciones

| Escenario                                  | Qué sucede                                                                                                                        |
| ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------- |
| Un usuario Free/Starter se une a un equipo | Obtiene acceso nivel Team (heredado del plan del owner).                                                                          |
| Un usuario Pro se une a un equipo          | Obtiene acceso nivel Team. Recibe un correo sobre la superposición del plan Pro — puede cancelarlo para evitar doble facturación. |
| Un usuario Lifetime se une a un equipo     | Mantiene su status Lifetime (superior a Team).                                                                                    |
| Un miembro es eliminado o se va            | La suscripción personal (si sigue activa) vuelve a tener efecto. Baja a Free si no tiene suscripción activa.                      |
| El Owner paga el plan Team                 | Todos los miembros (hasta el límite de asientos) heredan las funcionalidades del nivel Team.                                      |