客服入口接口

自建系统这里只提供真实业务接入接口，不再维护演示玩家、聊天、知识库或 RAG 页面。玩家身份请由平台/游戏业务后台校验后，再调用入口接口生成客服初始化参数。

接口地址

POST /api/customer-service/entry

线上示例：https://tgtp8.wancms.com/api/customer-service/entry

必填字段

• platform_id：平台 ID。
• game_id：游戏 ID。
• platform_open_id：平台主账号稳定唯一标识；同一平台账号下不同小号应保持一致。
• external_player_id：可选，小号 / 角色 / 游戏内玩家 ID；和 platform_open_id 不同时，客服侧会单独显示“小号”。
• nickname：玩家昵称。

请求示例

{
  "platform_id": 9001,
  "game_id": 9001,
  "platform_open_id": "platform_user_10001",
  "external_player_id": "role_9001_10001",
  "nickname": "玩家昵称",
  "server_id": 1,
  "server_name": "一区",
  "role_id": "role_10001",
  "role_name": "剑客小明",
  "vip_level": 8,
  "total_recharge_amount": 1288.50,
  "custom_attributes": {
    "channel_name": "小米渠道"
  }
}

返回用法

const entry = await response.json()
TGOWidget.init(entry.widget.init)
TGOWidget.show()