ferret OneとSalesforceは連携が可能です。
こちらのヘルプページでは、フォームデータ転送の方法についてご説明いたします。
目次
フォームデータ転送でできること
- ferret Oneで作った公開ページで登録されたデータをSalesforceのオブジェクトに登録することができます。（1つのフォームと1つのObjectをリンクさせることが可能）
- レコードタイプを指定することができます。
- キャンペーンを指定することができます。
「Object（オブジェクト）」とは
Salesforceでの取引先情報、連絡先電話番号、取引先の責任者などの決められた形式になり、「レコード」と呼ばれる情報がまとまる蓄積される場所です。
Salesforceでは予め用意された「標準オブジェクト」とオリジナルで定義する「カスタムオブジェクト」の2種類があり、ferret Oneではそれぞれのオブジェクトをフォームの項目と連携させ、フォームからSalesforceへデータを送信することができます。
また、ferret One→Account Engagement（旧 Pardot）→Sales forceと連携することで、リード管理も効率よくすることが可能です。
注意点①：1つのフォームは1つのオブジェクトにのみ連携可能
- フォームごとにオブジェクトの選択は可能です
- 異なるフォームであれば、同じオブジェクトを選択することも可能です
- カスタムオブジェクトでも連携可能です
【対策】Account Engagement（旧 Pardot）と連携する ／ salesforceのフォームを埋め込む
注意点②：データ型に注意
- ferret Oneフォームの形式とSalesforceのフィールド項目は必ずデータ型が合う様に設定する必要があります。
- データ型が合わない場合、レコード自体が無効になりCV情報がSalesforceへ引き継がれなくなります。
- ferret Oneのフォームの項目は「姓・名」を使用してください。
注意点③：標準住所に注意
Salesforceの標準住所を利用する場合、Salesforce側が
- 国
- 都道府県
- 市区郡
- 町名・番地
- 郵便番号
と分割したデータになるため、ferret One側も同様に分割する必要があります。
必要な項目はSalesforce側の設定によりますので、お客様にてご確認ください。
設定方法
解説動画（※音声が出ます）
オブジェクトを設定する方法
1. ferret Oneの外部サービス設定でSalesforceを連携する
※使用するには、あらかじめferret Oneとの連携設定をしておく必要があります。
■詳細な連携方法はこちら
＞Salesforce（セールスフォース）連携方法
2. Salesforceにログインし、オブジェクトマネージャーの一覧ページに遷移し、「+新規オブジェクト」を選択します
SalesforceオブジェクトについてはSalesforceのヘルプぺージをご確認ください。
https://help.salesforce.com/s/articleView?id=sf.dev_objectcreate_task_lex.htm&type=5
https://help.salesforce.com/s/articleView?id=sf.dev_objectcreate.htm&type=5
3. 必須項目を入力し、「保存」をクリックする
- 表示ラベル
例：fO連携テスト、フォームA、フォームBなど、フォーム自体の名前を記入
- オブジェクト名
例：fOtest、formA、formBなど ※アルファベット表記のみになるため注意
ページ下部の検索状況、オブジェクト作成オプションに必ずチェックを入れてください
4. 新規カスタムタブ 「ステップ1. 詳細を入力」の必須項目を入力し、「次へ」をクリックします
- レコード名
例：取引先名など - データ型
テキスト、数字など様々な種類があります。
取引先名ならテキスト情報なので「テキスト」を選びます
5. 新規カスタムタブ 「ステップ2.プロファイルを追加」で「次へ」をクリックします。
特に設定をしていただく項目はありませんので、そのまま次のフローに進んでください。
6. 新規カスタムタブ 「ステップ3.カスタムアプリケーションに追加」に遷移 保存をクリック
特に設定をしていただく項目はありませんので、そのまま次のフローに進んでください
7. オブジェクトマネージャーが完成
カスタムオブジェクトの作成はこれで完了です。
8. オブジェクトマネージャー 「項目とリレーション」に遷移し、右上の「新規」をクリックします
ferret Oneのフォームからデータを送信したい項目を追加していきます。
作成者、所有者、最終更新者はデフォルトで設定されています。
この項目作成がフォームの中でいう 「氏名」「メールアドレス」「住所」「郵便番号」 などのレイヤーになります。
9. カスタム項目新規作成 「ステップ1.データ型の選択」からデータ型を選択します。
ferret Oneフォームの形式とSalesforceのフィールド項目は必ずデータ型が合う様に設定する必要があります。
10. 「次へ」をクリックし、 カスタム項目新規作成 「ステップ2.詳細を入力」の必須項目を入力します
ferret OneでのSalesforceのフィールド名に当たります。
項目の表示ラベル、文字数、項目名を入力してください。
※「項目名」は必ず英語で入力してください
※項目の連携にはそれぞれ文字数制限があります。
■ferret Oneでの文字数制限についてはこちら
＞【画面説明】サイト／入力フォーム 入力フォーム一覧 編集（項目設定）
※Salesforce側の項目の詳細については、Salesforceのカスタマーセンターにお問い合わせください
11. 「次へ」をクリックし、カスタム項目新規作成 「3.項目レベルセキュリティ設定」で「次へ」をクリックします
12. カスタム項目新規作成 「4.ページレイアウトへの追加」で「保存」をクリックします
13. 項目とリレーションに追加した項目が表示されます。
14. ferret Oneの管理画面にログインをし、「サイト > 入力フォーム」より入力フォームの設定します。
■入力フォームの詳細はこちら
下記の場合、連携できていない可能性があります。
- SalesforceのAPIが有効化になってない場合（フォーム編集に入るとエラーが出る）
- もしくは、ferret Oneの設定：設定＞外部サービス設定＞Salesforce＞インスタンスURL がSalesforceの設定「私のドメイン」と不一致
15. 入力フォーム オプション設定で「オブジェクト」を選択します
Salesforceと連携設定が完了している場合、外部サービス（MAツール）の登録経路から作成したカスタムオブジェクトを選択することができます。
これでSalesforceのカスタムオブジェクトとferret Oneのフォーム連携は完了です。
16. 入力フォームの項目設定に「Salesforceフィールド名」が追加されていることを確認します
17. Salesforceへデータを送信したい項目の「編集」ボタンをクリックします
編集ボタンをクリックするとモーダルが表示されます。
選択リスト、ラジオボタン、チェックボックスは以下のような設定画面になります。
※バリュー（Salesforce側の連携内容）には、Salesforce側の「API 参照名」を入力します。
※チェックボックスは複数選択が可能なため、「A B」といった空白区切りでデータが連携されます。
※例
【入力フォーム例】
【連携データ例】
テレビ広告 ウェブ広告
18.「外部サービス連携」からSalesforceと紐付ける項目を選択し、「保存する」をクリックします
19. 入力フォームの項目「Salesforceフィールド名」に設定されていることを確認します
20. フォームが埋め込まれているページを更新し、完了です
作成したオブジェクトを確認する方法
1. Salesforceを設定した入力フォームがあるページに遷移します
2. 項目を入力し、送信ボタンをクリックします
3. Salesforceの管理画面に遷移します
4. アプリケーションランチャー アプリケーションを検索します
※Salesforceのアプリケーション作成時に「検索状況」にチェックをしていないと検索ができません
アプリケーションランチャーについてはSalesforceのヘルプページをご確認ください
https://help.salesforce.com/s/articleView?id=sf.identity_app_launcher.htm&type=5
5. 参照したデータの詳細ページにフォームで入力した内容が表示されます。
オブジェクト設定についてよくある質問
Q. 連携した後、フォーム設定で「組織でAPIが有効化になっていません」といったメッセージが出て、オブジェクトの選択ができません。どうしたらいいでしょうか？
A. 「組織で API アクセスが有効になっていません。API アクセスを有効にするには、Salesforce にご連絡ください。」というエラーメッセージが出る場合、ferret OneとSalesforceが正常に連携できていない可能性がございます。
Salesforce側の設定と、ferret One管理画面＞設定・管理＞外部連携設定＞Salesforceの設定にて入力いただいている各項目の値に相違がないかをご確認ください。
なお、正常に連携できている場合には、ferret One管理画面のSalesforceの連携状況のは「連携中：[解除する]」の表示に切り替わります。
Salesforceとの連携についてはこちらをご確認ください。
Q. Salesforceのオブジェクトの編集をした場合、fOとの連携をし直さなければいけないでしょうか？
A. Salesforceのオブジェクト項目を編集した場合、
fOのフォーム編集画面の「オプション設定」タブで「オブジェクトのフィールドを更新」ボタンをクリックすると、オブジェクトの項目のリストが更新され、新しい項目を設定できるようになります。
※Salesforce側で項目を更新した場合、ferret One側でも更新を行わないと項目は表示されないのでご注意ください。
Q. 登録経路でオブジェクトが表示されない場合はどうしたらいいですか？
A. 登録経路でオブジェクトが表示されない場合
Salesforce連携ユーザーとして設定されているユーザーのプロファイルを確認し、オブジェクトへの権限があるかを確認してください。
確認方法：Salesforce画面 設定 > 管理 > ユーザー > プロファイル > 標準オブジェクト権限
Q. フォームのデータがSalesforce側に連携されない場合はどうしたらいいですか？
A.下記、2つの手段のうち、いずれかをお試しください。
- 弊社テクニカルサポートにお問い合わせください
- Salesforceにお問い合わせください
いずれの際も下記手段にてエラーログを取得いただき、提出いただくとスムーズかと存じます。
◯該当Salesforceメニュー
設定 ＞ デバッグログ
自分のユーザーを「Edit」
開始日を今 例）2020/09/29 15:00
有効期限を明日 例）2020/09/30 14:59
※24時間以内に設定する必要があります
下記、Salesforceのヘルプページもご確認ください。
https://help.salesforce.com/articleView?id=code_add_users_debug_log.htm&type=5
連携するフォームを設定する方法
1.サイト > 入力フォーム フォーム一覧 フォーム編集 項目設定より「項目の詳細設定」を開きます初期値にフォーム名を識別する値を入力し、項目を非表示とします。（非表示する項目は、任意の項目で問題ありません）
フォーム連携時のエラーについて
オーナーと管理者にエラーメールが送信されます。
- APIが出力するエラーメッセージ
- 認証エラー
- 必須項目のエラー
- 重複エラー
など
参考エラーメール例
主なエラーメッセージ（抜粋）と解決方法
◾️エラーメッセージ例1
VALUE_STRING 値 XXX から XXX のインスタンスを並列化できないか、要求に必須項目がない可能性があります
解決方法
Salesforce側のデータ型とフォームのデータ型で相違が発生しています。Salesforce側のデータ型を見直してください。
◾️エラーメッセージ例2
DUPLICATES_DETECTED
解決方法
Salesforce側で重複を許可していません。Salesforce側の設定を見直してください。
◾️エラーメッセージ例3
REQUIRED_FIELD_MISSING
解決方法
Salesforce側で必須設定がされています。Salesoforce側の設定を見直すか、フォーム項目を必須にしてください。
◾️エラーメッセージ例4
解決方法
Salesforce側で変更不可の値となっています。Salesoforce側の設定を見直すか、別項目と連携してください。
送信するデータ項目についてよくある質問
Q. レコードタイプを指定して送信をしたいです、どうすればいいですか？
A. レコードタイプを指定して送信したい場合には、下記の方法にて設定が可能です。
管理画面左メニュー サイト > 入力フォーム > Salesforceに連携しているフォーム をクリックした画面で設定可能です。
【設定方法】
1.「オプション設定」タブへ移動します。
2.レコードタイプのセレクトメニューをクリックし、任意のレコードタイプを指定し、保存をします。
※レコードタイプを指定できるのは「リード」オブジェクトに連携している場合のみです
Q. Salesforceのキャンペーンにデータ送信をしたいです。方法はありますか？
A. キャンペーンを連携して送信をする場合は、別途個社設定（プロセスビルダーの開発）が必要となりますが、下記の方法で可能となります。
【設定方法】
1. Salesforceのオブジェクトマネージャーから「キャンペーン」を選択し、項目を編集します。
2. ferret Oneの管理画面にログインをし、入力フォームで「キャンペーン」を設定します。
3. Salesforceフィールド名に送信したい情報を選択します。
編集ボタンをクリックし、Salesforceで作成した項目を選択します。
項目の連携にはそれぞれ文字数制限があります。
※ferret Oneでの文字数制限についてはこちら
＞【画面説明】サイト／入力フォーム 入力フォーム一覧 編集（項目設定）
※Salesforce側の項目の詳細については、Salesforceのカスタマーセンターにお問い合わせください。
4. Salesforceを設定した入力フォームがあるferret Oneページに遷移します。
5. フォームの項目を入力し、送信ボタンをクリックします。
6. Salesforceの管理画面に遷移します。
7. アプリケーションランチャー アプリケーションを検索します。
Q. フォームの送信日時をSalesforceへデータ送信することはできますか？
A. はい、できます。
管理画面左メニュー サイト > 入力フォーム > Salesforceに連携しているフォーム をクリックした画面で設定可能です。
【設定方法】
1.「オプション設定」タブへ移動します。
2.「フォームCV日時通知先」をクリックし、任意の項目を指定し、保存をします。
※「フォームCV日時通知先」はCV日時が連携されます。
必要に応じて、対象のオブジェクトに対してカスタム項目（データ型は「日付/時間」）を作成し、設定ください。
もし、こちらの項目が不要であれば、「None」を設定ください。
Q . ラジオボタンやセレクトメニューの項目にバリュー情報を設定してSalesforceへデータ送信したいです。
A. 管理画面左メニュー サイト > 入力フォーム > Salesforceに連携しているフォーム をクリックした画面で設定可能です。
※フォームで表示する項目と異なる内容をSalesforceに連携したい場合のみ設定が必要です。
フォームで表示する項目と同じ内容をSalesforceに連携する場合はバリューは空白のままで問題ありません。
【設定方法】
1. 項目設定のでバリューを設定したいラジオボタンの編集ボタンをクリックします。
2. Salesforceに連携する項目を設定します。
3. Salesforceに連携するラベルとバリューを設定し、保存をします。
※項目を追加する場合は「項目を追加する」ボタンからできます。