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

# Equipo

> Invita usuarios a tu proyecto, gestiona sus roles y controla los permisos de acceso.

# Equipo

Desde la sección de Equipo puedes **invitar usuarios** a tu proyecto y **gestionar sus permisos**. Cada miembro tiene un rol asignado que determina qué acciones puede realizar dentro del proyecto.

Accede a esta sección desde **Ajustes > Proyecto > Equipo**.

## Invitar usuarios

Solo los **administradores** pueden invitar nuevos usuarios al proyecto.

<Steps>
  <Step title="Haz clic en Invitar usuarios">
    En la esquina superior derecha de la tabla de miembros, haz clic en **Invitar usuarios**.
  </Step>

  <Step title="Introduce el email y selecciona un rol">
    Escribe la dirección de correo del usuario y selecciona el rol que deseas asignarle (**Administrador**, **Miembro** o **Lector**).

    <Frame>
      <img src="https://mintcdn.com/diga/NsY5bDT7GVRErO7B/images/invitar-usuario.png?fit=max&auto=format&n=NsY5bDT7GVRErO7B&q=85&s=fe8c3a1b90719c585922027827493329" alt="Invitar usuarios" width="400" height="472" data-path="images/invitar-usuario.png" />
    </Frame>
  </Step>

  <Step title="Envía la invitación">
    El usuario recibirá un email con un enlace para unirse al proyecto.
  </Step>

  <Step title="El usuario acepta">
    Una vez aceptada la invitación, el usuario aparecerá en la tabla de miembros con el rol asignado.
  </Step>
</Steps>

## Gestionar miembros

Los administradores pueden realizar las siguientes acciones sobre los miembros del proyecto:

* **Cambiar el rol** de un miembro (entre Administrador, Miembro y Lector).
* **Eliminar** a un miembro del proyecto.

Para hacerlo, usa los botones de **Acciones** en la fila correspondiente de la tabla.

<Warning>
  No puedes degradar ni eliminar al **último administrador** del proyecto. Debe haber al menos un administrador en todo momento.
</Warning>

## Roles y permisos

Diga utiliza un modelo de **control de acceso basado en roles (RBAC)**. Los roles se asignan **por proyecto**, lo que significa que un mismo usuario puede tener roles diferentes en proyectos distintos.

### Administrador

Acceso completo a todos los recursos y configuraciones del proyecto.

* Gestión de agentes (crear, modificar, eliminar).
* Gestión de miembros del equipo (invitar, cambiar roles, eliminar).
* Gestión de números de teléfono (comprar, configurar, liberar).
* Gestión de facturación y suscripción.
* Gestión de claves API e integraciones.
* Acceso completo a analíticas y registros.

### Miembro

Acceso de **solo lectura** a la mayoría de recursos, con la posibilidad de operar agentes existentes.

* Ver agentes y sus configuraciones.
* Realizar llamadas con los agentes del proyecto.
* Ver llamadas, transcripciones y grabaciones.
* Ver y crear contactos.
* Acceder a reportes y estadísticas.

<Note>
  Los miembros **no pueden** crear ni modificar agentes, gestionar el equipo, acceder a la facturación ni configurar integraciones o claves API.
</Note>

### Lector

Acceso **mínimo de solo lectura**, limitado a la consulta de analíticas y registros de llamadas.

* Ver el dashboard de inicio (analíticas generales).
* Ver el registro de llamadas con transcripciones.

<Note>
  Los lectores **no pueden** ver agentes, contactos, números de teléfono, bases de conocimiento ni ninguna otra sección del proyecto. Es el rol más restrictivo disponible.
</Note>

### Permisos detallados

