ユーザー概要

「ユーザー」とは、エージェントとやり取りする最終利用者を指します。GPTBotsでは、開発者が各ユーザーに対して一意のID（UserId）を設定することができ、これによりチャネルをまたいだユーザー識別や連携が可能になります。このUserIdを使うことで、IDの一元管理、業務問い合わせ時のツール利用、ユーザー属性の管理、チャット履歴の管理などを実現できます。

定義

ユーザー

ユーザーとは、エージェントと対話を行うエンドユーザーを指します。

ユーザーID（user_id）

企業の開発者がエンドユーザーに付与する一意の識別子です。API経由で特定の匿名IDにUserIdを設定することができます。UserIdの利用シーンと高度な使用方法についてはユーザーIDの設定をご参照ください。

• userIdは匿名IDより優先されます
• 複数の匿名IDを1つのuserIdに関連付けることができます

匿名ID（anonymous_id）

ユーザーがサードパーティプラットフォーム（Telegram、WhatsApp、LINEなど）でエージェントと対話する際、GPTBotsはそのプラットフォームのユーザー固有識別子をanonymous_idとして使用します。匿名IDの生成ロジックについては[匿名IDの値設定ロジック](## 匿名IDの値設定ロジック)をご参照ください。

サードパーティプラットフォーム

GPTBotsプラットフォームは現在、多数のサードパーティプラットフォームとの連携をサポートしており、Intercom、WebChat、LiveChat、Telegram、WhatsAppなどが含まれます。

会話ID（conversation_id）

会話ID（conversationID）は、ユーザーとエージェントの1回の対話シーンを識別するために使用され、異なるビジネスシーンを分離する最小単位です（通常、複数のメッセージIDを含みます）。

• conversationIDの自動期限切れ時間は60分ですが、API経由で生成されたconversationIDには期限切れはありません。
• サードパーティプラットフォームやウィジェットのチャットバブルなどのチャネルで生成されたconversationIDは、期限切れ後に新しいconversationIDが生成され、新しい対話が開始されます。

メッセージID（message_id）

メッセージID（messageID）は、エージェントとユーザー間の1回の対話メッセージを識別するために使用され、エージェントとユーザーの1回の対話の最小単位です。

• messageIDはGPTBotsプラットフォームによって生成され、開発者が独自に設定することはできません。
• messageIDはconversationIDに属し、1つのconversationIDは通常複数のmessageIDを含みます。

会話ID（conversation_id）の生成原理

ユーザーがサードパーティプラットフォームを通じてエージェントとの会話を開始すると、システムはそのプラットフォームに基づいて匿名IDを生成し、その匿名IDを基にconversationIDを自動的に生成して、ユーザーとエージェント間の1回の会話を管理します。

• 開発者がAPI経由で利用する場合は、まずconversationIDを生成し、そのconversationIDパラメータを渡してからエージェントとの会話を開始することができます。
• API以外のチャネルプラットフォームでは、GPTBotsが自動的にconversationIDを生成します。生成の具体的な業務フローは以下の通りです：
  

サードパーティプラットフォームの匿名ID（anonymous_id）の設定ロジック

GPTBots内蔵チャネルの匿名ID（anonymous_id）設定ロジック

GPTBotsプラットフォームの会話ID（conversation_id）ソースフィールド値一覧

会話ID（conversation_id）は agent_id と user_id / anonymous_id から生成され、異なるチャネルのユーザーが生成する会話IDのタイプは、異なるソースフィールド値でマークされます。このソースフィールド値を使用してチャネルごとにチャット履歴データを照会できます。