LAMPData 360連携(オプション)Data 360連携を設定したい

Data 360連携を設定したい

このガイドでは、以下の方法をご紹介します

  • 拡張パッケージをインストールする
  • 読み取りの権限を確認する
  • データストリームを作成して、取り込みの受け皿を作る(友だち・自動応答・配信・グループ/会話)
  • 会話が入ることを確認する
  • 担当者(ユーザー)まで結び付ける
💡

始める前に

  • Data 360 が有効な Salesforce 組織で、Data 360 の管理者権限を持つユーザーで操作してください。
  • Igness への Data 360連携オプションのお申し込みが済んでいることをご確認ください。オプションが有効になるまで、会話は送られません。
  • Claude などの AI エージェントをお使いの場合は、LAMP のスキル「lamp-data360-setup」で、この記事の手順をまとめて実行できます。スキルの導入方法は AIエージェントで自動セットアップ をご覧ください。

1. 拡張パッケージをインストールする

Igness からご案内する URL を開きます。

「管理者のみのインストール」を選び、確認のチェックを入れて[インストール]をクリックします。

拡張パッケージのインストール画面(クリックで拡大)


「インストール完了!」と表示されたら、[完了]をクリックします。

この時点では、取り込みの定義(データキット)が届いているだけです。データストリームやデータモデルは、次の手順で作ります。

インストール完了の画面(クリックで拡大)

2. 読み取りの権限を確認する

Data 360 は、権限セット「Data Cloud Salesforce コネクタ」(英語の画面では「Data Cloud Salesforce Connector」)の権限で、友だち・自動応答・配信・グループ・グループメンバーを読み取ります。組織によっては、この権限セットに LAMP のオブジェクトを読む権限が付いていません。その場合、データストリームの作成に失敗するか、「稼働中」と表示されたまま0件になります。データストリームを作る前に確認してください。

[設定]→[ユーザー]→[権限セット]で「Data Cloud Salesforce コネクタ」を開きます。

[システム権限]で「すべてのデータの参照」にチェックが入っていれば、すべて読み取れるので、この手順は不要です。次の手順に進んでください。

チェックが入っていなければ、[オブジェクト設定]で、次の5つのオブジェクトにそれぞれ権限を付けます。

  • 友だち
  • 自動応答
  • 配信
  • グループ
  • グループメンバー

オブジェクトを開いて[編集]をクリックし、「オブジェクト権限」の「参照」と「すべてのレコードの参照」にチェックを入れます。続けて、「項目権限」で下の一覧の項目の「参照アクセス権」にチェックを入れ、保存します。

権限セットのオブジェクト権限

参照アクセス権を付ける項目の一覧

一覧にない項目は、権限を付けなくても読み取れます(必須項目など)。

友だち: クリック回数、取引先責任者、利用中のAI自動応答履歴、メール、初回友だちアクティビティ、初回流入日時、初回流入名、要対応?、AI応答中?、ブロック?、テスト用?、Lamp ID、言語、最終クリック日時、最終コンバージョン日時、最終メッセージ受信日時、最終メッセージ送信日時、リード、未返信、プロフィール画像URL、リッチメニュー、公式アカウント、ステータスメッセージ、ユーザーID

自動応答: エージェント、Agentforce エージェントAPI名、会話終了までの時間(h)、送信元、公式アカウント、順番、テンプレート

配信: 重複送信を許可、配信頻度、CSVファイルID、配信終了日時、システム?、ジョブID、最終エラー、最終エラー日時、配信モード、次回実行日時、レポートID、スケジュールのタイムゾーン、配信開始日時、配信回数、テンプレート

グループ: 参加状態、グループID、要対応?、最終メッセージ受信日時、最終メッセージ送信日時、人数、グループ画像URL、公式アカウント

グループメンバー: 最終メッセージ送信日時、メンバーキー、アイコンURL、友だち、参加状態、ユーザーID

⚠️

