Salesforceで新たに作成されたリードに対して、VideoAgentの個人別URLを自動生成し、同期できる機能です。
Salesforce上でリードが作成されたタイミングをトリガーに、
LOOVで個人別URLを自動発行
Salesforceのプロパティに視聴URLを自動保存
することが可能です。
ご利用前の注意事項
LOOVのご利用プランについて
LOOVの一部プラン／オプション契約の方のみ利用可能です。
詳しくは管理画面右下のチャットよりサポートまでお問い合わせください。
Salesforceのご利用プランについて
本機能の利用には、Enterprise / Performance / Unlimited / Developer が必要です。
プランに関する確認・お問い合わせはSalesforce社にご確認ください。
①LOOV管理画面 ＞ 外部連携 ＞ Salesforce連携 より以下を設定します。
トグルを「有効」にし、以下情報を入力します。
Salesforceの組織ドメイン名
コンシューマ鍵
コンシューマの秘密
（任意）連携エラー通知先メールアドレス
② 「認証確認する」を押し、連携が正しくできているか確認します。
Salesforce連携の詳しい設定手順は以下をご覧ください。
③「APIキー管理」設定にてAPIキーを発行します。
ご注意ください
Salesforceの仕様は変更されることがあるため、弊社で常に最新の内容を保証することはできません。 不明点がある場合は、Salesforceのサポートへ直接ご確認いただくのが確実です。
リードオブジェクト内に、以下のカスタム項目を作成します。
個人別URLは、複数設定することが可能です。
①Salesforceの設定 > オブジェクトマネージャー > リードを開く
②項目とリレーション > 新規
項目ラベル名（任意） | 項目名 | 用途 |
例：LOOV視聴履歴 |
| 視聴データを記載するための項目 |
例：個人別URL | 任意 | 個人別URLを自動生成するための項目 |
③項目レベルセキュリティ（閲覧権限）を必要なプロファイルに付与
④ページレイアウトに追加
① 設定のクイック検索で 「指定ログイン情報」 を検索して開く
②「外部ログイン情報」のタブを開く
③「新規」をクリックし作成する
表示ラベル：apiKey
名前：apiKey
認証プロトコル ：カスタム
① 外部ログイン情報 > 「apiKey」をクリック
②カスタムヘッダーの「新規」をクリック
③カスタムヘッダーを作成する
下記の値を追加し保存します。
名前：
x-api-key値：初期設定00で発行したLOOV APIキー
連番：1
①プリシンパルの「新規」をクリック
②プリンシパルを作成する
パラメーター名：
API key pricipal
設定（Setup）のクイック検索で 「指定ログイン情報」 を検索して開く
新規（New） を押す
以下を設定
項目名 | 値 |
表示ラベル | 任意 |
名前 | 任意 |
URL | https://api.service.loov-video.com/external/v1/generate-scenario-url |
外部ログイン情報 | 外部ログイン： |
作成した外部ログイン情報（プリンシパル）を利用できるよう、権限セットを作り、対象ユーザーへ付与します。
手順：
①設定 > 権限セット > 新規で権限セットを作成（例：LOOV External API Access）
②権限セット内で 「外部ログイン情報プリンシパルアクセス」 を開く
③編集 > 作成したプリンシパルを「有効な外部ログイン情報プリンシパル」に追加
④この権限セットを、以下のいずれか（運用に合わせて）へ割り当て
リードを作成する可能性があるユーザー（推奨：一括で付与）
連携専用ユーザーを運用している場合はそのユーザー
手順：
① 設定 > フロー > 新規フロー
②トリガーされた自動化 > レコードトリガーフローを選択
③下記内容を設定する
オブジェクト：リード
トリガー：レコードが作成されたとき
実行：保存後
④「非同期パスを追加」を有効化
非同期パス配下に「HTTPコールアウト」を作成します。
手順：
①非同期パス上で要素を追加し「アクション」を選択
②最下部の「HTTP コールアウトを作成」を選択
③呼び出し設定
名前：
getsessionurl指定ログイン情報：「05. 指定ログイン情報を作成」で作成したログイン情報を選択
④呼び出し可能なアクションの設定をする
以下情報を入力し、「次へ」をクリック
表示名：任意
メソッド：POST
⑤サンプルJSON表示に以下のサンプルコードを貼り付けし、「確認」 > 「次へ」をクリック
💡サンプルです（フロー上では後で各項目をマッピングします）。
⑥レスポンス（戻り値）を設定
LOOVは以下形式でURLを返します。
⑦リクエストボディを設定 > Apexで定義した変数を値に設定
HTTPコールアウトの前に 「割り当て」 を入れて、リードのフィールド値をリクエストボディへマッピングします。
フローのツールボックス>新規リソースから変数をあらかじめ設定いたします。
手順
リソース種別 > 権限セット
API参照名（例：
loov_request）データ型 ：Apex 定義
Apex クラス ：例：
ExternalService_getsessionurl_LOOV_IN_body
scenarioId：固定値（LOOVから払い出された シナリオID/CUID）
organization：Leadの会社名（例：$Record.Company）
name：Lead氏名（例：$Record.LastName + $Record.FirstName）
email：$Record.Email
externalSource.product：固定値 "salesforce"
externalSource.salesforceTarget.type：固定値 "Lead"
externalSource.salesforceTarget.leadId：$Record.Id
補足
name をフルネームで渡したい場合は、フローで「数式リソース」を作って連結する運用が分かりやすいです。
例：IF(ISBLANK({!$Record.FirstName}), {!$Record.LastName}, {!$Record.LastName} & " " & {!$Record.FirstName})
シナリオIDの確認方法
LOOV動画編集画面URL内の
https://service.loov-video.com/scenario?id= [xxx] の[xxx] 箇所がシナリオIDです
HTTPコールアウト後に 「レコードを更新」 を追加し、LOOV外部APIが返す url をリード項目へ格納します。
手順：
①HTTPコールアウトの次に 「レコードを更新」 を追加
②更新対象：トリガー元のLeadレコード
③「リードの項目値をレコードに設定」箇所の「値」を設定する
LOOVSessionURL__c＝url
最後にフローを「有効化」し、設定を完了します。
リード生成時に個人別URLが格納されていますので、メール配信などにそのままご利用いただけます。
リードが動画を視聴した場合、視聴履歴URLが自動反映されます。