Agentforceでメッセージ履歴を取得する
LAMPのAgentforce拡張パッケージには、友だちやグループとのメッセージ履歴を扱うサブエージェント「LINE履歴の確認」が含まれます。Agentforceのエージェントに追加すると、履歴の要約や、過去のやり取りについての質問に答えられるようになります。
この記事では、Salesforceを利用する担当者向けのエージェントに、このサブエージェントを追加する例を紹介します。
アセットライブラリで検索する名称は「LINE履歴の確認」です。
サブエージェントには、履歴を取得するアクション「会話タイムラインを取得」と、回答のしかたを決める推論指示が設定済みです。アクションを個別に作成する必要はありません。
事前に準備するもの
- Igness LAMP 1.163.0.3以降がインストールされ、初期設定・公式アカウントの接続が完了しているSalesforce組織。
- Igness LAMP - Agentforce Extension Package 1.1.0.2以降。Einstein生成AIが有効な組織でのみインストールできます。
- Agentforceが有効で、編集・テストできる担当者向けのエージェント。Agentforceに必要なライセンス・権限はSalesforce側でご準備ください。
- LAMPのチャットでメッセージ履歴を確認できる、テスト用の友だちレコード。
バージョンはSalesforceの「設定」→「インストール済みパッケージ」で確認できます。
1. 拡張パッケージをインストールする
Agentforce拡張パッケージ(バージョン1.1.0.2以降)をインストールします。インストール方法と必要な環境は、「Agentforce拡張パッケージ」とは?をご覧ください。
2. エージェントにサブエージェントを追加する
- Agentforce Builderで対象の担当者向けエージェントを開きます。
- エクスプローラーの「リソースを追加」(+)→「アセットライブラリから追加」を開きます。
- 「LINE」で検索し、「LINE履歴の確認」の「選択」をクリックしてから、「エージェントに追加」をクリックします。
追加すると、サブエージェントに推論指示と「会話タイムラインを取得」アクションが設定された状態で表示されます。
- 日本語で利用する場合は、「言語設定」のデフォルト言語を「Japanese」にします。
- 「保存」をクリックします。
言語を変更した後、プレビューで「コンパイルエラーが発生しました」と表示される場合があります。
エラーの内容が「Missing value for ‘additional_locales’」などLanguageに関するものであれば、Builderの右上の表示切り替えで「スクリプト」を開き、language: の部分を次のように1行ずつに直して保存してください。
language:
default_locale: "ja"
additional_locales: ""
all_additional_locales: False推論指示は、エージェント内で自由に書き換えられます。回答の形式や、未回答の質問の扱いなどを業務に合わせて調整してください。
拡張パッケージをアップグレードしたら、「LINE履歴の確認」を追加し直してください。
サブエージェントの推論指示とアクションの設定は、エージェントに追加したときにエージェントへ写し取られます。そのため、拡張パッケージをアップグレードしても、追加済みのサブエージェントは新しい内容になりません。アップグレードした後は、エージェントから「LINE履歴の確認」を削除し、アセットライブラリから追加し直してください。追加し直すと、自社で書き換えた推論指示は元に戻るので、書き換えた内容を事前に控えておき、追加し直した後にもう一度反映してください。
3. 友だちレコードIDを指定して試す
- LAMPの「友だち」から、メッセージ履歴があるテスト用レコードを開きます。
- URLの
/igns__SocialFriend__c/と/viewの間にある、15桁または18桁のレコードIDをコピーします。 - Agentforce Builderの会話プレビューで、次のように依頼します。
<友だちレコードID>はコピーしたIDに置き換えてください。
新しいBuilderでは「Preview」タブの「ライブテスト」を使います。
友だちレコードID「<友だちレコードID>」のメッセージ履歴を要約してください。続けて「この履歴の中で、まだ回答していない質問はありますか?」などと質問できます。期間を区切って聞くこともできます。
友だちレコードID「<友だちレコードID>」の、先週のやり取りを要約してください。プレビューの実行内容で、履歴取得アクションが呼ばれたこと、入力の友だちレコードIDが正しいこと、errorMessage が空で transcript に内容が返っていることを確認してください。期間を区切って聞いた場合は、入力の after・before に期間が入っていることも確認します。回答が元のチャットの内容と一致することも確認します。
以下は、検証用の架空の会話5件を取得して要約した例です。在庫・価格・ギフト包装には回答済みで、金曜日までの配送についての質問は未回答であることを、取得した履歴から確認できています。
実運用でIDを毎回入力したくない場合は、表示中のレコードや関連レコードから対象の友だちIDを渡す設定を別途行います。LAMPのチャットコンポーネントを配置するだけでは、Agentforceに対象の友だちIDは渡りません。
グループの履歴を確認する
Igness LAMP 1.165 以降と Agentforce 拡張パッケージ 1.3 以降では、公式アカウントが参加しているグループのやり取りも取得できます。友だちレコード ID の代わりにグループ(igns__SocialGroup__c)のレコード ID を渡すと、発言者の名前付きでグループの履歴を返します。それより前のバージョンからアップグレードした場合は、上の注意のとおり、エージェントから「LINE履歴の確認」を削除し、アセットライブラリから追加し直してください。画面での使い方は グループトークでメッセージをやり取りしたい をご覧ください。
アクションの入力と出力
「会話タイムラインを取得」アクションは、次の値を受け取ります。
| 入力 | API名 | 内容 |
|---|---|---|
| 友だち・グループのレコードID | socialFriendId | 必須。友だち(igns__SocialFriend__c)またはグループ(igns__SocialGroup__c)のレコードID |
| 最大件数 | maxMessages | 通常は指定しません |
| この時点以降 | after | 期間の始まり。日付(YYYY-MM-DD)または日時(YYYY-MM-DDTHH:mm) |
| この時点より前 | before | 期間の終わり。日付または日時、または前回の出力の nextBefore |
次の値を返します。
| 出力 | API名 | 内容 |
|---|---|---|
| 会話履歴 | transcript | 日時と話者の付いた、古い順のテキスト |
| 件数 | messageCount | 会話履歴に含まれるメッセージの件数 |
| さらに古い履歴あり | hasMore | 取得した範囲より古い履歴が残っていれば true |
| 続きの取得位置 | nextBefore | さらに古い履歴を取得するときに before へ渡す値 |
| 最古の日時 | oldestDatetime | 会話履歴の中で一番古いメッセージの日時 |
| 現在日時 | currentDatetime | 実行した時点の日時 |
| エラー | errorMessage | 取得できなかったときの理由。取得できたときは空 |
取得できる履歴の範囲
このアクションは、指定した友だちまたはグループのメッセージ履歴を、新しいものから順に、約12,000文字の上限に収まるところまで1回でまとめて取得します。範囲は件数ではなく文字数で決まるため、短いメッセージが多い会話ほど多くの件数をさかのぼれます(最大500件)。メッセージの本文は途中で切らずに1件ずつ丸ごと入れ、担当者側から同じ文面を何度も送っている場合(定型の自動返信など)は、最新の1件だけを残して文字数を節約します。
取得した履歴は、古い順のテキストで返ります。日付が変わるところに「■2026-10-01」のような見出しが入り、各行の先頭には「14:05 お客さま:」「14:07 担当者:」のように時刻と話者が付きます。グループの履歴では、「お客さま」の代わりに発言した人の名前が入ります。お客様が引用して返信したメッセージには引用元の日時・話者・本文の先頭が、ケースなどのレコードに紐づいたメッセージ(Igness LAMP 1.166 以降)にはそのレコードの種類・名前・IDが、行末に付きます。このため、「1週間前の件」のように日付を手がかりにした質問にも答えられます。
期間を区切って取得することもできます。入力の「この時点以降」(after)に期間の始まりを、「この時点より前」(before)に期間の終わりを渡します。「この時点より前」に指定した時点ちょうどのメッセージは含まないので、たとえば9月中のやり取りなら、after に 2026-09-01、before に 2026-10-01 を渡します。サブエージェントの推論指示には、「先週」「9月中」のような言い方を、実行した日を基準にこの2つへ換算する指示が入っています。担当者は、ふだんの言葉で期間を伝えるだけで構いません。
文字数の上限に達して、それより古い履歴が残っている場合は、出力の「さらに古い履歴あり」(hasMore)が true になり、「続きの取得位置」(nextBefore)に値が入ります。この値を次の実行の「この時点より前」に渡すと、続きの古い履歴を取得できます。推論指示では、担当者がさらに古い履歴の確認を求めたときだけ続きを取得し、それ以外のときは、取得した中で一番古い日時(oldestDatetime)より前は確認していないことを回答に添えるようにしています。
画像・動画・添付ファイルの中身は読み取りません。返された本文を回答の根拠にします。また、複数の友だちやグループをまたいだ検索には対応していません。
見つからない・取得できない場合
| 状況 | 確認すること |
|---|---|
| アセットライブラリに「LINE履歴の確認」が出てこない | 「インストール済みパッケージ」で、Agentforce Extension Packageが1.1.0.2以降か確認します。インストール・アップグレード後はBuilderを開き直してください。 |
| 「レコードIDの形式が正しくありません」(1.164 以前は「友だちレコードIDの形式が正しくありません」) | LINEのユーザーID、ケースID、取引先責任者IDではなく、igns__SocialFriend__c(グループの場合は igns__SocialGroup__c)のレコードIDを渡します。 |
| 「対象の友だちレコードが見つからないか、アクセス権がありません」「対象のグループレコードが見つからないか、アクセス権がありません」 | 実行ユーザーのオブジェクト・項目・レコード共有権限と、友だち(またはグループ)の公式アカウントとの紐づけを確認します。 |
| 「会話履歴を取得できませんでした」 | 対象のチャットに履歴があるか、LAMPの接続・認証設定と実行ユーザーの外部ログイン情報へのアクセス権を確認します。期間を指定せずに実行して履歴が1件もなかった場合も、このメッセージになります。このメッセージだけで、履歴が存在しないと断定しないでください。 |
| 「指定した期間の会話履歴はありません」 | 期間(after・before)の中にメッセージがありません。プレビューの実行内容で、渡された期間が質問の意図どおりかを確認します。before に指定した時点ちょうどのメッセージは含まれません。 |
| 履歴取得が呼ばれない | 「LINE履歴の確認」がエージェントに追加・保存されているか、質問に友だちレコードIDが含まれているかを確認します。プレビューの実行内容で、どのサブエージェントに振り分けられたかを確認できます。 |
管理者向け:実行ユーザーの権限
権限は、エージェントを設定する管理者だけでなく、実際にアクションを実行するユーザーに必要です。エージェントの種類や実行場所に応じて、ログイン中の担当者またはエージェント実行ユーザーを確認してください。
- Apexクラス
igns__LampGetTimelineHistoryActionへのアクセス。 - 友だち(
igns__SocialFriend__c)・公式アカウント(igns__SocialAccount__c)の参照権限と、対象レコードの共有。 - 友だちのユーザーID(
igns__UserId__c)など、履歴取得に使う項目の参照権限。 - 外部ログイン情報
igns__APIAccessのプリンシパルPrincipalへのアクセス。
Einstein Agent Userライセンスの実行ユーザーでは、LAMPの一般ユーザー向け権限セットをそのまま割り当てられない場合があります。その場合は、上記の参照・実行権限を含む専用の権限セットを作成してください。


