> ## 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.

# Freshsales

> Conecta Freshsales a Iru Compliance con una clave de API y un alias de bundle para recopilar roles de usuario, matrices de permisos y controles de acceso basados en territorios.

### Acerca de Freshsales

Iru lee los **usuarios con sus roles**, los **roles con sus permisos**, los **territorios** y los **permisos a nivel de campo para datos confidenciales** desde la API de Freshsales (Freshworks CRM). La autenticación usa una **clave de API** junto con tu **alias de bundle**, ambos disponibles en **Profile Settings** → **API Settings**. Las solicitudes se dirigen a `https://YOUR_BUNDLE_ALIAS.myfreshworks.com/crm/sales/api`. El asistente del conector solicita primero la **clave de API** y luego el **alias de bundle**.

Freshsales y **Freshservice** son productos distintos con **esquemas de autenticación diferentes**. Si vas a conectar datos de gestión de servicios de TI, usa en su lugar el artículo de [Freshservice](/es/compliance/sources/freshservice-source).

### Cómo funciona

```http theme={null}
Authorization: Token token=YOUR_API_KEY
```

Freshsales **no** usa autenticación Basic ni un prefijo Bearer. La clave se incluye en el encabezado `Authorization` con la forma literal `Token token=YOUR_API_KEY`. La API **no tiene versiones**. No hay encabezado de versión ni revisión fechada.

El **alias de bundle** selecciona qué cuenta de CRM leer cuando tu organización de Freshworks tiene más de una. Por eso el campo es obligatorio. Una clave de API es **por usuario** y hereda **exactamente el rol de ese usuario**, sin ámbitos por endpoint.

| Detalle | Valor |
| - | - |
| **Categoría** | CRM |
| **Autenticación** | Token (clave de API + alias de bundle) |

Referencias oficiales: [API de Freshworks CRM](https://developers.freshworks.com/crm/api/).

### Requisitos previos

* Tu **alias de bundle** y tu **clave de API**, ambos en la misma página **API Settings**.
* Un **usuario de CRM dedicado con nivel de administrador** desde el que generar la clave. La clave hereda el rol de ese usuario y no tiene ámbitos, por lo que una clave de un usuario de ventas con restricciones de territorio devuelve una imagen incompleta de los permisos.

### Conectar Freshsales a Iru

<Tabs>
  <Tab title="Freshsales">
    <Note>
      Completa esta pestaña antes de conectar la fuente en Compliance.
    </Note>

    <Steps>
      <Step title="Inicia sesión en Freshsales">
        Inicia sesión en tu cuenta de Freshsales como el **usuario con nivel de administrador** cuyo acceso debe heredar la integración.
      </Step>

      <Step title="Abre Profile Settings">
        Selecciona tu **foto de perfil** en la esquina superior derecha y, a continuación, **Profile Settings**.
      </Step>

      <Step title="Abre API Settings">
        Selecciona la pestaña **API Settings**.
      </Step>

      <Step title="Copia la clave de API y el alias de bundle">
        Copia el valor que aparece en **Your API key**. Copia el **Bundle alias**, que aparece en la misma pestaña justo debajo de la clave de API. Es obligatorio aunque tu organización solo tenga una cuenta de CRM.
      </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 [**Freshsales**](#freshsales).
    </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 Freshsales">
        Busca **Freshsales** (usa **Categoría** o **Buscar por nombre o descripción**). En esa tarjeta, activa el **interruptor**. Es posible que se abra una pestaña o ventana del navegador para el asistente del conector.
      </Step>

      <Step title="Introduce la clave de API">
        El primer paso del asistente es **Enter API Key (Authorization)**. Pega la clave de API en el campo **Authorization**. El asistente muestra el formato del encabezado `Token token=<api_key>`.
      </Step>

      <Step title="Envía la clave de API">
        Selecciona **Enviar clave de API**.
      </Step>

      <Step title="Introduce el alias de bundle">
        Introduce solo el **alias de bundle** (por ejemplo, `acme`, no la URL completa de `myfreshworks.com`). Confirma la URL de vista previa si el asistente muestra una. Cuando la conexión se realiza correctamente, 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 de **Freshsales** 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="401 Authentication Failure">
    Confirma que la clave de API esté completa y que el **alias de bundle** coincida con la cuenta de CRM a la que pertenece la clave. Una clave válida con el host de bundle incorrecto falla de la misma forma que una clave no válida.
  </Accordion>

  <Accordion title="Copiaste una clave de Freshservice por error">
    Los dos productos emiten credenciales diferentes y se autentican de forma distinta. Una clave de Freshservice no funcionará aquí.
  </Accordion>

  <Accordion title="Aparecen usuarios, pero los roles o territorios están incompletos">
    La clave pertenece a un usuario cuyo propio rol no puede verlos. Vuelve a generarla desde un usuario con nivel de administrador.
  </Accordion>

  <Accordion title="El asistente informa de un host inaccesible">
    El alias de bundle es solo el subdominio. No incluyas `https://` ni `.myfreshworks.com`.
  </Accordion>
</AccordionGroup>

### Artículos relacionados

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

  <Card title="Freshservice" icon="headset" href="/es/compliance/sources/freshservice-source">
    Conecta Freshservice para obtener evidencia de ITSM.
  </Card>

  <Card title="Introducción a Compliance" icon="rocket" href="/es/compliance/getting-started-with-compliance">
    Marcos, acciones y **Artefactos**.
  </Card>

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