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

# RingCentral

> Conecta RingCentral a Iru Compliance con OAuth 2.0 y el host de plataforma que corresponde a tu cuenta para recopilar evidencia de usuarios, roles y configuración de la plataforma.

### Acerca de RingCentral

Iru usa **OAuth 2.0** (**authorization code**) con las API de **RingCentral Platform**. Los alcances de lectura habituales incluyen **ReadAccounts**, **ReadCallRecording** (metadatos) y **ReadAuditTrail**; los nombres exactos son los que aparecen en la pantalla de consentimiento. Elige **`https://platform.ringcentral.com`** (o el host **media** si tu integración lo requiere) antes de autorizar.

### Cómo funciona

Iru usa el flujo **OAuth 2.0 authorization code** de RingCentral. Después de **confirmar el servidor** o la región en el asistente, se abre una **ventana emergente del navegador** con el servidor de autorización de RingCentral. Inicias sesión, revisas los alcances solicitados y concedes el acceso; RingCentral devuelve un código que Iru intercambia por tokens de **acceso** (y de **actualización**).

| Detalle | Valor |
| - | - |
| **Categoría** | Comunicaciones |
| **Autenticación** | OAuth 2.0 |

Referencias oficiales: [Auth code flow](https://developers.ringcentral.com/guide/authentication/auth-code-flow), [Permissions](https://developers.ringcentral.com/guide/basics/permissions), [API reference](https://developers.ringcentral.com/api-reference).

### Requisitos previos

* Rol **Administrador** o **Super Admin** en la cuenta de RingCentral.
* **Ventanas emergentes** del navegador permitidas.

### Conectar RingCentral a Iru

<Tabs>
  <Tab title="RingCentral">
    <Note>
      Completa esta pestaña antes de habilitar **RingCentral** en **Iru Compliance**, para que el administrador correcto complete OAuth.
    </Note>

    <Steps>
      <Step title="Inicia sesión en la administración de RingCentral">
        Abre el [sitio web de servicio de RingCentral](https://service.ringcentral.com) (o la URL de inicio de sesión de tu marca) e inicia sesión con derechos de **Administrador** o **Super Admin**.
      </Step>

      <Step title="Confirma los derechos de API y auditoría">
        Confirma que tu plan de RingCentral incluye las capacidades **ReadAccounts**, **ReadCallRecording** (metadatos) y **ReadAuditTrail** que solicita la pantalla de consentimiento de Iru. Algunos alcances dependen del nivel del plan.
      </Step>

      <Step title="Elige el host de plataforma correcto">
        Decide si tu tenant usa **`platform.ringcentral.com`** (producción habitual) o un host **media**, y haz que coincida con lo que RingCentral documenta para la región de tu cuenta.
      </Step>

      <Step title="Permite ventanas emergentes para Iru">
        En el perfil del navegador que usarás para Compliance, permite las **ventanas emergentes** para tu nombre de host de **Iru** para que la ventana de OAuth de RingCentral no se bloquee.
      </Step>
    </Steps>

    <Note>
      Continúa en la pestaña [**Iru Compliance**](#iru-compliance).
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      Primero completa la pestaña [**RingCentral**](#ringcentral).
    </Note>

    <Steps>
      <Step title="Abre Sources">
        En Iru Compliance, en la barra de navegación izquierda, expande **Cumplimiento** y selecciona **Fuentes**.

        <Frame>
          <img src="https://mintcdn.com/iru/tI0HDLDwHj8r9Ile/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=tI0HDLDwHj8r9Ile&q=85&s=87dcef15fc17d2fb9a6e53f454e41710" alt="Navegación izquierda: Compliance expandido, Sources seleccionado" width="410" height="1024" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Activa RingCentral">
        Busca **RingCentral** (usa **Categoría** o **Buscar por nombre o descripción**). En esa tarjeta, activa el **toggle**. Es posible que se abra una pestaña o ventana del navegador para el asistente del conector.
      </Step>

      <Step title="Confirma el host de plataforma e inicia OAuth">
        Confirma el **servidor** o la región en el asistente y luego inicia **OAuth** para que se pueda abrir la ventana de consentimiento.
      </Step>

      <Step title="Inicia sesión y autoriza">
        Inicia sesión en RingCentral si se te solicita. Revisa el acceso y selecciona **Authorize** (o el botón de aprobación equivalente).
      </Step>

      <Step title="Finaliza la conexión">
        Cuando se cierra la ventana emergente de RingCentral e Iru completa el intercambio de tokens, el asistente muestra **Conexión configurada**.
      </Step>

      <Step title="Confirma que la fuente está activa">
        Cierra la pestaña del navegador **Iru está solicitando acceso a servicios externos**, luego vuelve a **Cumplimiento** → **Fuentes** y confirma que la tarjeta **RingCentral** está **Activo**.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Solución de problemas

<AccordionGroup>
  <Accordion title="No se abre nada al activar la fuente">
    Revisa la configuración del **bloqueador de ventanas emergentes** para el sitio de Iru e inténtalo de nuevo.
  </Accordion>

  <Accordion title="Acceso denegado">
    Usa una cuenta **Administrador**.
  </Accordion>

  <Accordion title="Falta la auditoría">
    Es posible que el plan no incluya acceso a la API de **auditoría**.
  </Accordion>

  <Accordion title="Sesión caducada">
    Vuelve a ejecutar OAuth desde Iru.
  </Accordion>
</AccordionGroup>

### Artículos relacionados

<CardGroup cols={2}>
  <Card title="Administración de fuentes" icon="plug" href="/es/compliance/sources-management">
    Explora y administra todas las fuentes de Compliance.
  </Card>

  <Card title="Primeros pasos con Compliance" icon="rocket" href="/es/compliance/getting-started-with-compliance">
    Marcos, acciones y **Artefactos**.
  </Card>

  <Card title="Descripción general de Iru" icon="layer-group" href="/es/iru/platform-overview/iru-overview">
    Cómo encajan Endpoint, Compliance e Identity.
  </Card>

  <Card title="Administración de Artifacts" icon="folder-open" href="/es/compliance/artifacts-management">
    Carga, revisa y organiza la evidencia de fuentes y acciones.
  </Card>
</CardGroup>