Salesforce連携方法


この機能は、エンタープライズプラン以上でご利用いただけます。

チーム用の予約ページでのみご利用いただけます。

Salesforceと連携することで、お客様が予約ページから予約確定時に以下が可能です（OAuth2.0）。

  • 新規のお客様として、リードを新規作成
  • 既存のお客様として、既存のリードまたは取引先責任者に行動を新規作成

さらにプレミアムプランでは以下も可能です。

  • 【予約フォームの入力フィールド】と【Salesforce上のフィールド】の連携

（予約フォームに入力された値を、対応するSalesforceのリードのフィールドに保存）

Tips
予約ページごとに設定可能です。

手順

以下の手順でSalesforce連携を行ってください。

Salesforce連携でできること

Salesforce連携の設定を行った予約ページから予定確定すると、Salesforce上に自動で新規リードまたは新規行動が作成されます。
さらに、予約フォームの入力フィールドと連携させることも可能です。

「新規リードを自動作成する」を設定した場合

Salesforce上に予約フォームから入力されたメールアドレスと一致するリードまたは取引先責任者が無い場合、新規のお客様として、新規リードが自動作成されます。

Check
予約フォームで入力された同席者の新規リードは作成されません。
Tips
リード所有者は調整アポ側での連携方法の操作時にSalesforceにログインしているアカウントになります。（Salesforce上に設定されている割り当てルールにも準拠されます）


Salesforce連携画面1

( 画像をクリックすると拡大表示します )

「新規行動を自動作成する」を設定した場合

Salesforce上に予約フォームから入力されたメールアドレスと一致するリードまたは取引先責任者がある場合、既存のお客様として、新規行動が自動作成されます。

Tips
リードと取引先責任者の両方に情報がある場合は、リードのみに行動が作成されます。
Check
リードまたは取引先責任者に同じメールアドレスで複数登録があった場合は、いずれかのリードまたは取引先責任者にランダムで行動が新規作成されます。


Salesforce連携画面2

( 画像をクリックすると拡大表示します )

Tips
「割り当て先」に指定されるSalesforceユーザーについて
確定された予定に参加する社員のメールアドレスが、Salesforce側のアカウントのメールアドレスと一致している場合には、そのSalesforce側のアカウントで設定されます。

※該当社員が複数人いる場合には、調整アポ設定画面のメンバー並び順で上から1名が設定されます。
※該当社員全員のメールアドレスがSalesforce側と一致していない場合は、【2】調整アポ側での連携方法で連携時にログインしていたSalesforceのアカウントになります。

▼調整アポ設定画面のメンバー

調整アポ設定画面のメンバー

▼新規行動の割り当て先

新規行動の割り当て先

「予約フォームの入力フィールドと連携させる」を設定した場合

氏名・会社名以外の【予約フォーム入力フィールド】と【Salesforceフィールド】を連携できます。
予約フォームに入力された値が、対応するSalesforceのリードのフィールドに保存されます。

Check
プレミアムプランのみ利用可能です。
Tips
連携可能なSalesforceの項目のデータ型


Salesforce連携の入力フィールド設定

( 画像をクリックすると拡大表示します )

既にリードがある状態で予約された場合の挙動

項目の種類 上書きルール
隠しフィールド
（予約フォームに非表示）		 ・リード上で上書きされます
隠しフィールド以外
（予約フォームに表示）		 ・予約フォームで項目に値を入力した場合、リード上で上書きされます
・予約フォームで項目に値を入力しなかった場合、リード上の元々の値が保持されます

Check
氏名・会社名は連携されません。

Salesforceで顧客管理や営業支援をされている場合には、スムーズにお客様の管理ができますので、ぜひご利用ください！

事前確認

1．Salesforce連携可能なSales Cloudエディションか

ご利用のSalesforceのSales Cloudエディションが連携可能かどうか以下ご確認ください。

  • Essentials：連携不可
  • Professional：別料金の「WEBサービスAPI」お申込みの場合のみ連携可能
  • Enterprise以上：連携可能
