概述
最新更新:2024-11-27

概述

用户是指与Bot发起对话的终端用户,GPTBots 支持开发者为不同用户设置唯一身份标识ID,通过该用户ID(UserId) 可以在不同渠道之间进行用户 身份关联,实现跨渠道用户身份合并、 通过 Tools 实现业务业务查询、维护用户属性和聊天记录等。

定义

用户
用户是指与 Bot 产生对话的终端用户。
匿名ID
用户在非 API 的渠道平台与 Bot 发起对话时,系统会根据用户所在的渠道平台,为用户生成包含所在渠道平台信息的匿名 ID
UserId
企业开发者自定义的用户身份唯一标识ID,由开发者自行为某个匿名 ID设置 UserIdUserId级别>匿名 ID,多个匿名 ID可以同时属于一个UserId。 UseId 的使用场景和高级用法请参考设置用户ID
对话ID
对话ID conversationID 用于标识匿名 IDBot的一次对话,conversationID 的自动过期时间为 60 分钟,过期后会再次生成一个全新的conversationID用于标识匿名 IDBot的另一次对话。

当开发者通过 API 方式调用conversationID 发起对话时,conversationID不存在过期时间的判断逻辑。

对话ID的生成原理

GPTBots平台当前支持众多三方渠道平台(intercom 、webchat、 livechat 、 telegram 、 WhatsApp 等)和自建渠道(Bubble Widget、 iframe 和 API 等)。
当终端用户通过这些渠道平台与 Bot 发起对话时,系统会根据用户所在的渠道平台,为用户生成包含所在渠道平台信息的匿名 ID,基于匿名 ID 生成conversationIDconversationID 用于标识匿名 IDBot的一次对话,conversationID 的自动过期时间为 60 分钟,过期后会再次生成一个全新的conversationID用于标识匿名 IDBot的另一次对话。 alt text

  • 开发者通过 API 方式使用时,必须自行生成conversationID,并传入conversationID参数方可发起与 Bot 的对话。
  • 非API 的其他渠道平台,GPTBots会自动生成conversationID,生成的具体业务流程如下: