lead-communication-history

リードとのコミュニケーション履歴

目標

保存されているメッセージ本文と通話記録から、適切なチャネル、方向、時刻とともに、特定のリードに関するコミュニケーションの質問に回答します。リードのコミュニケーションタイムラインの代わりに、複数リードを横断する検索プレビューやミーティングの記録を使わないでください。

ワークフロー

1. lead_id を正確に1つ特定します。
   • 利用可能な場合は、現在のリードスコープまたは明示された ID を使います。
   • それ以外の場合は、人物の名前、メールアドレス、電話番号を指定して list_leads を呼び出します。
   • 該当する可能性のあるリードが複数残る場合は、識別に役立つ詳細を示して、どのリードかを尋ねます。それぞれの履歴を決して統合しないでください。
2. 要求された内容について get_lead_history を呼び出します。
   • 対応するすべてのコミュニケーションを取得するには、channel: "call,whatsapp,email,sms" を渡します。
   • 1つのチャネルを指定するには、その正確な小文字の名前を渡します。
   • 最新のものから順に尋ねられた場合は order_by: "desc" を、時系列の説明を求められた場合は order_by: "asc" を使います。
   • limit は最大200まで指定できます。pagination.has_more が true で、完全な履歴が必要な場合は、false になるまで offset を増やして続けます。
3. 返されたアイテムの種類に応じて内容を読み取ります。
   • WhatsApp と SMS：type: "message" を読み取り、direction、content、添付ファイル、ステータス、timestamp を確認します。
   • メール：件名、本文、配信の詳細については type: "email" の行を、会話内容については type: "message", channel: "email" の行を読み取ります。方向、タイムスタンプ、存在する場合はプロバイダー ID、件名、本文を照合し、重複する記録を同じメールとして扱って二重に数えないようにします。
   • 電話：type: "call" を読み取り、summary と transcript を確認します。call_missed アイテムには会話の記録がありません。
   • direction: "outbound" は Nexor またはオペレーターが送信した内容、direction: "inbound" はリードから受信した内容として扱います。
4. 必要な場合に限り、適切な関連ツールを使います。
   • 多数のリードを横断して検索する場合は、search_conversations を使います。これは1人のリードに関する証拠としては使わないでください。対象範囲の限られたプレビューを返し、lead_id フィルターもありません。
   • 予定されたミーティングの記録を取得する場合は、list_transcripts の後に get_transcript を使います。これらのツールでは電話の通話記録は取得できません。
   • 既知のメッセージまたは時点の前後の文脈を求められた場合は、get_lead_history に anchor_ts と before、after を指定します。
5. 取得した証拠に基づいて回答します。コミュニケーションの出来事とその内容を分け、何が起きたかを述べてから、実際に何が話されたかを説明します。重要な内容については、チャネル、方向、タイムスタンプを含めます。

ガードレール

• pagination.has_more が true の間は、履歴が完全であると主張しないでください。
• 要約、失敗した通話、添付ファイル、空の本文、または途中で切れた／存在しない記録から、欠けている言葉を推測しないでください。確認できない内容を明記します。
• ミーティングの要約を電話の通話記録として扱わないでください。また、配信／開封イベントをメールの返信として扱わないでください。
• 通話が失敗した、または応答がなかったことを、電話番号が無効である証拠として扱わないでください。
• テナントとリードのスコープを正確に保ちます。あるリードのコミュニケーションを、別のリードに関する回答に決して使わないでください。
• これは読み取り専用のワークフローです。ユーザーが別途その操作を依頼しない限り、返信の送信、リードの変更、自動化の開始／停止は行わないでください。

出力

• 直接的な回答、または簡潔な時系列の説明から始めます。
• 送信した内容、受信した返信、通話記録内の発言、配信のみを示すイベントを区別します。
• 記録の欠落、本文が空であること、テキストとして表現されていない添付ファイル、未読ページなど、回答の確度に影響する不足事項を示します。