Tips
Salesforce の Edition および API バージョンを確認する方法（Salesforce公式サイト）
Check
SalesforceのSandbox環境とは連携できませんのでご注意ください。

2．Salesforce側でIPアドレス制限をしていないか

Salesforceのシステム管理者アカウントにIPアドレス制限をかけられている場合は、RECEPTIONISTサーバーのIPアドレス（13.115.181.254）のアクセス許可が必要となります。

Enterprise Edition、Unlimited Edition、Performance Edition、Developer Edition をご利用の場合、以下手順で設定をお願いします。その他のエディションは、SalesforceのHelpをご参考くださいませ。

ステップ1：設定メニューを開く

1. Salesforceシステム管理者でSalesforceにログインし、右上の歯車のアイコンを押して「設定」を開いてください。

Salesforce 設定1

ステップ2：「プロファイル」を開く

2. 「クイック検索」ボックスに「プロファイル」と入力し、表示された「プロファイル」をクリックしてください。


プロファイル選択画面

(画像をクリックすると拡大表示します)

ステップ3：「システム管理者」プロファイルを選択

3. 「システム管理者」のプロファイルをご選択ください。


システム管理者プロファイル選択

(画像をクリックすると拡大表示します)

ステップ4：ログインIPアドレスの制限を設定

4. 「ログイン IP アドレスの制限」関連リストの「新規」をクリックします。

Check
「ログイン IP アドレスの制限」で「ログイン IP の制限はありません…」と表示されている場合は設定不要です。


ログインIPアドレス制限

(画像をクリックすると拡大表示します)

ステップ5：IPアドレスを入力して保存

5. 「開始IPアドレス」「終了IPアドレス」に「13.115.181.254」を入力し、「保存」をクリックして完了です。


IPアドレス入力画面

(画像をクリックすると拡大表示します)

3．リード・行動の各項目で、システム管理者が参照する権限があるか

リードや行動の項目で、システム管理者が参照する権限がない場合、リードや行動が作成されません。
以下手順でシステム管理者に参照権限を付与してください。

Salesforce管理者でSalesforceにログイン
＞右上の「歯車マーク」＞「設定」＞「オブジェクトマネージャー」
＞「リード」または「行動」＞「項目とリレーション」
＞項目を選択＞「項目レベルセキュリティの設定」
＞「システム管理者」の「参照可能」にチェックされているか確認



(画像をクリックすると拡大表示します)

4．「新規リードを自動作成する」ご利用時、リードの必須カスタム項目にデフォルト値があるか

リードのカスタム項目で、必須項目かつデフォルト値が未設定の場合、エラーによりリードが作成されません。以下手順でデフォルト値を設定してください。

Salesforce管理者でSalesforceにログイン
＞右上の「歯車マーク」＞「設定」＞「オブジェクトマネージャ」
＞「リード」＞「項目とリレーション」＞項目を選択
＞「必須項目」にチェックありの場合、「デフォルト値」を設定



(画像をクリックすると拡大表示します)

5．「新規行動を自動作成する」ご利用時、行動に必要項目があるか

行動の「項目とリレーション」に以下7つの項目がない場合、行動が作成されないため、項目を追加してください。

Tips
必要項目一覧（表示ラベル / 項目名 / データ型）
  • 種別 / Type / 選択リスト
  • 件名 / Subject / 選択リスト
  • 説明 / Description / ロングテキストエリア (32000)
  • 開始 / StartDateTime / 日付・時間
  • 終了 / EndDateTime / 日付・時間
  • 名前 / WhoId / 参照関係 (担当者, リード)
  • 割り当て先 / OwnerId / 参照関係 (ユーザ, カレンダー)

【1】Salesforce側での事前設定

ご利用されているインターフェースを以下からご選択いただき、ご設定ください。

1．Salesforceにログインし「設定」を開く

1. Salesforceシステム管理者でSalesforceにログインし、右上の歯車のアイコンを押して、「設定」を開いてください。

Salesforce 設定

