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

# Permisos de usuario y roles

> Controla qué puede ver y hacer cada agente en Shimli con permisos granulares por módulo.

Shimli permite definir **permisos granulares** por agente para controlar exactamente a qué módulos y funciones tiene acceso cada persona de tu equipo. Esto reemplaza la práctica de dar acceso de administrador a todos.

## Por qué usar permisos

<Callout type="warning">
  Dar cuenta de administrador a todos los agentes es un riesgo de seguridad y operativo. Con permisos granulares puedes restringir el acceso a módulos sensibles sin limitar la productividad del equipo.
</Callout>

Beneficios:

* **Principio de mínimo privilegio**: cada agente ve solo lo que necesita.
* **Protección de datos**: restringe quién puede ver bases de datos de contactos.
* **Control de campañas**: limita quién puede crear y enviar campañas masivas.
* **Auditoría**: cada acción queda asociada al agente que la ejecutó.

## Cómo configurar permisos

<Steps>
  <Step title="Ve a la sección de Agentes">
    Accede a **Configuración → Agentes**. Verás la lista de todos los agentes de tu cuenta.
  </Step>

  <Step title="Edita un agente">
    Haz clic en el agente que quieres configurar y selecciona **Editar**.
  </Step>

  <Step title="Asigna permisos por módulo">
    Para cada módulo, activa o desactiva el acceso:

    * **Bases de datos**: ver y gestionar listas de contactos.
    * **Marketing**: crear y enviar campañas de WhatsApp y email.
    * **Inbox**: atender conversaciones.
    * **CRM**: ver y gestionar leads y clientes.
    * **Plantillas**: crear y gestionar plantillas de WhatsApp y email.
    * **Configuración**: cambios a nivel de cuenta.
  </Step>

  <Step title="Guarda los cambios">
    Los permisos se aplican inmediatamente. El agente verá solo los módulos habilitados en su menú lateral.
  </Step>
</Steps>

## Modos de acceso

Puedes configurar cada agente de dos maneras:

| Modo                       | Descripción                                                                      |
| -------------------------- | -------------------------------------------------------------------------------- |
| **Administrador completo** | Acceso a todo. Úsalo solo para roles de IT o dirección.                          |
| **Acceso restringido**     | Acceso solo a los módulos seleccionados. Recomendado para la mayoría del equipo. |

<Callout type="info">
  Un caso de uso común: darle acceso solo a **Marketing** al equipo de campañas, para que creen y envíen campañas sin poder tocar configuración de la cuenta ni ver bases de datos completas.
</Callout>

## Métricas por agente

Cada agente tiene su propio panel de métricas que muestra:

* **Conversaciones atendidas**: cuántas conversaciones ha gestionado.
* **Mensajes enviados**: volumen de mensajes del agente.
* **Eficiencia**: métrica de rendimiento calculada por Shimli.
* **Conversaciones abiertas**: cuántas tiene activas en este momento.

Estas métricas se pueden **filtrar por tiempo** (hoy, esta semana, este mes, rango personalizado) para evaluar el desempeño en distintos periodos.

<Callout type="info">
  Las métricas por agente también alimentan el dashboard del CRM, donde puedes comparar el rendimiento de todo el equipo en un solo vistazo. Ve a [CRM Dashboard](/guides/crm-dashboard) para más detalle.
</Callout>

## Roles especiales

### Supervisor de inbox

El rol de **supervisor** puede monitorear y gestionar conversaciones del inbox sin ser un agente asignado. Ideal para equipos de quality assurance y soporte de segundo nivel.

### Agente de WhatsApp

Agente que atiende conversaciones de WhatsApp. Puede tener acceso a:

* Inbox (conversaciones asignadas).
* CRM (ficha del contacto).
* Plantillas (si tiene el permiso).

<Accordions>
  <Accordion title="¿Puedo cambiar los permisos de un agente en cualquier momento?">
    Sí. Ve a Configuración → Agentes, edita el agente y ajusta los permisos. Los cambios se aplican inmediatamente.
  </Accordion>

  <Accordion title="¿Qué pasa si le quito el acceso a un módulo a un agente que está usándolo?">
    El módulo desaparece de su menú lateral. Si estaba en una página de ese módulo, será redirigido. No se pierden datos, solo se restringe el acceso.
  </Accordion>

  <Accordion title="¿Puedo crear roles personalizados?">
    Actualmente los permisos se configuran por agente, seleccionando los módulos a los que tiene acceso. Si necesitas roles predefinidos, configúralos como plantillas internas de tu organización.
  </Accordion>
</Accordions>