社外連絡先が登録された時(トリガー)

このピースでできること

  • PHONE APPLI PEOPLE に社外連絡先が新規登録されたときにフローを自動展開します。
  • 登録された連絡先の会社名・氏名・電話番号・メールアドレスなどの情報を後続ステップに渡せます。
  • 定期的に PHONE APPLI PEOPLE の API をポーリングして新規登録を検知します。

PHONE APPLI PEOPLE の接続方法

workrun と PHONE APPLI PEOPLE を接続するには、PHONE APPLI PEOPLE の API キー が必要です。

ステップ 1:API キーを取得する

  1. PHONE APPLI PEOPLE の PC ブラウザ版にログインする。
  1. 画面右上のユーザー名 →「ユーザー情報」を開く。
  1. 「APIキー」タブを開き、「APIキーを発行」をクリックする。
  1. 必要なスコープを選択する。
      • (「社外連絡先一覧を取得する」アクション・「社外連絡先が登録された時」トリガーで必要)
      • 「カスタムAPI呼び出し」アクションで他リソースを操作する場合は、対応するスコープも追加してください。
  1. 発行された API キーをコピーする。

ステップ 2:workrun に接続を追加する

  1. workrun で PHONE APPLI PEOPLE のアクションをフローに追加します。
  1. 「接続を選択」の横にある 「+ 新しい接続」 をクリックします。
  1. 「API Key」 フィールドに、ステップ 1 でコピーした API キーを貼り付けます。
  1. 「保存」 をクリックして接続を完了します。

ピースの設定項目

このピースには設定項目がありません。接続を選択するだけで利用できます。

取得できる情報

新規登録と判定された社外連絡先1件の情報を取得します。
実際のキー内容・条件
連絡先ID・格納フォルダの区分と番号。
会社名・会社名カナ・会社代表電話。
部署名・役職・氏名・氏名カナ・英字氏名。
電話・携帯電話・FAX番号。
メールアドレス・関連URL・連絡先詳細URL。
所在地。zipCode、address1、address2 などを含む場合があります。
登録・更新日時、登録者、名刺交換日・参加者情報。
コメント・備考・名刺OCRに関する情報。
  • 登録日時と更新日時が秒単位で同じ連絡先を新規登録と判定し、更新日時が前回の取得時刻より後のものを出力します。登録後に別の秒で更新された連絡先はこの判定に入りません。
  • 項目の有無・型・値は応答と入力状況によります。テストで実データを取得できない場合はサンプルが返るため、実際の登録情報と混同しないでください。

利用例

IDや本文を後続ステップへ渡し、通知や別システムへの登録に利用できます。

出力例(抜粋)

以下はキーと構造を示す架空例です。実際の値・任意項目はテストまたはフローの実行結果で確認してください。