2．新規接続アプリケーションを作成

2. 設定で「プラットフォームツール」の「アプリケーション」＞「アプリケーションマネージャ」＞「新規接続アプリケーション」(右上)をクリックします。


新規接続アプリケーション作成

( 画像をクリックすると拡大表示します )

3．接続アプリケーションの基本情報を入力

3. 基本情報内の「接続アプリケーション名」と「API参照名」と「取引先責任者 メール」をそれぞれ入力します。


接続アプリケーション設定画面

( 画像をクリックすると拡大表示します )

Item Name Detail
接続アプリケーション名 任意の文字列（例：RECEPTIONIST）
API参照名 任意の文字列（例：RECEPTIONIST）
取引先責任者 メール 設定しているご自身のメールアドレスをご入力ください。

4．OAuth設定を有効化

4. API (OAuth 設定の有効化) 項目で、以下4箇所を設定します。


OAuth設定画面

( 画像をクリックすると拡大表示します )

Item Name Detail
① OAuth 設定の有効化 チェックを入れます。
② コールバック URL 以下URLを入力してください。
https://app.receptionist.jp/visitor_setting
③ 選択したOAuth範囲 以下2つを選択してください。
・「APIを使用してユーザデータを管理 (api)」
・「いつでも要求を実行 (refresh_token,offline_access)」

Check
該当の選択肢がない場合、()内が合致しているものをご選択ください。
④ サポートされる認証フローに Proof Key for Code Exchange (PKCE) 拡張を要求 チェックを外します。

5．保存をクリック

5. 下部の「保存」をクリックします。

保存ボタン

6．確認画面で「次へ」をクリック

6. 新規接続アプリケーションの確認画面が表示されるので、「次へ」をクリックしてください。


次へをクリック

( 画像をクリックすると拡大表示します )

7．「コンシューマの詳細を管理」をクリック

7.「コンシューマの詳細を管理」をクリックします。

コンシューマ管理

8．コンシューマ鍵と秘密をコピー

8. ① コンシューマ鍵 と ② コンシューマの秘密 をコピーして手元に控え、アプリが有効になるまで 10分程度待ちます。

コンシューマ鍵と秘密

Salesforce -Lightning Experience版-の事前設定は以上となります。
続いて、調整アポ側の設定を行いましょう。

Salesforce Classic版をご利用の場合の事前準備

以下の手順に沿って、Classicインターフェースで接続アプリケーションの設定を行ってください。

1．Salesforceにログインし「設定」をクリック

1. Salesforceシステム管理者でSalesforceにログインし、右上の「設定」をクリックします。

Classic 設定

2．「アプリケーションを管理する」をクリック

2.「クイックリンク」の「アプリケーション」＞「アプリケーションを管理する」をクリックします。


アプリケーションを管理する

(画像をクリックすると拡大表示します)

3．「接続アプリケーション」の「新規」をクリック

3.「接続アプリケーション」の「新規」をクリックします。


新規接続アプリケーション

(画像をクリックすると拡大表示します)

4．基本情報を入力

4. 基本情報内の「接続アプリケーション名」と「API 参照名」と「取引先責任者 メール」をそれぞれ入力します。


基本情報入力

(画像をクリックすると拡大表示します)

Item Name Detail
接続アプリケーション名 任意の文字列（例：RECEPTIONIST）
API参照名 任意の文字列（例：RECEPTIONIST）
取引先責任者 メール 設定しているご自身のメールアドレスをご入力ください。

5．OAuth設定を有効化

5. API (OAuth 設定の有効化) 項目で、以下4箇所を設定します。


OAuth設定

(画像をクリックすると拡大表示します)

Item Name Detail
① OAuth 設定の有効化 チェックを入れます。
② コールバック URL 以下URLを入力してください。
https://app.receptionist.jp/visitor_setting
③ 選択したOAuth範囲 以下2つを選択してください。
・「APIを使用してユーザデータを管理 (api)」
・「いつでも要求を実行 (refresh_token,offline_access)」

