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

# Salsify を Profound に接続する

> Salsify インテグレーションをセットアップし、Profound Agents に接続する方法のガイド

このガイドでは、Salsify 組織を Profound に接続する手順を説明します。接続すると、Profound Agents で Salsify の Product Lists を操作できるようになります。

<Note>
  Profound は組織レベルで Salsify に接続します。1 つの接続済みアカウントにより、Profound 組織内のすべての Agent が 1 つの Salsify 組織にアクセスできるようになります。その際の権限は、API キーを所有する Salsify ユーザーの権限です。
</Note>

## 始める前に

以下が必要です。

* ユーザー、API キー、Product Lists を作成する権限を持つ [Salsify](https://www.salsify.com/) アカウント
* [Profound](https://www.tryprofound.com/) アカウント

## セットアップガイド

<Steps>
  <Step title="Profound 用の Salsify ユーザーを作成する" id="step-1">
    Profound は Salsify 内で API キーを所有するユーザーとして動作するため、Salsify はすべてのリクエストにそのユーザーの権限を適用します。

    * Salsify で、インテグレーション専用の[ユーザーを作成](https://help.salsify.com/ProductXM/s/article/manage-users-and-roles)します(例: `profound-integration@yourcompany.com`)。
    * Profound で使用したい商品と Product Lists にのみ、そのユーザーのアクセス権を付与します。

    <Note>
      Profound 専用のユーザーを作成すると、インテグレーションを 1 か所で切り替えられるため、おすすめの方法です。Salsify でそのユーザーを無効にすると、インテグレーション全体が無効になります。
    </Note>
  </Step>

  <Step title="API キーをコピーする" id="step-2">
    * [ステップ 1](#step-1) のユーザーとして Salsify にサインインします。
    * ユーザープロファイルメニューを開き、**API Access** を選択します。
    * **Show API key** を選択してキーをコピーし、シークレットマネージャーに安全に保管します。
  </Step>

  <Step title="組織 ID をコピーする" id="step-3">
    組織 ID は、Salsify の URL で `/orgs/` の後に続く部分です。例:

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

    組織 ID をコピーし、後のステップで使用できるように控えておきます。
  </Step>

  <Step title="Product List ID をコピーする" id="step-4">
    Profound は Product Lists から商品を読み取り、Product Lists にメンバーシップの変更を書き込みます。Salsify の API では Profound がリストを作成できないため、Salsify のドキュメント [Creating Product Lists](https://help.salsify.com/ProductXM/s/article/creating-new-products-lists) の説明に従って、先に Salsify でリストを作成してください。

    リストの準備ができたら、リストを開き、URL の `product_lists/` の後に続く部分から ID をコピーします。

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

    組織によって、Product List ID は数値か、`s-` プレフィックス付きの UUID(例: `s-123a-456b-789c-...`)のいずれかです。Profound はどちらにも対応しています。

    ID をコピーし、後のステップで使用できるように控えておきます。
  </Step>

  <Step title="Salsify を Profound に接続する" id="step-5">
    * Profound で、プラットフォームの左上にある組織名を選択し、**Settings** を選択します。
    * 左サイドバーで、**Account** の下にある **Integrations** を選択します。
    * **Salsify** を検索して選択し、**+ Add account** を選択します。
    * **Connect Salsify** ダイアログで、[ステップ 2](#step-2) の **Salsify API key** と [ステップ 3](#step-3) の **Organization ID** を入力します。
    * **Connect account** を選択します。

    Agent ビルダーから直接 Salsify を接続することもできます。Salsify ノードを追加し、ノード設定で **Salsify Organization** ドロップダウンを開いて、**+ Add integration** を選択します。

    接続済みアカウントの一覧に Salsify 組織が表示されていれば、接続は成功です。
  </Step>

  <Step title="接続を確認する" id="step-6">
    Agents が使用する商品に Salsify ユーザーがアクセスできることを確認するには、Agent ビルダーでノードをテストします。

    * Profound で[新しい Agent を作成](https://help.tryprofound.com/articles/2212787792-create-an-agent)するか、既存の Agent の下書きを開きます。
    * Salsify の [**List Products**](/ja-jp/integrations/salsify/using-salsify-in-agents#list-products) ノードを追加し、接続済みの Salsify 組織を選択します。
    * **Product Lists** に、[ステップ 4](#step-4) のソースリスト ID を入力します。
    * **Test node**(再生 <Icon icon="play" /> アイコン)を選択し、想定どおりの商品が出力に含まれていることを確認します。
    * Profound Agents で商品やリストを更新する予定がある場合は、[**Update Products**](/ja-jp/integrations/salsify/using-salsify-in-agents#update-products)、[**Add Products to List**](/ja-jp/integrations/salsify/using-salsify-in-agents#add-products-to-list)、[**Remove Products from List**](/ja-jp/integrations/salsify/using-salsify-in-agents#remove-products-from-list) の各ノードも同じ方法でテストします。
  </Step>
</Steps>

## アクセスの更新または取り消し

* API キーまたは組織 ID を置き換えるには、Profound の設定で **Integrations** > **Salsify** に戻り、接続済みアカウントのアクション **...** メニューで **Edit credentials** を選択し、新しい値を入力して **Update** を選択します。
* Profound のアクセスを取り消すには、同じメニューで **Revoke** を選択します。Salsify を再度接続するまで、Salsify の Agent ノードは実行されなくなります。

## トラブルシューティング

<AccordionGroup>
  <Accordion title="Salsify のプロファイルメニューに API Access タブがない">
    お使いの Salsify ユーザーに API の使用権限がありません。Salsify 管理者に権限の付与を依頼するか、Profound インテグレーション用のユーザーの作成を依頼してください。
  </Accordion>

  <Accordion title="Profound で認証情報を保存できない">
    * API キー全体をコピーしたことを確認してください。
    * キーを所有する Salsify ユーザーが[無効化](https://help.salsify.com/ProductXM/s/article/disable-user)されていないことを確認してください。ユーザーを無効化すると Salsify へのアクセス権が削除され、その API キーも機能しなくなります。
    * **Organization ID** が(組織名ではなく)URL の `/orgs/` の後に続く部分であること、および API キーと同じ組織のものであることを確認してください。
  </Accordion>

  <Accordion title="接続は保存されるが、ノードがアクセス拒否を報告する">
    Agent が使用する商品やリストを操作する権限が Salsify ユーザーにない場合に発生することがあります。Salsify で、Profound 用ユーザーの[権限を確認](https://help.salsify.com/ProductXM/s/article/granular-user-group-level-permissions)してください。
  </Accordion>

  <Accordion title="Salsify のレート制限に達したとノードが報告する">
    Salsify は、一定時間内に受け付けるリクエスト数を制限しています。エラーには、制限がリセットされるまでの残り秒数が表示されます。しばらく待ってから、Agent を再度実行してください。

    リクエスト数を減らすには、1 ページあたりに読み取る商品数を増やし、同時に実行する Salsify ノードの数を減らしてください。
  </Accordion>

  <Accordion title="Salsify へのリクエストがタイムアウトする、または接続できない">
    タイムアウトは一時的なものであることが多いため、ノードを再度実行すれば解決するはずです。Salsify 組織が許可リストに登録された IP アドレスからのリクエストのみを受け付ける場合は、Profound のアカウントチームに依頼して、組織の Salsify リクエストを静的 IP アドレス経由でルーティングしてもらってください。
  </Accordion>
</AccordionGroup>