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

# Conecta Salsify a Profound

> Una guía sobre cómo configurar la integración con Salsify y conectarla a los Profound Agents

Esta guía te muestra cómo conectar tu organización de Salsify a Profound. Una vez conectada, los Profound Agents pueden trabajar con tus Product Lists de Salsify.

<Note>
  Profound se conecta a Salsify a nivel de organización. Una cuenta conectada da a todos los Agents de tu organización de Profound acceso a una organización de Salsify, con los permisos del usuario de Salsify propietario de la API key.
</Note>

## Antes de empezar

Necesitarás:

* Una cuenta de [Salsify](https://www.salsify.com/) con permisos para crear usuarios, API keys y Product Lists
* Una cuenta de [Profound](https://www.tryprofound.com/)

## Guía de configuración

<Steps>
  <Step title="Crea un usuario de Salsify para Profound" id="step-1">
    Profound actúa en Salsify como el usuario propietario de la API key, por lo que Salsify aplica los permisos de ese usuario a cada solicitud.

    * En Salsify, [crea un usuario dedicado](https://help.salsify.com/ProductXM/s/article/manage-users-and-roles) para la integración, por ejemplo `profound-integration@yourcompany.com`.
    * Da al usuario acceso solo a los productos y Product Lists que quieras usar con Profound.

    <Note>
      Crear un usuario dedicado para Profound es una buena práctica porque te da un único interruptor para la integración: desactivar ese usuario en Salsify desactiva toda la integración.
    </Note>
  </Step>

  <Step title="Copia la API key" id="step-2">
    * Inicia sesión en Salsify como el usuario del [paso 1](#step-1).
    * Abre el menú de tu perfil de usuario y selecciona **API Access**.
    * Selecciona **Show API key**, copia la clave y guárdala de forma segura en tu gestor de secretos.
  </Step>

  <Step title="Copia el ID de organización" id="step-3">
    El ID de organización es el segmento de cualquier URL de Salsify que sigue a `/orgs/`. Por ejemplo:

    ```text wrap theme={null}
    https://app.salsify.com/app/orgs/<ORGANIZATION_ID>/products
    ```

    Copia tu ID de organización y tenlo a mano para usarlo en los pasos siguientes.
  </Step>

  <Step title="Copia los IDs de las Product Lists" id="step-4">
    Profound lee productos de las Product Lists y escribe en ellas los cambios de pertenencia. La API de Salsify no permite que Profound cree listas por ti, así que créalas primero en Salsify siguiendo la documentación [Creating Product Lists](https://help.salsify.com/ProductXM/s/article/creating-new-products-lists) de Salsify.

    Cuando tengas la lista lista, ábrela y copia el ID del segmento de la URL que sigue a `product_lists/`:

    ```text wrap theme={null}
    https://app.salsify.com/app/orgs/s-1a2b3c4d5e6f7890/product_lists/<PRODUCT_LIST_ID>
    ```

    Según tu organización, un ID de Product List es un número o un UUID con el prefijo `s-` (por ejemplo, `s-123a-456b-789c-...`). Profound acepta ambos.

    Copia el ID y tenlo a mano para usarlo en los pasos siguientes.
  </Step>

  <Step title="Conecta Salsify a Profound" id="step-5">
    * En Profound, selecciona el nombre de tu organización en la esquina superior izquierda de la plataforma y luego selecciona **Settings**.
    * En la barra lateral izquierda, selecciona **Integrations** en **Account**.
    * Busca **Salsify**, selecciónalo y luego selecciona **+ Add account**.
    * En el cuadro de diálogo **Connect Salsify**, introduce la **Salsify API key** del [paso 2](#step-2) y el **Organization ID** del [paso 3](#step-3).
    * Selecciona **Connect account**.

    También puedes conectar Salsify directamente en el Agent builder. Añade un nodo de Salsify, abre el menú desplegable **Salsify Organization** en la configuración del nodo y selecciona **+ Add integration**.

    Si tu organización de Salsify aparece en la lista de cuentas conectadas, la conexión se realizó correctamente.
  </Step>

  <Step title="Verifica la conexión" id="step-6">
    Para confirmar que el usuario de Salsify puede acceder a los productos que usarán tus Agents, prueba los nodos en el Agent builder:

    * En Profound, [crea un nuevo Agent](https://help.tryprofound.com/articles/2212787792-create-an-agent) o abre un borrador de Agent existente.
    * Añade el nodo [**List Products**](/es/integrations/salsify/using-salsify-in-agents#list-products) de Salsify y luego selecciona la organización de Salsify conectada.
    * Introduce el ID de la lista de origen del [paso 4](#step-4) en **Product Lists**.
    * Selecciona **Test node** (el icono de reproducción <Icon icon="play" />) y comprueba que la salida contiene los productos que esperas.
    * Si tienes previsto actualizar productos o listas con Profound Agents, prueba del mismo modo los nodos [**Update Products**](/es/integrations/salsify/using-salsify-in-agents#update-products), [**Add Products to List**](/es/integrations/salsify/using-salsify-in-agents#add-products-to-list) y [**Remove Products from List**](/es/integrations/salsify/using-salsify-in-agents#remove-products-from-list).
  </Step>
</Steps>

## Actualizar o revocar el acceso

* Para reemplazar la API key o el ID de organización, vuelve a **Integrations** > **Salsify** en la configuración de Profound, selecciona **Edit credentials** en el menú de acciones **...** de la cuenta conectada, introduce los nuevos valores y selecciona **Update**.
* Para revocar el acceso de Profound, selecciona **Revoke** en el mismo menú. Los nodos de Agent de Salsify dejarán de ejecutarse hasta que vuelvas a conectar Salsify.

## Solución de problemas

<AccordionGroup>
  <Accordion title="Falta la pestaña API Access en el menú de tu perfil de Salsify">
    Tu usuario de Salsify no tiene permiso para usar la API. Pide a tu administrador de Salsify que te lo conceda o que cree por ti el usuario de integración de Profound.
  </Accordion>

  <Accordion title="Profound no puede guardar las credenciales">
    * Comprueba que copiaste la API key completa.
    * Confirma que nadie ha [desactivado el usuario de Salsify](https://help.salsify.com/ProductXM/s/article/disable-user) propietario de la clave. Desactivar un usuario elimina su acceso a Salsify, y su API key deja de funcionar con él.
    * Confirma que el **Organization ID** es el segmento de la URL que sigue a `/orgs/` (no el nombre de la organización) y que pertenece a la misma organización que la API key.
  </Accordion>

  <Accordion title="La conexión se guarda, pero un nodo informa que el acceso está denegado">
    Esto puede ocurrir si tu usuario de Salsify no tiene permisos para trabajar con los productos y listas que usa el Agent. En Salsify, [revisa los permisos](https://help.salsify.com/ProductXM/s/article/granular-user-group-level-permissions) del usuario de Profound.
  </Accordion>

  <Accordion title="Un nodo informa que se alcanzó el límite de solicitudes de Salsify">
    Salsify limita cuántas solicitudes acepta en un periodo de tiempo. El error indica cuántos segundos faltan para que se restablezca el límite. Espera y vuelve a ejecutar el Agent.

    Para usar menos solicitudes, lee más productos por página y ejecuta menos nodos de Salsify al mismo tiempo.
  </Accordion>

  <Accordion title="Las solicitudes a Salsify agotan el tiempo de espera o no pueden conectarse">
    Un tiempo de espera agotado suele ser temporal, por lo que volver a ejecutar el nodo debería solucionarlo. Si tu organización de Salsify solo acepta solicitudes de direcciones IP incluidas en una lista de permitidas, pide a tu equipo de cuenta de Profound que enrute las solicitudes de Salsify de tu organización a través de una dirección IP estática.
  </Accordion>
</AccordionGroup>