<AccordionGroup>
  <Accordion title="Gestión de proyectos">
    | Permiso                          | Administrador | Miembro | Lector |
    | -------------------------------- | ------------- | ------- | ------ |
    | Ver información del proyecto     | ✓             | ✓       | ✗      |
    | Actualizar detalles del proyecto | ✓             | ✗       | ✗      |
    | Eliminar proyecto                | ✓             | ✗       | ✗      |
  </Accordion>

  <Accordion title="Gestión de agentes">
    | Permiso           | Administrador | Miembro | Lector |
    | ----------------- | ------------- | ------- | ------ |
    | Ver agentes       | ✓             | ✓       | ✗      |
    | Crear agentes     | ✓             | ✗       | ✗      |
    | Modificar agentes | ✓             | ✗       | ✗      |
    | Eliminar agentes  | ✓             | ✗       | ✗      |
  </Accordion>

  <Accordion title="Dashboard y analíticas">
    | Permiso                           | Administrador | Miembro | Lector |
    | --------------------------------- | ------------- | ------- | ------ |
    | Ver dashboard de inicio           | ✓             | ✓       | ✓      |
    | Acceder a reportes y estadísticas | ✓             | ✓       | ✓      |
  </Accordion>

  <Accordion title="Gestión de llamadas">
    | Permiso                           | Administrador | Miembro | Lector |
    | --------------------------------- | ------------- | ------- | ------ |
    | Ver llamadas                      | ✓             | ✓       | ✓      |
    | Ver transcripciones y grabaciones | ✓             | ✓       | ✓      |
    | Iniciar llamadas                  | ✓             | ✓       | ✗      |
    | Modificar metadatos de llamadas   | ✓             | ✗       | ✗      |
    | Eliminar registros de llamadas    | ✓             | ✗       | ✗      |
  </Accordion>

  <Accordion title="Gestión de números de teléfono">
    | Permiso                 | Administrador | Miembro | Lector |
    | ----------------------- | ------------- | ------- | ------ |
    | Ver números de teléfono | ✓             | ✓       | ✗      |
    | Comprar números nuevos  | ✓             | ✗       | ✗      |
    | Configurar números      | ✓             | ✗       | ✗      |
    | Liberar números         | ✓             | ✗       | ✗      |
  </Accordion>

  <Accordion title="Gestión de contactos">
    | Permiso            | Administrador | Miembro | Lector |
    | ------------------ | ------------- | ------- | ------ |
    | Ver contactos      | ✓             | ✓       | ✗      |
    | Crear contactos    | ✓             | ✓       | ✗      |
    | Eliminar contactos | ✓             | ✗       | ✗      |
  </Accordion>

  <Accordion title="Miembros del equipo">
    | Permiso                 | Administrador | Miembro | Lector |
    | ----------------------- | ------------- | ------- | ------ |
    | Ver miembros del equipo | ✓             | ✗       | ✗      |
    | Invitar nuevos miembros | ✓             | ✗       | ✗      |
    | Cambiar roles           | ✓             | ✗       | ✗      |
    | Eliminar miembros       | ✓             | ✗       | ✗      |
  </Accordion>

  <Accordion title="Facturación">
    | Permiso                        | Administrador | Miembro | Lector |
    | ------------------------------ | ------------- | ------- | ------ |
    | Ver información de facturación | ✓             | ✗       | ✗      |
    | Gestionar suscripción          | ✓             | ✗       | ✗      |
    | Ver facturas                   | ✓             | ✗       | ✗      |
  </Accordion>

  <Accordion title="Claves API e integraciones">
    | Permiso                                    | Administrador | Miembro | Lector |
    | ------------------------------------------ | ------------- | ------- | ------ |
    | Ver claves API                             | ✓             | ✗       | ✗      |
    | Crear / modificar / revocar claves         | ✓             | ✗       | ✗      |
    | Ver integraciones                          | ✓             | ✗       | ✗      |
    | Crear / modificar / eliminar integraciones | ✓             | ✗       | ✗      |
  </Accordion>
</AccordionGroup>

### ¿Qué rol asignar?

<CardGroup cols={3}>
  <Card title="Administrador" icon="shield">
    Para quienes necesitan **control total**: propietarios del negocio, gerentes de proyecto, administradores técnicos o personal de IT.
  </Card>

  <Card title="Miembro" icon="user">
    Para quienes necesitan **operar sin modificar**: agentes de ventas, personal de soporte u operadores de call center.
  </Card>

  <Card title="Lector" icon="eye">
    Para quienes solo necesitan **consultar resultados**: supervisores, directivos o stakeholders que revisan métricas y registros de llamadas.
  </Card>
</CardGroup>

## Buenas prácticas

<AccordionGroup>
  <Accordion title="Aplica el principio de mínimo privilegio">
    Asigna a los usuarios el nivel de acceso mínimo necesario. Comienza con el rol de **Lector** si solo necesitan consultar datos, usa **Miembro** si necesitan operar y eleva a **Administrador** solo cuando sea imprescindible.
  </Accordion>

  <Accordion title="Mantén al menos dos administradores">
    Evita depender de un solo administrador. Si esa persona no está disponible, nadie podrá gestionar el proyecto.
  </Accordion>

  <Accordion title="Revisa los miembros regularmente">
    Audita periódicamente quién tiene acceso y elimina a los miembros que ya no lo necesiten.
  </Accordion>
</AccordionGroup>

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="¿Los roles son globales o por proyecto?">
    Por proyecto. Puedes ser administrador en un proyecto y miembro en otro.
  </Accordion>

  <Accordion title="¿Puedo crear roles personalizados?">
    Actualmente Diga ofrece tres roles fijos: Administrador, Miembro y Lector. Los roles personalizados podrían estar disponibles en futuras versiones.
  </Accordion>

  <Accordion title="¿Qué pasa si soy el último administrador y quiero dejar el proyecto?">
    Debes promover a otro miembro a administrador antes de poder abandonarlo.
  </Accordion>

  <Accordion title="¿Se notifica a los usuarios cuando cambia su rol?">
    Sí, los usuarios reciben una notificación cuando su rol cambia en un proyecto.
  </Accordion>
</AccordionGroup>