社外連絡先が登録された時(トリガー)
このピースでできることPHONE APPLI PEOPLE の接続方法ステップ 1:API キーを取得するステップ 2:workrun に接続を追加するピースの設定項目取得できる情報利用例出力例(抜粋)
このピースでできること
- PHONE APPLI PEOPLE に社外連絡先が新規登録されたときにフローを自動展開します。
- 登録された連絡先の会社名・氏名・電話番号・メールアドレスなどの情報を後続ステップに渡せます。
- 定期的に PHONE APPLI PEOPLE の API をポーリングして新規登録を検知します。
PHONE APPLI PEOPLE の接続方法
workrun と PHONE APPLI PEOPLE を接続するには、PHONE APPLI PEOPLE の API キー が必要です。
ステップ 1:API キーを取得する
- PHONE APPLI PEOPLE の PC ブラウザ版にログインする。
- 画面右上のユーザー名 →「ユーザー情報」を開く。
- 「APIキー」タブを開き、「APIキーを発行」をクリックする。
- 必要なスコープを選択する。
- (「社外連絡先一覧を取得する」アクション・「社外連絡先が登録された時」トリガーで必要)
- 「カスタムAPI呼び出し」アクションで他リソースを操作する場合は、対応するスコープも追加してください。
- 発行された API キーをコピーする。
ステップ 2:workrun に接続を追加する
- workrun で PHONE APPLI PEOPLE のアクションをフローに追加します。
- 「接続を選択」の横にある 「+ 新しい接続」 をクリックします。
- 「API Key」 フィールドに、ステップ 1 でコピーした API キーを貼り付けます。
- 「保存」 をクリックして接続を完了します。
ピースの設定項目
このピースには設定項目がありません。接続を選択するだけで利用できます。
取得できる情報
新規登録と判定された社外連絡先1件の情報を取得します。
| 実際のキー | 内容・条件 |
|---|---|
| 連絡先ID・格納フォルダの区分と番号。 | |
| 会社名・会社名カナ・会社代表電話。 | |
| 部署名・役職・氏名・氏名カナ・英字氏名。 | |
| 電話・携帯電話・FAX番号。 | |
| メールアドレス・関連URL・連絡先詳細URL。 | |
| 所在地。zipCode、address1、address2 などを含む場合があります。 | |
| 登録・更新日時、登録者、名刺交換日・参加者情報。 | |
| コメント・備考・名刺OCRに関する情報。 |
- 登録日時と更新日時が秒単位で同じ連絡先を新規登録と判定し、更新日時が前回の取得時刻より後のものを出力します。登録後に別の秒で更新された連絡先はこの判定に入りません。
- 項目の有無・型・値は応答と入力状況によります。テストで実データを取得できない場合はサンプルが返るため、実際の登録情報と混同しないでください。
利用例
IDや本文を後続ステップへ渡し、通知や別システムへの登録に利用できます。
出力例(抜粋)
以下はキーと構造を示す架空例です。実際の値・任意項目はテストまたはフローの実行結果で確認してください。