変数

変数は、GPTBotsプラットフォームが提供する仕組みで、エージェントの実行プロセス中にデータを保存およびアクセスするために使用されます。ユーザーはテキスト入力フィールド、FlowAgentコンポーネント、およびワークフロー内で{{を入力することで、簡単に変数を導入できます。実行時に変数は自動的に正しい値に置き換えられ、値が存在しない場合は空値となります。

グローバル変数

フィールド名	型	説明
sys_dev_id	string	エージェント開発者のID
sys_agent_id	string	エージェントのID
sys_conversation_id	string	現在の会話のID
sys_anonymous_id	string	エージェントと対話中のユーザーの匿名ID。匿名IDは通常、サードパーティチャネルプラットフォームのユーザー固有識別子から取得されます。詳細は匿名IDの取得ロジックをご覧ください
sys_user_id	string	エージェントと対話中のユーザーID。ユーザーIDは開発者が定義したユーザー固有の識別子です
sys_lang	string	ユーザーポータルで使用される言語
sys_conversation_source	string	WhatsApp、Telegramなどの会話の統合チャネル。ログのソースと同じフィールドです
sys_user_message_count	number	現在の会話でユーザーが送信したメッセージの総数

グローバル変数はすべてGPTBotsプラットフォームによって自動的に値が設定されるため、ユーザーが手動で値を設定する必要はありません。

ブラウザ変数

フィールド名	型	説明
browser_info	string	ブラウザ名
browser_lang	string	ブラウザの現在の使用言語
browser_os	string	オペレーティングシステム
browser_timezone	string	タイムゾーン
browser_region	string	国または地域
browser_current_url	string	現在閲覧中のページURL
browser_source_url	string	リファラーURL
browser_duration_of_stay	number	現在のページの滞在時間

ブラウザ変数は、ユーザーがブラウザを通じて共有ページやワークスペースなどにアクセスする際に、GPTBotsプラットフォームによって自動的に取得・設定されます。ユーザーが手動で値を設定する必要はありません。API、WhatsApp、LINEなどのチャネルを通じてメッセージを送信する場合、ブラウザ変数は空値となります。

WhatsApp プロパティ

フィールド名	型	説明
wa_user_name	string	WhatsAppユーザーのニックネームまたは表示名
wa_user_id	string	WhatsAppユーザーの一意識別子（通常、国際形式の電話番号に@c.usを付加したもの）

WhatsAppプロパティは、ユーザーがWhatsAppチャネルを通じてメッセージを送信する際にGPTBotsプラットフォームによって自動的に取得・設定されます。ユーザーが手動で値を設定する必要はありません。

Telegram プロパティ

フィールド名	型	説明
tg_user_id	string	Telegramユーザーの一意識別子（システム内でユーザーを一意に識別するために使用）
tg_user_name	string	Telegramユーザーのニックネームまたは表示名（例：@username）
tg_lang_code	string	Telegramユーザーの言語設定コード（例：en、ja-JPなど）

Telegramプロパティは、ユーザーがTelegramチャネルを通じてメッセージを送信する際にGPTBotsプラットフォームによって自動的に取得・設定されます。ユーザーが手動で値を設定する必要はありません。

LiveChat プロパティ

フィールド名	型	説明
lc_org_id	string	Livechat組織の一意識別子
lc_chat_id	string	Livechatチャットセッションの一意識別子（会話全体の追跡に使用）
lc_thread_id	string	Livechatチャットセッション内の特定スレッドの一意識別子（会話内のサブトピックやメッセージシーケンスの整理に使用）
lc_user_id	string	Livechatエンドユーザーの一意識別子（システム内でユーザーを一意に識別するために使用）

LiveChatプロパティは、ユーザーがLiveChatチャネルを通じてメッセージを送信する際にGPTBotsプラットフォームによって自動的に取得・設定されます。ユーザーが手動で値を設定する必要はありません。