名刺情報が登録または更新されたら（タグの更新を含む）（トリガー）
このピースでできること
- Sansanの名刺情報が登録または更新されたことを、タグの更新も含めて検知し、ワークフローを起動します。
Sansan の接続方法
Sansan の管理画面から発行した API キーを入力して接続します。
API キーの取得手順
- Sansan に管理者としてログインします
- 右上のメニューから 管理者設定 を開きます
- API キー のメニューを開きます
- 「API キーを発行する」 をクリックします
- 発行された API キーをコピーし、接続画面の 「API キー」 欄に貼り付けます
ピースの設定項目
1. 所有者の範囲（任意）
- 「自分の名刺のみ」または「参照可能な全ての名刺」を選択します。
- 未指定の場合は自分の名刺のみが対象です。全てを選んだ場合も、接続ユーザーが参照できる範囲で取得します。
取得できる情報
登録・更新された名刺1件の情報を取得します。
| 実際のキー | 内容・条件 |
|---|---|
| / / | 名刺・人物・会社のID。 |
| / / | 姓・名・会社名。 |
| / / / | 部署・役職・メールアドレス・電話番号など、名刺に登録された項目。 |
| / / | 登録日時・更新日時・所有者情報。 |
| タグ情報。各要素の など、応答に含まれる値を利用できます。 |
- 「所有者の範囲」で取得対象を選びます。未指定は自分の名刺のみです。項目の空欄や取得範囲は名刺の登録内容と参照権限によります。
- タグのつけ外しやタグ名・種別の変更も更新の対象として扱います。
- 例：名刺IDと氏名・会社名を後続処理へ渡せます。キーと空欄の扱いは実際のテスト結果で確認してください。
出力例（抜粋）
後続ステップで利用するキーを説明するための架空例です。実際の値や全項目を示すものではありません。
1分間に登録または更新が非常に多い場合（目安: 300件以上）、すべての情報を取得できない可能性があります。