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

# Klaviyo

> Conecta Klaviyo a Iru Compliance con una clave de API privada de solo lectura y con alcance limitado para recopilar el acceso de los usuarios de la cuenta, el inventario de claves de API con sus ámbitos y los metadatos de listas y segmentos.

### Acerca de Klaviyo

Iru lee los **usuarios de la cuenta y sus permisos**, las **claves de API con sus ámbitos**, los **metadatos de listas y segmentos** y las **conexiones de integración** desde la API de Klaviyo. La autenticación usa una **clave de API privada** creada en **Configuración** → **Claves de API**. Las claves privadas de Klaviyo **se limitan al crearlas**. Concede acceso de solo lectura a los objetos que abarcan tus controles.

Iru lee **solo metadatos**. Se recopilan los nombres y la configuración de las listas y los segmentos; **no se recopilan los perfiles que contienen**.

### Cómo funciona

```http theme={null}
Authorization: Klaviyo-API-Key YOUR_PRIVATE_API_KEY
revision: 2024-10-15
```

Klaviyo usa un **esquema de autorización personalizado**: el valor del encabezado lleva el prefijo `Klaviyo-API-Key`, no `Bearer`. Cada solicitud también requiere un encabezado **`revision`** con una fecha ISO 8601 que fija la versión de la API. Klaviyo versiona su API mediante revisiones fechadas en lugar de un segmento de ruta, y se rechaza cualquier solicitud sin una revisión válida. Iru establece la revisión; tú solo proporcionas la clave.

Las solicitudes se dirigen a `https://a.klaviyo.com/api`. No hay ningún subdominio ni host de cuenta que configurar. La clave de API **pública** (un ID de empresa corto que se usa en llamadas de suscripción del lado del cliente) es una credencial diferente y no sirve para autenticarse aquí.

| Detalle | Valor |
| - | - |
| **Categoría** | Marketing |
| **Autenticación** | Klaviyo-API-Key (clave de API privada) |

Referencias oficiales: [Autenticar solicitudes a la API](https://developers.klaviyo.com/en/docs/authenticate_), [Política de versiones y obsolescencia de la API](https://developers.klaviyo.com/en/docs/api_versioning_and_deprecation_policy).

### Requisitos previos

* Un rol de cuenta que pueda **administrar claves de API** en Klaviyo.
* Decide qué entra en el alcance. Klaviyo te permite excluir la supervisión de listas y segmentos, y los objetos excluidos no generan evidencia.

### Conectar Klaviyo a Iru

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

    <Steps>
      <Step title="Inicia sesión en Klaviyo">
        Inicia sesión en Klaviyo con una cuenta que pueda administrar claves de API.
      </Step>

      <Step title="Abre Settings">
        Abre el **menú de la cuenta** en la esquina inferior izquierda y, a continuación, selecciona **Configuración**.
      </Step>

      <Step title="Abre Claves de API">
        Ve a **Claves de API**.
      </Step>

      <Step title="Crea una clave de API privada">
        Selecciona **Create private API key**.
      </Step>

      <Step title="Asigna un nombre y un alcance a la clave">
        Introduce una etiqueta como **Iru Compliance** para poder auditar la integración más adelante. Establece el acceso de la clave en **solo lectura**. Usa **ámbitos personalizados** y concede acceso de lectura solo a los objetos que abarca tu programa de cumplimiento. Accounts, Lists y Segments cubren la evidencia que recopila Iru. No concedas acceso completo ni ningún ámbito de escritura.
      </Step>

      <Step title="Crea y copia la clave">
        Crea la clave y copia el valor **una sola vez** mientras Klaviyo lo muestra.
      </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 [**Klaviyo**](#klaviyo).
    </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 Klaviyo">
        Busca **Klaviyo** (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="Pega la clave de API privada">
        Pega la **clave de API privada**.
      </Step>

      <Step title="Finaliza la conexión">
        Selecciona **Enviar credenciales**. 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 **Klaviyo** 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="La autenticación falla">
    Confirma que creaste una clave **privada**, no una pública. La clave pública es un ID de empresa corto que se usa para llamadas del lado del cliente y no autentica una solicitud de servidor a servidor.
  </Accordion>

  <Accordion title="403 en algunos objetos">
    La clave privada se creó con **ámbitos personalizados** que los excluyen. Los ámbitos de Klaviyo se fijan al crear la clave. Crea una clave nueva con los ámbitos que necesitas.
  </Accordion>

  <Accordion title="Faltan listas y segmentos">
    O bien la clave no tiene acceso de lectura a ellos, o bien la supervisión de listas y segmentos está fuera del alcance de esta conexión.
  </Accordion>

  <Accordion title="No aparecen los datos de los perfiles">
    Es lo esperado. Iru recopila los **metadatos** de listas y segmentos, no los perfiles que contienen.
  </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="Introducción a 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="Gestión de artefactos" icon="folder-open" href="/es/compliance/artifacts-management">
    Sube, revisa y organiza la evidencia de fuentes y acciones.
  </Card>
</CardGroup>