行動履歴（サイトアクセス）を取得する
このピースでできることferret Oneの接続方法ピースの設定項目1. 検索方法（必須）2. 検索方法の値（必須）3. 指定日時 から（任意）4. 指定日時 まで（任意）5. その他の項目（任意）6. 失敗時に続ける（任意）7.失敗時に再試行（任意）
このピースでできること
- ferret Oneのリードの行動履歴を取得します。
- メールアドレスやリードIDを指定し、日付範囲で絞り込みできます。
ferret Oneの接続方法
- 「webhookを受信する」のピースではAPI keyは不要です。
- ferret OneのAPI管理画面のサイドバーから 設定・管理>外部連携設定>API/他 を選択する。画面真ん中の「APIキーを作成」をクリックします。
- API keyの名前をつけます。
- API keyが表示されるのでメモします。二度と表示されないのでメモを忘れないようにしてください。
- workrunのferret Oneピースの接続でAPI keyを貼り付ける。
ピースの設定項目
1. 検索方法（必須）
- 「リードID」または「メールアドレス」を選択します。
2. 検索方法の値（必須）
- リードID、またはメールアドレスの値を入力します。
- 完全一致のみとなります。
3. 指定日時 から（任意）
- 指定した日時以降のデータを取得します（デフォルトでは2年前が指定されます） 例: 2025-09-01 00:00:00
4. 指定日時 まで（任意）
- 指定した日時以前のデータを取得します（デフォルトでは現在が指定されます） 例: 2025-09-01 00:00:00
5. その他の項目（任意）
- 取得データ上限（1～1000まで。指定しない場合は10件です）
- 昇順/降順（ASCかDESC）
- データ取得の開始位置（「行動履歴（サイトアクセス）を取得する」で取得したデータ内の「next_cursor」の値を入力します）
- パラメータ一覧
| パラメータ | 表示名 | 検索タイプ | 入力形式 | 備考 |
|---|---|---|---|---|
| from | 指定日時 から | - | 日付形式 e.g. | デフォルトは2年前 |
| to | 指定日時 まで | - | 日付形式 e.g. | デフォルトは現在 |
| limit | 取得データ上限 | - | 1~1000までの整数 | デフォルトは10 |
| sort_order | 昇順/降順 | - | ASCかDESC | |
| cursor | データ取得の開始位置 | - | 「行動履歴（サイト）を取得する」で取得したデータ内の「next_cursor」の値を入力 |
6. 失敗時に続ける（任意）
- このオプションを有効にすると、このステップをスキップし、失敗した場合は正常にフローを継続します。
7.失敗時に再試行（任意）
- 失敗したときに自動的に最大 4 回の試行を再試行します。