「Lamp ID」と「ユーザーID」(友だち)は会話と友だちを、「グループID」(グループ)と「メンバーキー」(グループメンバー)はグループトークの会話とグループ・メンバーを結び付けるのに使います。読み取れないと、会話からたどれません。

3. 友だち・自動応答・配信・グループのデータストリームを作る

データストリームは、2回に分けて作ります。先に、Salesforce の中にあるデータ(友だち・自動応答・配信・グループ・グループメンバー)から作ります。

アプリケーションランチャーで「Data Cloud」を開き、[データストリーム]タブで[新規]をクリックします。

「接続済みソース」の「Salesforce CRM」を選び、[次へ]をクリックします。

新規データストリームでSalesforce CRMを選ぶ(クリックで拡大)


一覧を下までスクロールし、「カスタムバンドル」にある「LAMP_Friend」を選びます。

右側の「含まれるオブジェクト」に、友だち・自動応答・配信・グループ・グループメンバーの5つが表示されます。「Salesforce 組織」は自動で入ります。

[次へ]をクリックします。

カスタムバンドル LAMP_Friend を選ぶ(クリックで拡大)


項目の画面は、そのまま[次へ]をクリックします。

最後の画面で「5 件のデータストリームとデータレイクオブジェクトが作成されます」と表示されていることを確認し、[リリース]をクリックします。

リリース前の確認画面(クリックで拡大)

4. 会話のデータストリームを作る

続けて、会話を受け取るデータストリームを作ります。入口が手順3とは異なります。

[データストリーム]タブで、もう一度[新規]をクリックします。

「他のソース」の「インストール済みデータキットおよびパッケージ」を選び、[次へ]をクリックします。

左の一覧から「Igness LAMP Data Kit」を選び、右に表示される「LAMP_Timeline」にチェックを入れて、[次へ]をクリックします(配下の「…Timeline」にも自動でチェックが入ります)。

データキットからLAMP_Timelineを選ぶ(クリックで拡大)


「取り込み API バンドルのコネクタを選択します。」の画面で、[新規コネクタ]をクリックします。

「コネクタ名」に Igness_LAMP と入力し、[保存]をクリックします。

⚠️

コネクタ名は、必ず Igness_LAMP にしてください(半角、大文字・小文字もこのとおり)。Igness のサーバーは、この名前を宛先にして会話を送ります。別の名前にすると、会話が届きません。

コネクタ名に Igness_LAMP と入力する


コネクタ名が「Igness_LAMP」になったことを確認し、[次へ]をクリックします。

項目の画面(プライマリキー、カテゴリ、イベント時刻項目は自動で設定されています)は、そのまま[次へ]をクリックし、最後に[リリース]をクリックします。

コネクタ名が Igness_LAMP になった状態(クリックで拡大)

5. 作成されたものを確認する

[データストリーム]タブに、次の6本が「稼働中」で表示されていれば完了です(ユーザーなど、ほかに取り込んでいるデータストリームがあれば、それも並びます)。

データストリーム内容
Igness_LAMP-Timeline会話
igns__SocialFriend__c_Home友だち
igns__Reply__c_Home自動応答
igns__Broadcast__c_Home配信
igns__SocialGroup__c_Homeグループ
igns__SocialGroupMember__c_Homeグループメンバー

あわせて、データモデル「Igness LAMP Timeline」(会話)、「Igness LAMP Friend」「Igness LAMP Reply」「Igness LAMP Broadcast」「Igness LAMP Group」「Igness LAMP Group Member」と、会話から友だち・自動応答・配信・グループ・グループメンバーへのリレーション、グループメンバーからグループ・友だちへのリレーションが作られます。

データストリームが6本作成された状態(クリックで拡大)

コネクタ名を後から確認したい

[設定]→[Data Cloud 設定ホーム]→「その他のデータソースを接続」→「外部インテグレーション」の「取り込み API」を開きます。一覧に、コネクタ名「Igness_LAMP」、状況「Connected」と表示されていれば正しく設定されています。

取り込みAPIのコネクタ一覧(クリックで拡大)

