Skip to main content
このガイドでは、Salsify 組織を Profound に接続する手順を説明します。接続すると、Profound Agents で Salsify の Product Lists を操作できるようになります。
Profound は組織レベルで Salsify に接続します。1 つの接続済みアカウントにより、Profound 組織内のすべての Agent が 1 つの Salsify 組織にアクセスできるようになります。その際の権限は、API キーを所有する Salsify ユーザーの権限です。

​
始める前に

以下が必要です。
  • ユーザー、API キー、Product Lists を作成する権限を持つ Salsify アカウント
  • Profound アカウント

​
セットアップガイド

1

Profound 用の Salsify ユーザーを作成する

Profound は Salsify 内で API キーを所有するユーザーとして動作するため、Salsify はすべてのリクエストにそのユーザーの権限を適用します。
  • Salsify で、インテグレーション専用のユーザーを作成します(例: profound-integration@yourcompany.com)。
  • Profound で使用したい商品と Product Lists にのみ、そのユーザーのアクセス権を付与します。
Profound 専用のユーザーを作成すると、インテグレーションを 1 か所で切り替えられるため、おすすめの方法です。Salsify でそのユーザーを無効にすると、インテグレーション全体が無効になります。
2

API キーをコピーする

  • ステップ 1 のユーザーとして Salsify にサインインします。
  • ユーザープロファイルメニューを開き、API Access を選択します。
  • Show API key を選択してキーをコピーし、シークレットマネージャーに安全に保管します。
3

組織 ID をコピーする

組織 ID は、Salsify の URL で /orgs/ の後に続く部分です。例:
組織 ID をコピーし、後のステップで使用できるように控えておきます。
4

Product List ID をコピーする

Profound は Product Lists から商品を読み取り、Product Lists にメンバーシップの変更を書き込みます。Salsify の API では Profound がリストを作成できないため、Salsify のドキュメント Creating Product Lists の説明に従って、先に Salsify でリストを作成してください。リストの準備ができたら、リストを開き、URL の product_lists/ の後に続く部分から ID をコピーします。
組織によって、Product List ID は数値か、s- プレフィックス付きの UUID(例: s-123a-456b-789c-...)のいずれかです。Profound はどちらにも対応しています。ID をコピーし、後のステップで使用できるように控えておきます。
5

Salsify を Profound に接続する

  • Profound で、プラットフォームの左上にある組織名を選択し、Settings を選択します。
  • 左サイドバーで、Account の下にある Integrations を選択します。
  • Salsify を検索して選択し、+ Add account を選択します。
  • Connect Salsify ダイアログで、ステップ 2 の Salsify API key と ステップ 3 の Organization ID を入力します。
  • Connect account を選択します。
Agent ビルダーから直接 Salsify を接続することもできます。Salsify ノードを追加し、ノード設定で Salsify Organization ドロップダウンを開いて、+ Add integration を選択します。接続済みアカウントの一覧に Salsify 組織が表示されていれば、接続は成功です。
6

接続を確認する

Agents が使用する商品に Salsify ユーザーがアクセスできることを確認するには、Agent ビルダーでノードをテストします。
  • Profound で新しい Agent を作成するか、既存の Agent の下書きを開きます。
  • Salsify の List Products ノードを追加し、接続済みの Salsify 組織を選択します。
  • Product Lists に、ステップ 4 のソースリスト ID を入力します。
  • Test node(再生 アイコン)を選択し、想定どおりの商品が出力に含まれていることを確認します。
  • Profound Agents で商品やリストを更新する予定がある場合は、Update Products、Add Products to List、Remove Products from List の各ノードも同じ方法でテストします。

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

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

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

お使いの Salsify ユーザーに API の使用権限がありません。Salsify 管理者に権限の付与を依頼するか、Profound インテグレーション用のユーザーの作成を依頼してください。
  • API キー全体をコピーしたことを確認してください。
  • キーを所有する Salsify ユーザーが無効化されていないことを確認してください。ユーザーを無効化すると Salsify へのアクセス権が削除され、その API キーも機能しなくなります。
  • Organization ID が(組織名ではなく)URL の /orgs/ の後に続く部分であること、および API キーと同じ組織のものであることを確認してください。
Agent が使用する商品やリストを操作する権限が Salsify ユーザーにない場合に発生することがあります。Salsify で、Profound 用ユーザーの権限を確認してください。
Salsify は、一定時間内に受け付けるリクエスト数を制限しています。エラーには、制限がリセットされるまでの残り秒数が表示されます。しばらく待ってから、Agent を再度実行してください。リクエスト数を減らすには、1 ページあたりに読み取る商品数を増やし、同時に実行する Salsify ノードの数を減らしてください。
タイムアウトは一時的なものであることが多いため、ノードを再度実行すれば解決するはずです。Salsify 組織が許可リストに登録された IP アドレスからのリクエストのみを受け付ける場合は、Profound のアカウントチームに依頼して、組織の Salsify リクエストを静的 IP アドレス経由でルーティングしてもらってください。