Check
該当の選択肢がない場合、()内が合致しているものをご選択ください。
④ Proof Key for Code Exchange (PKCE) 拡張を要求 チェックを外します。

6．保存をクリック

6. 下部の「保存」をクリックします。

保存ボタン

7．「次へ」をクリック

7. 新規接続アプリケーションの確認画面が表示されるので、「次へ」をクリックします。


次へクリック画面

(画像をクリックすると拡大表示します)

8．「コンシューマ鍵」と「コンシューマの秘密」を控える


コンシューマ鍵と秘密

(画像をクリックすると拡大表示します)

表示された「接続アプリケーションを管理する」画面の、
① コンシューマ鍵 と ② コンシューマの秘密 の2点をコピーして手元に控え、
アプリが有効になるまで 10分程度待ちます。

以上で、Salesforce Classic版の事前設定は完了です。

【2】調整アポ側での連携方法

1．10分程度時間を置く

1. 【1】の接続アプリケーション作成から10分程度時間を置いてください。
【1】で控えた「コンシューマ鍵」と「コンシューマの秘密」をご準備ください。

2．Salesforceにシステム管理者でログイン

2. SalesforceにSalesforceシステム管理者でログインしてください。

3．RECEPTIONIST管理画面から連携設定を開始

3. RECEPTIONIST管理者で RECEPTIONIST管理画面 を開く
＞「来訪者設定」＞「来訪者連携」タブの「Salesforce」右側の「・・・」をクリックします。

Tips
再連携の場合は、「Salesforce」右側の「・・・」＞「Salesforceとの連携解除する」をクリックします。
※連携を解除しても、予約ページのSalesforce設定はクリアされません。


Salesforce連携開始

(画像をクリックすると拡大表示します)

4．「鍵」と「秘密」を入力して接続

4. 【1】で控えた、
①「コンシューマ鍵」
②「コンシューマの秘密」
をそれぞれコピー＆ペーストし、「Salesforceに接続する」をクリックします。

Check
このとき、SalesforceにSalesforceシステム管理者でログインした状態で接続を行ってください。


コンシューマ鍵・秘密入力

(画像をクリックすると拡大表示します)

5．アクセス許可画面で「許可」をクリック

5. アクセス許可画面が表示された場合は、「許可」をクリックします。

許可クリック

6．連携完了の確認

6. 連携完了の表示が行われます。

連携完了画面

お疲れさまでした！
以上でSalesforceとの連携設定は完了です。

後は、予約ページごとに機能を有効にするだけです。

エラーが表示される場合

Check

エラー表示が出る場合

  • 作成したアプリが有効になっていない可能性があります。10分程度時間を置いて再度お試しください。
  • 【1】Salesforce側での事前設定 の内容が誤っている可能性があります。設定変更後は10分程度待って再接続してください。
  • 入力した「鍵」または「秘密」に誤りがある可能性があります。コピー内容に誤りがないかご確認ください。

エラー画面

Salesforce連携後の注意点

【2】調整アポ側での連携方法 で連携に使用した Salesforceシステム管理者アカウントが無効・削除されると、Salesforce連携の接続が切れますのでご注意ください。

一方で、【1】Salesforce側での事前設定 で接続アプリケーションを作成したアカウントが無効・削除されても、Salesforce連携には影響ございませんのでご安心ください。

【3】予約ページごとの設定方法

各予約ページごとに、Salesforce連携を制御することができます。

Check
個人用の予約ページではご利用になれません。チーム用の予約ページにてご利用くださいませ。

1．予約ページの詳細設定を開く

1. 予約ページの設定画面 の左上のタブを選択し、表示された予約ページの右側にある「詳細設定」をクリックします。

予約ページ設定

2．Salesforce連携項目にチェック

2. 左側メニューの「Salesforce」＞用途に合わせて各項目にチェック＞「変更を保存」をクリックします。

Salesforce設定項目

