Skip to main content
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.
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.

​
Antes de empezar

Necesitarás:
  • Una cuenta de Salsify con permisos para crear usuarios, API keys y Product Lists
  • Una cuenta de Profound

​
Guía de configuración

1

Crea un usuario de Salsify para Profound

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

Copia la API key

  • Inicia sesión en Salsify como el usuario del paso 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.
3

Copia el ID de organización

El ID de organización es el segmento de cualquier URL de Salsify que sigue a /orgs/. Por ejemplo:
Copia tu ID de organización y tenlo a mano para usarlo en los pasos siguientes.
4

Copia los IDs de las Product Lists

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 de Salsify.Cuando tengas la lista lista, ábrela y copia el ID del segmento de la URL que sigue a product_lists/:
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.
5

Conecta Salsify a Profound

  • 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 y el Organization ID del paso 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.
6

Verifica la conexión

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 o abre un borrador de Agent existente.
  • Añade el nodo List Products de Salsify y luego selecciona la organización de Salsify conectada.
  • Introduce el ID de la lista de origen del paso 4 en Product Lists.
  • Selecciona Test node (el icono de reproducción ) 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, Add Products to List y Remove Products from List.

​
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

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.
  • Comprueba que copiaste la API key completa.
  • Confirma que nadie ha desactivado el usuario de Salsify 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.
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 del usuario de Profound.
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.
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.