データストリームを作った直後の数分間に送られた会話は、Data 360 に入らないことがあります。データストリームを作り終えたら、Igness アカウントの組織の管理者が、Igness のアカウント画面で「過去の会話をData 360に送信」を一度実行してください。設定より前の会話とあわせて、取りこぼした会話も入ります。同じ会話が二重に入ることはありません。手順は「取り込み方式を変えたい・過去の会話を送りたい」をご覧ください。

6. 会話が入ることを確認する

テスト用の友だちとメッセージをやり取りしてから、Data 360 で確認します。取り込み方式が「標準」の場合は設定した間隔(既定は15分)の後、「即時」の場合は数分で表示されます。

Data Cloud アプリで[データエクスプローラー]タブを開きます。

[オブジェクト種別を選択]で「データモデルオブジェクト」を選び、[オブジェクトを選択]に「Igness LAMP Timeline」と入力して、「Igness LAMP Timeline」を選びます。

データエクスプローラーでオブジェクトを選ぶ(クリックで拡大)


会話が1行ずつ表示されます。

Data 360 に入った会話(クリックで拡大)

💡

最初は ID の列が多く表示されます。右上の[列を編集]で、occurredAt(日時)、body(本文)、direction(向き)、userId(相手)、sourceType(送信元の種別)、senderName(送信元の表示名)、messageType(種類)を選ぶと、内容を確認しやすくなります。各項目の意味は「Data 360に入るデータを確認したい」をご覧ください。

友だち・自動応答・配信・グループ・グループメンバーは、データストリームの作成の直後と、その後おおむね15分ごとに同期されます。同じ画面で「Igness LAMP Friend」を選ぶと、友だちを確認できます。

担当者(ユーザー)まで結び付けたい場合

担当者が送った会話は、Data 360 の標準の「User」に結び付きます。すでにユーザーを Data 360 に取り込んでいる組織では、何もする必要はありません。

取り込んでいない組織では、次の操作でユーザーを取り込むと、会話からユーザーへのリレーションが自動で有効になります。手順3〜4の前でも後でもかまいません。

[データストリーム]タブで[新規]→「Salesforce CRM」→[次へ]と進み、「標準バンドル」の「AgenticDataStreamUser」を選びます。

[次へ]→[次へ]→[リリース]をクリックします。

💡

「User」は、[オブジェクトを表示]の一覧には表示されません。バンドルの一覧から選んでください。

標準バンドル AgenticDataStreamUser を選ぶ(クリックで拡大)


作成直後は、データが空です。作成されたデータストリームの画面で[今すぐ更新]をクリックし、「フル更新」を選んで[今すぐ更新]をクリックします。数分でユーザーが取り込まれます。

今すぐ更新でフル更新を選ぶ(クリックで拡大)


[データモデル]タブで「Igness LAMP Timeline」を開き、[リレーション]に sourceUserId → User を含む6本が表示されていれば完了です。

会話のデータモデルのリレーション(クリックで拡大)

うまくいかないとき

会話が1件も入らない

次の順に確認してください。

  1. データストリームが6本あり、「稼働中」になっているか
  2. 取り込み API のコネクタ名が「Igness_LAMP」になっているか(手順5の「コネクタ名を後から確認したい」)
  3. Data 360連携オプションが有効になっているか
  4. 設定より前の会話を探していないか(過去の会話は自動では入りません)

1 と 2 に問題がなければ、お問い合わせください。送信が止まっている理由は、Igness 側で確認できます。Salesforce との認証のやり直しが必要な場合は、Igness からご案内します。

友だち・自動応答・配信・グループ・グループメンバーが0件のまま

手順2の読み取りの権限をご確認ください。権限を付けた後、データストリームで更新を実行します。

画像や動画の URL が空になっている

だれでも開ける URL は、Data 360 へ送りません。ファイルを非公開で保存する設定の組織では、LAMP の非公開の参照(https://files.mylp.jp/…)が入ります。この参照は Data 360 の画面からは開けません。ファイルを見るときは、友だちやグループのレコードから LAMP のチャット画面を開いてください。