Item Name Detail
① 姓名を分けて保存する お客様が入力する予約ページでは、入力項目が「氏名（姓）」と「氏名（名）」に分かれて表示されます。
「新規リードを自動作成する」がチェック有の場合、予約フォームに入力された値が、Salesforceの姓と名それぞれのフィールドに保存されます。

Tips
「姓名を分けて保存する」がチェック無しの場合は、予約ページでは「氏名」のみとなり、Salesforceの姓のフィールドに保存されます。
② 新規リードを自動作成する 該当の予約ページからお客様が予約確定すると、入力されたお客様のメールアドレスと一致するリードまたは取引先責任者が存在しない場合に限り、新規リードを自動作成します。
③ 新規行動を自動作成する 該当の予約ページからお客様が予約確定すると、入力されたお客様のメールアドレスと一致するリードまたは取引先責任者に、新規行動を自動作成します。

Tips
リードと取引先責任者の両方に情報がある場合は、リードのみに行動が作成されます。
Check
同じメールアドレスで複数のリードまたは取引先責任者が存在する場合は、ランダムに行動が作成されます。
④ 予約フォームのフィールドと連携させる 氏名・会社名以外の【予約フォーム入力フィールド】と【Salesforceフィールド】を連携させます。
お客様が予約確定すると、入力された値が対応するSalesforceのリードのフィールドに保存されます。

Check
この機能は プレミアムプランのみ対応しております。
Check
日付の入力フィールドはSalesforce未対応です（鋭意開発中です）
Check
デフォルト項目の「氏名」「会社名」「メールアドレス」は変更できません。
Check
連携可能なSalesforceの項目のデータ型
Tips
予約フォーム入力フィールドの設定方法
Tips
チェックを付けた②③④の項目については、それぞれ単独で機能いたします。
各項目のチェック有無によって、動作する仕組みは以下の通りです。


Salesforce機能の組み合わせ説明図

( 画像をクリックすると拡大表示します )

Check

[入力されたお客様のメールアドレス]とは、初期設定で表示されるメールアドレスの項目になります。
個別に追加した 入力フィールド のメールアドレスでは機能しませんので、ご注意くださいませ。

初期設定のメールアドレス項目

【4】「予約フォームの入力フィールドと連携させる」にチェックしたときの設定

1. Salesforce側でフィールド名とデータ型を確認

1-1. Salesforceの設定画面にアクセス

Salesforceにシステム管理者権限のアカウントでログインし、「歯車マーク」＞「設定」をクリックします。
sf_01_02

1-2. オブジェクトマネージャーで「リード」を開く

「オブジェクトマネージャー」＞「リード」をクリックします。

リードオブジェクト

( 画像をクリックすると拡大表示します )

1-3. 連携対象となる項目名（フィールド名）を確認

「項目とリレーション」一覧から連携したい「項目名」を確認してください。
この「項目名」が、予約フォームと連携させるSalesforce側のフィールド名となります。

項目名の確認

( 画像をクリックすると拡大表示します )

1-4. Salesforce項目の「データ型」を確認

連携したい項目の「項目名」の右に表示されている「データ型」をご確認ください。

2. 予約フォームの項目タイプとSalesforceのデータ型の対応表

予約フォームのフィールドタイプによって、連携可能なSalesforceのデータ型が異なります。以下のマッピング表をご確認ください。

Tips
入力フィールドの編集方法（予約フォームのフィールドタイプ）

フィールドタイプごとの対応データ型（マッピング表）

予約フォームのフィールドタイプ Salesforceリードの項目のデータ型
テキストフィールド
  • テキスト
  • URL(255)
  • メール
  • テキストエリア (リッチ)
  • 電話
  • 数値
  • 通貨
  • テキスト(暗号化)
  • パーセント
テキストエリア
  • テキスト
  • テキストエリア (リッチ)
  • ロングテキストエリア
  • URL(255)
  • メール
  • 電話
  • 通貨
  • テキスト(暗号化)
  • パーセント
ラジオボタン
  • 選択リスト
チェックボックス
  • 選択リスト（複数選択）
ドロップダウン
  • 選択リスト（複数選択）
