概述
用户是指与Bot发起对话的终端用户,GPTBots 支持开发者为不同用户设置唯一身份标识ID,通过该用户ID(UserId
) 可以在不同渠道之间进行用户 身份关联,实现跨渠道用户身份合并、 通过 Tools 实现业务业务查询、维护用户属性和聊天记录等。
定义
用户:
用户是指与 Bot 产生对话的终端用户。
匿名ID:
用户在非 API 的渠道平台与 Bot 发起对话时,系统会根据用户所在的渠道平台,为用户生成包含所在渠道平台信息的匿名 ID
。
UserId:
企业开发者自定义的用户身份唯一标识ID,由开发者自行为某个匿名 ID
设置 UserId
。UserId
级别>匿名 ID
,多个匿名 ID
可以同时属于一个UserId
。 UseId 的使用场景和高级用法请参考设置用户ID。
对话ID:
对话ID conversationID
用于标识匿名 ID
与Bot
的一次对话,conversationID
的自动过期时间为 60 分钟,过期后会再次生成一个全新的conversationID
用于标识匿名 ID
与Bot
的另一次对话。
当开发者通过 API 方式调用
conversationID
发起对话时,conversationID
不存在过期时间的判断逻辑。
对话ID的生成原理
GPTBots平台当前支持众多三方渠道平台(intercom 、webchat、 livechat 、 telegram 、 WhatsApp 等)和自建渠道(Bubble Widget、 iframe 和 API 等)。
当终端用户通过这些渠道平台与 Bot 发起对话时,系统会根据用户所在的渠道平台,为用户生成包含所在渠道平台信息的匿名 ID
,基于匿名 ID 生成conversationID
。conversationID
用于标识匿名 ID
与Bot
的一次对话,conversationID
的自动过期时间为 60 分钟,过期后会再次生成一个全新的conversationID
用于标识匿名 ID
与Bot
的另一次对话。
- 开发者通过 API 方式使用时,必须自行生成
conversationID
,并传入conversationID
参数方可发起与 Bot 的对话。 - 非API 的其他渠道平台,GPTBots会自动生成
conversationID
,生成的具体业务流程如下: