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

# Permisos y Roles

> Entendiendo los permisos de usuario y control de acceso en Meetzy.

## Descripción General

Meetzy utiliza un sistema basado en permisos para controlar lo que cada miembro del equipo puede hacer dentro de la plataforma. Los permisos se asignan individualmente al invitar o editar miembros.

## Rol de Administrador de Cuenta

Además de los permisos individuales, un miembro puede ser promovido a **Administrador de cuenta**. Este rol le otorga acceso a las secciones de gestión del equipo y de tokens, exactamente igual que el propietario de la cuenta.

<Info>
  Un miembro promovido a Administrador de cuenta puede acceder a **Team** (gestión de miembros) y a **Token Manager**, sin importar los permisos individuales que tenga activados en las secciones anteriores.
</Info>

Ten en cuenta que este rol amplía específicamente el acceso a esas dos áreas de gestión de cuenta. El resto de permisos (edición de agentes, Editor Avanzado, CRM, grabaciones, minutos facturables, campañas de WhatsApp y acceso a agentes) sigue funcionando de forma independiente y debe configurarse por separado según lo que ese miembro necesite hacer.

<Warning>
  Otorga el rol de Administrador de cuenta con cuidado. Un Administrador de cuenta puede invitar, editar y eliminar a otros miembros del equipo, así como gestionar los tokens de la cuenta.
</Warning>

## Permisos Disponibles

### Can Edit Agents

| Estado        | Nivel de Acceso                                               |
| ------------- | ------------------------------------------------------------- |
| ✅ Activado    | Puede modificar configuraciones, prompts y ajustes de agentes |
| ❌ Desactivado | Acceso solo de lectura a agentes asignados                    |

Los miembros con este permiso pueden:

* Editar nombres y configuraciones básicas de agentes
* Modificar saludos y prompts
* Configurar parámetros de entrada/salida
* Cambiar configuraciones de voz

### Can Use Advanced Editor

| Estado        | Nivel de Acceso                            |
| ------------- | ------------------------------------------ |
| ✅ Activado    | Acceso completo al Editor Avanzado         |
| ❌ Desactivado | Limitado a configuración básica de agentes |

Los miembros con este permiso pueden:

* Acceder a todos los paneles del Editor Avanzado
* Configurar documentos de Knowledge Base
* Configurar Actions & Tools (webhooks, transferencias)
* Usar el Playground para pruebas
* Acceder al asistente Copilot
* Gestionar historial de versiones y ramas
* Publicar cambios a producción

<Tip>
  Activa "Can use advanced editor" para miembros del equipo que necesiten hacer cambios sustanciales en el comportamiento del agente.
</Tip>

### Can Access CRM

| Estado        | Nivel de Acceso                 |
| ------------- | ------------------------------- |
| ✅ Activado    | Acceso completo a funciones CRM |
| ❌ Desactivado | Sin acceso al menú CRM          |

Los miembros con este permiso pueden:

* Ver y gestionar contactos
* Importar contactos desde archivos o Google Sheets
* Crear y gestionar segmentos
* Programar y monitorear campañas
* Exportar datos de contactos

<Note>
  El acceso CRM solo es visible si tu cuenta tiene funciones CRM habilitadas. El administrador debe tener acceso CRM para otorgarlo a otros miembros.
</Note>

### Can View Billable Minutes

| Estado        | Nivel de Acceso                            |
| ------------- | ------------------------------------------ |
| ✅ Activado    | Puede ver información de uso y facturación |
| ❌ Desactivado | Sin acceso a datos de facturación          |

Los miembros con este permiso pueden:

* Ver estadísticas de duración de llamadas
* Ver consumo de minutos facturables
* Acceder a reportes de uso

### Can View Recordings

| Estado        | Nivel de Acceso                        |
| ------------- | -------------------------------------- |
| ✅ Activado    | Puede escuchar grabaciones de llamadas |
| ❌ Desactivado | Sin acceso a grabaciones de audio      |

Los miembros con este permiso pueden:

* Reproducir grabaciones desde los detalles de llamada
* Descargar grabaciones (si está habilitado)

<Warning>
  Ten cuidado al otorgar acceso a grabaciones. Las grabaciones de llamadas pueden contener información sensible del cliente.
</Warning>

### Can Send WhatsApp Campaigns

| Estado        | Nivel de Acceso                                       |
| ------------- | ----------------------------------------------------- |
| ✅ Activado    | Puede crear y gestionar campañas de WhatsApp outbound |
| ❌ Desactivado | Sin acceso a funciones de campañas de WhatsApp        |

Los miembros con este permiso pueden:

* Enviar mensajes de WhatsApp outbound via la API
* Crear y monitorear campañas de WhatsApp
* Ver el estado de campañas y detalles de destinatarios
* Cancelar campañas en progreso

<Note>
  Las campañas de WhatsApp requieren un número de teléfono de WhatsApp Business configurado en el asistente. Contacta a tu administrador para configurar la integración de WhatsApp.
</Note>

## Acceso a Nivel de Agente

Además de los permisos de funcionalidad, controlas a qué agentes puede acceder cada miembro:

| Tipo de Acceso      | Descripción                                                                    |
| ------------------- | ------------------------------------------------------------------------------ |
| **Acceso Completo** | El miembro puede ver llamadas y editar el agente (si los permisos lo permiten) |
| **Sin Acceso**      | El agente está oculto para el miembro                                          |

### Cómo Funciona el Acceso a Agentes

1. Los miembros solo ven agentes asignados a ellos
2. El historial de llamadas se filtra para mostrar solo llamadas de agentes asignados
3. Los datos CRM son accesibles a través de todos los agentes asignados
4. Los reportes muestran datos solo de agentes asignados

## Combinaciones de Permisos

Aquí hay combinaciones comunes de permisos para diferentes roles:

### Viewer (Solo Lectura)

* ❌ Can edit agents
* ❌ Can use advanced editor
* ❌ Can access CRM
* ❌ Can view billable minutes
* ✅ Can view recordings

Ideal para: Líderes de equipo que necesitan monitorear llamadas sin hacer cambios.

### Agent Operator

* ✅ Can edit agents
* ❌ Can use advanced editor
* ❌ Can access CRM
* ❌ Can view billable minutes
* ✅ Can view recordings

Ideal para: Miembros del equipo que manejan configuración básica de agentes.

### Agent Developer

* ✅ Can edit agents
* ✅ Can use advanced editor
* ❌ Can access CRM
* ❌ Can view billable minutes
* ✅ Can view recordings

Ideal para: Miembros técnicos responsables del desarrollo de agentes.

### Campaign Manager

* ❌ Can edit agents
* ❌ Can use advanced editor
* ✅ Can access CRM
* ❌ Can view billable minutes
* ✅ Can view recordings
* ✅ Can send WhatsApp campaigns

Ideal para: Miembros de marketing o ventas que gestionan campañas salientes.

### Acceso Completo

* ✅ Can edit agents
* ✅ Can use advanced editor
* ✅ Can access CRM
* ✅ Can view billable minutes
* ✅ Can view recordings
* ✅ Can send WhatsApp campaigns

Ideal para: Administradores de cuenta y miembros senior del equipo.

<Info>
  Recuerda que, además de estos permisos, un miembro puede tener adicionalmente el rol de **Administrador de cuenta**, lo cual le da acceso a Team y Token Manager sin necesidad de otro permiso específico.
</Info>

## Sincronizar Permisos

Si los permisos de un miembro parecen incorrectos, los administradores pueden sincronizar sus claims de Firebase:

1. Encuentra al miembro en la lista
2. Haz clic en el botón **Sync Claims** (solo visible para usuarios con editor avanzado)
3. Confirma la sincronización

Esto actualiza los tokens de autenticación del miembro con los permisos más recientes de la base de datos.

## FAQ

<AccordionGroup>
  <Accordion title="¿Puedo crear roles personalizados?">
    Actualmente, Meetzy usa permisos individuales en lugar de roles predefinidos. Puedes combinar permisos para crear cualquier nivel de acceso que necesites.
  </Accordion>

  <Accordion title="¿Qué diferencia hay entre el rol de Administrador de cuenta y los permisos individuales?">
    El rol de Administrador de cuenta es independiente de los permisos individuales (editar agentes, CRM, grabaciones, etc.). Solo determina si el miembro puede acceder a **Team** y **Token Manager** para gestionar al resto del equipo y los tokens de la cuenta. El resto de capacidades se sigue controlando con los toggles de permisos descritos arriba.
  </Accordion>

  <Accordion title="¿Por qué no puedo ver el toggle de permiso CRM?">
    El toggle de permiso CRM solo es visible si tú (como administrador) tienes acceso CRM habilitado en tu propia cuenta.
  </Accordion>

  <Accordion title="¿Los permisos aplican inmediatamente?">
    Sí, los cambios de permisos tienen efecto inmediato. Los miembros pueden necesitar refrescar su navegador para ver el acceso actualizado.
  </Accordion>

  <Accordion title="¿Puede un miembro tener acceso a agentes de múltiples empresas?">
    Sí, para cuentas multi-empresa, puedes asignar agentes de cualquier empresa. Los agentes están organizados por compañía en la lista de selección.
  </Accordion>
</AccordionGroup>