隠しフィールド
  • テキスト
  • 選択リスト
    ※選択肢のいずれかと隠しフィールドの値が完全一致している必要あり
  • URL(255)
  • メール
  • テキストエリア (リッチ)
  • 電話
  • 数値
  • 通貨
  • テキスト(暗号化)
  • パーセント
  • チェックボックス
Check
予約フォームのフィールドタイプ「日付」は未対応です。（鋭意開発中です）

5. Salesforceフィールドのデータ型が「選択リスト」の場合の注意点

予約時に予約フォームに入力した値とSalesforceフィールドの選択肢が一致しない場合は、予約フォームに入力した値がSalesforceに保存されません。
そのため、予約フォームの ラジオボタン・ドロップダウン・チェックボックス と、Salesforce上の 選択リスト・選択リスト（複数選択） を連携する場合には、同じ選択肢を設定することをおすすめします。

Check

例）以下の場合、予約フォームで「Google Chat」を選択された場合、Salesforce上にその選択肢が存在しないため、この項目はSalesforceに保存できません。
【予約フォーム】
ラジオボタン・ドロップダウン・チェックボックスの選択肢		 【Salesforce上】
選択リスト・選択リスト（複数選択）の選択肢
・Slack
・Chatwork
・Microsoft Teams
・Google Chat 		・Slack
・Chatwork
・Microsoft Teams

2. フィールド名を予約フォームのフィールドに設定

確認したSalesforce側のフィールド名を、予約フォームのフィールドに設定します。

2-1. Salesforceフィールドの編集画面へ遷移

「Salesforceフィールド」の鉛筆マークをクリックすると、「予約フォーム設定」の画面に遷移します。

Tips
「予約フォーム設定」の設定方法は
こちら。


Salesforceフィールドの編集画面

( 画像をクリックすると拡大表示します )

2-2. フィールド名を設定し保存

「Salesforce側のフィールド名」を入力し、「変更を保存」をクリックします。

文字を入力すると、その文字が含まれるフィールド名が検索されますので、その中から該当のフィールド名を選択すると便利です。

Tips
Salesforce側のセキュリティレベルの設定などによっては検索できない場合もあります。その場合はフィールド名を直接入力してください。
Tips
左側メニューの「入力フィールド設定」＞「追加したフィールドの鉛筆マーク」からでも、この画面を表示できます。


Salesforceフィールドの保存操作

( 画像をクリックすると拡大表示します )

これで設定は完了です。
後は、該当の予約ページからお客様が予約確定すると、設定を行った通りに連携が可能です。

リードや行動が作成されないとき/Salesforceフィールドに連携されないとき

リードが作成されないとき

  • 該当メールアドレスが、既にリードまたは取引先責任者に存在する場合は、リードは作成されませんのでご了承ください。
  • リード検索時に「所有者」など個別にフィルタされていないかご確認ください。
  • 「事前確認」の３と４をご確認ください。
  • 【1】Salesforce側での事前設定の設定が誤っていないかご確認ください。
  • 【2】調整アポ側での連携方法の連携を解除し、Salesforceシステム管理者で再連携をお試しください。（Salesforce連携に使用したSalesforceアカウントがシステム管理者になっているかもご確認ください。）

行動が作成されないとき

予約フォーム入力フィールドがSalesforceフィールドに連携されないとき

  • 「事前確認」の３をご確認ください。
  • 予約ページの「詳細設定」＞左メニュー「Salesforce」＞「Salesforceフィールド」に設定されている値が正しいかご確認ください。
    （Salesforceフィールド名の確認方法はこちら）
  • 連携可能なSalesforceの項目のデータ型になっているかご確認ください。
  • Salesforceフィールドがチェックボックスでチェックが付かない場合、「フィールドタイプ」を「隠しフィールド」、「設定値」を「true」で設定しているかご確認ください。

不明点がある場合は、お気軽にお問い合わせください。

右上の「お問い合わせ方法」ボタンから、チャット・メール・フォームなどの各種お問い合わせが可能です。