Salesforce 連携
Salesforce と Pigeon Workflow を連携すると、リードや商談などのデータを取り込んだり、ワークフローからレコードを作成・更新できます。本番環境と Sandbox を選んで接続できます。
組織共有の連携です
この連携は組織単位で登録します。一度登録すれば、同じ組織のメンバーがワークフローから利用できます。 権限管理が有効な組織では、シークレットに「利用」権限を持つメンバーが利用できます。詳しくは権限管理の完全ガイドを参照してください。
接続前に必要なもの
- Salesforce の Enterprise・Unlimited・Developer（無料）のいずれかのエディションのアカウント
- Salesforce の設定画面で作成済みの 接続アプリケーション（Connected App）（OAuth2 を有効化したもの）
- その接続アプリケーションの情報がサービス側に設定されていること
Starter・Professional エディションでは接続できません
これらのエディションでは接続アプリケーションを作成できません。 動作を試したい場合は、無料の Developer Edition をご利用ください。
接続アプリケーションの設定は担当者にご相談ください
接続アプリケーションの作成と、その情報のサービス側への設定が必要です。詳しい手順は担当者までお問い合わせください。 作成時には 「いつでも要求を実行（refresh_token, offline_access）」の権限を必ず含めてください。これが無いと接続が完了しません。
セットアップ手順
設定画面を開く
「設定」→「サービス連携」→「Salesforce」を開きます。
接続先環境を選ぶ
「接続先環境」で「本番環境」または「Sandbox」を選びます。
「Salesforceアカウントを接続」をクリック
Salesforce の認証画面が開きます。ログインして許可してください。
接続完了を確認する
「Salesforceアカウントの接続に成功しました！」と表示され、一覧に「接続済み」と「本番」または「Sandbox」のバッジが出れば完了です。
本番環境と Sandbox
- 接続ごとに 1 つの環境を選びます。本番と Sandbox の両方を使う場合は、それぞれ接続を追加してください。
- Sandbox 用の接続アプリケーションは、本番のものをそのまま使えません。Sandbox 側にも別途作成が必要です。
- 「再接続」は、その接続を作ったときの環境のままつなぎ直します。画面の環境の切り替えは反映されません。環境を変えたい場合は新しく接続を追加してください。
- 接続アプリケーションを作成した直後は、数分ほど認証が通らないことがあります。時間をおいてお試しください。
ワークフローで使えるノード
| ノード | できること | 主な設定 |
|---|---|---|
| Salesforce取得 | SOQL クエリでの取得 / ID を指定した 1 件取得 / オブジェクト定義の取得 | アカウント / アクション / SOQL クエリ / 取得件数上限 / オブジェクト / レコード ID / 取得フィールド |
| Salesforce書込 | レコードの作成・更新・作成または更新・削除 | オブジェクト / 操作 / レコード ID / 外部 ID フィールド名 / 外部 ID の値 / フィールドマッピング |
扱えるオブジェクトは、リード・取引先責任者・取引先・商談・ケース・タスク・イベント・キャンペーン・ユーザーです。
「作成または更新」を使うと、外部 ID の値が一致するレコードがあれば更新し、無ければ作成します。 同じデータを何度取り込んでも二重登録にならないので、定期実行のワークフローで使うと安全です。
Salesforce の変更をきっかけに起動することはできません
リード作成などを検知してワークフローを自動起動する機能は、現在ご利用いただけません。 定期実行（スケジュール）で取り込む形をご利用ください。
注意点と制限
- 1 日に使える API の回数に上限があります。上限はご契約のエディションによって決まります（Developer は 1 日 15,000 回程度、Enterprise・Unlimited は 100,000 回程度）。他のツールとも共有される枠なので、大量件数の処理は実行回数にご注意ください。
- 取得件数が多いと、その分 API の回数を消費します。SOQL クエリでは必要な項目と件数に絞ってください。
- 短時間に集中してアクセスすると Salesforce 側で受け付けが止まり、そのワークフローは失敗として記録されます（自動での再試行は行いません）。時間をずらして再実行してください。
- Salesforce の IP 制限により接続できない場合があります。接続アプリケーションの設定で IP 制限を緩和してください。
- 接続情報は暗号化して保存され、画面で確認することはできません。