概要
PLAINERのSalesforce連携は、PLAINERの閲覧データをSalesforce上のレコードとして連携する機能です。Salesforce側に PLAINER__c カスタムオブジェクトが作成され、共有URLに付与した sf_tag1 / sf_tag2 / sf_tag3 パラメータをキーに、レコードが蓄積されます。
蓄積された PLAINER__c レコードから、対応するリード・取引先責任者・取引先・商談などへ閲覧情報を反映させる動作は、Salesforce側のフロー(Flow Builder)で設定します。
本記事では、2種類の連携方式の違い、初期セットアップ、共有URLでの sf_tag の使い方、連携後の運用について説明します。
連携の使い分けや適用条件については、Salesforce・MA連携の使い分けガイドと外部連携の対応範囲もあわせてご覧ください。
連携方式について
PLAINERのSalesforce連携には、標準方式とパッケージ方式の2種類があります。ご利用の環境やセキュリティポリシーに応じて、担当者にご確認のうえ適切な方式をお選びください。
標準方式:PLAINERがMetadata APIを使ってSalesforce側のカスタムオブジェクトや権限セットを自動作成します。連携作業を行うユーザーにSystem Administrator相当の権限が必要です。
パッケージ方式:Salesforce管理者がPLAINER提供のアンロック型パッケージをインストールして連携用オブジェクトを準備します。PLAINERはMetadata APIによるオブジェクト作成を行わないため、管理者に高い権限を付与しにくいエンタープライズ環境でも導入しやすい方式です。
ご利用の方式は、設定画面の表示内容で確認できます。パッケージ方式の場合は「パッケージのインストール」セクションがページ内に表示されます。
前提条件
Salesforce側(標準方式)
API連携が利用可能なエディションのSalesforce組織が必要です(Enterprise Edition / Unlimited Edition / Performance Edition / Developer Edition など)。Professional Editionをご利用の場合は、別途APIアクセスのオプション契約が必要です。
初期セットアップ作業を行うユーザーに、System Administrator相当の権限が必要です。これは、PLAINER専用のカスタムオブジェクト(
PLAINER__c)・カスタム項目・権限セット・タブ・ページレイアウトをMetadata APIで作成するために必要な権限です。PLAINERの接続アプリケーションが要求するOAuthスコープは以下の3つです。
api(APIによるデータアクセス)web(Webブラウザ経由でのアクセス)refresh_token(リフレッシュトークンの発行・利用)
Salesforce側(パッケージ方式)
API連携が利用可能なエディションのSalesforce組織が必要です(標準方式と同様)。
パッケージのインストール作業を行うユーザーに、System Administrator相当の権限が必要です(パッケージのインストール操作に必要です)。
PLAINERとのOAuth認証を行う連携ユーザーは、「API Enabled(API有効)」権限があれば連携できます(オブジェクト作成権限は不要です)。
PLAINERの接続アプリケーションが要求するOAuthスコープは標準方式と同じです(
api/web/refresh_token)。
PLAINER側
Salesforce連携機能が有効なライセンスでの契約が必要です。
設定作業を行うユーザーに、PLAINERの管理者権限が必要です。
初期セットアップ
パッケージ方式:パッケージのインストール(パッケージ方式のみ)
パッケージ方式をご利用の場合は、Salesforceと連携する前に、Salesforce管理者がPLAINERパッケージをインストールする必要があります。
PLAINERにログインし、左サイドバーの 設定 > Salesforce連携 を開きます。
「パッケージのインストール」セクションに、本番環境用・Sandbox環境用の2つのインストールURLが表示されています。導入先の環境に応じたURLの「コピー」ボタンをクリックしてURLをコピーします。
Salesforce管理者がブラウザでそのURLを開き、パッケージをインストールします。インストール時の選択は以下の通りにしてください。
インストール対象:管理者のみインストール
Apexのコンパイル:パッケージのApexのみをコンパイル(「組織のすべてのApexをコンパイル」は既存Apexの不備でインストールが失敗する場合があります)
インストール完了後、権限セット「PLAINER Access」を、PLAINERとのOAuth認証を行う連携ユーザーに割り当てます。
インストールが完了したら、次の「Salesforceと連携する」に進んでください。
Salesforceと連携する
PLAINERにログインし、左サイドバーの 設定 > Salesforce連携 を開きます。
「Salesforce連携」セクションの「Salesforceと連携する」ボタンをクリックすると、Salesforceのログイン画面に遷移します。連携ユーザーのアカウントでログインし、PLAINERからのアクセスを許可してください。
連携が完了すると、設定画面に「接続中: (Salesforceの組織URL)」が表示されます。
テーブル作成・修復 / 導入を検証
「テーブル管理」セクションのボタンをクリックします。方式によってボタン名と動作が異なります。
標準方式:「テーブル作成・修復」ボタンをクリックします。Salesforce側にPLAINER専用のカスタムオブジェクトと必要な項目・権限セット・タブ・ページレイアウト・リストビューが自動で作成されます。エラーが発生した場合は再度実行することで補完できます(既存データは削除されません)。
パッケージ方式:「導入を検証」ボタンをクリックします。インストール済みのPLAINERパッケージが連携可能な状態か(オブジェクト・項目・権限の有無)を確認します。各チェック項目の結果がダイアログに表示されます。
プロダクト連携設定をONにする
「プロダクト連携設定」セクションで、Salesforceへデータを送信したいプロダクトの連携をONにします。ONにしたプロダクトの閲覧データが、Salesforceへ自動送信されるようになります。
sf_tagの使い方
共有URLに sf_tag1 / sf_tag2 / sf_tag3 パラメータを付与することで、Salesforce側のレコードにタグ情報を紐付けられます。リード・取引先責任者・取引先などのSalesforceレコードIDを渡すことで、Flow Builderと組み合わせてレコードへの閲覧情報反映が可能です。
例:https://share.plainer.co.jp/c/your-content?sf_tag1=00Q1234567890
連携後の運用
最新レコードの確認
「テーブル管理」セクションの「最新レコード表示」ボタンをクリックすると、Salesforceに蓄積された直近の PLAINER__c レコードを確認できます。
手動同期
「手動同期」セクションから、指定した期間のデータを手動でSalesforceへ再送信できます。送信漏れが発生した場合などにご利用ください。
通知設定
「通知設定」セクションで、Salesforceへの送信エラー発生時に通知するメールアドレスを設定できます。
ログの確認
「送信ログ」セクションで、Salesforceへの送信履歴と各レコードのステータス(送信待ち・送信中・送信済み・失敗・DLQ)を確認できます。
送信待ちのクリア
「テーブル管理」セクションの「送信待ちをクリア」ボタンをクリックすると、Salesforceへの送信が完了していないデータ(送信待ち・送信中・失敗)を削除できます。送信済みの履歴やSalesforce側のレコードには影響しません。
連携解除
「Salesforce連携」セクションの「連携解除」ボタンから、PLAINERとSalesforceの接続を解除できます。
標準方式:連携解除とは別に「テーブル管理」セクションの「連携をリセット」ボタンから、Salesforce側の
PLAINER__cオブジェクト・レコード・権限セットおよびPLAINER側の送信待ちデータ・認証情報をすべて削除することができます。この操作は取り消せません。パッケージ方式:連携解除は上部の「連携解除」から行います。Salesforce側のオブジェクトやデータを削除したい場合は、Salesforce管理画面からパッケージをアンインストールしてください。
