取引が新しいステージに入る（トリガー）
このピースでできることZendesk Sell の接続方法メールアドレス（Email Address）API トークン（API Token）ピースの設定項目1. パイプライン（必須）2. ステージ（必須）取得できる情報出力例（抜粋）
このピースでできること
- Zendesk Sellで取引が指定したパイプラインステージに移行したときにワークフローを起動します。
- 定期的にポーリングしてステージ変更を検出します。
- 特定のパイプラインステージに入った取引の情報をワークフローで利用できます。
Zendesk Sell の接続方法
以下の2つを入力して接続します。
メールアドレス（Email Address）
Zendesk Sell にログインする際のメールアドレスを入力します。
API トークン（API Token）
- Zendesk Sell にログインします
- 「設定（Settings）」→「連携（Integrations）」→「API」 を開きます
- 有効なトークンがない場合は 「API トークンを追加（Add API Token）」 をクリックします
- 生成された API トークン をコピーし、接続画面の 「API Token」 欄に貼り付けます
ピースの設定項目
1. パイプライン（必須）
- 監視するパイプラインを選択します。
- Zendesk Sellに登録されているパイプラインから選択できます。
2. ステージ（必須）
- 監視するステージを選択します。
- 選択したパイプラインに応じて利用可能なステージが表示されます。
取得できる情報
選択したステージへの移行を検知した取引の情報を、取引1件ずつ取得できます。
| 実際のキー | 内容・条件 |
|---|---|
| / | 取引ID・取引名。 |
| / | 取引金額・通貨。金額が文字列で返る場合もあります。 |
| 現在のステージID。 | |
| / | 関連する連絡先・担当者のID。関連レコードの詳細は別途取得してください。 |
| / | 作成日時・最終更新日時。提供される項目のみ利用できます。 |
- 取引を以前に確認した際のステージが保存されていて、そのステージが対象外から選択したステージに変わった場合に出力します。初めて確認する取引や、すでに対象ステージにいた取引は通常処理では出力しません。
- パイプラインはステージの選択肢を絞り込むために使われます。取引の検出では を比較します。
- 通常は更新日時の新しい順に最大100件を確認します。テストは通常処理と異なり、取得したサンプル候補の中に対象ステージの取引があれば1件を返し、見つからない場合は空のオブジェクトになります。
- 出力はAPIの取引情報です。変更前のステージIDや変更項目の一覧は追加しません。 を後続の取引更新、・ を通知に利用できます。
出力例（抜粋）
キーの使い方を示す架空例です。実際の値や全項目を示すものではありません。