HiWelink帮助说明

外贸AI智能客服

HiWelink AI 智能客服 功能与使用说明
更新日期：2026-08-26 适用对象：HiWelink 商家用户（主账号）、平台管理员 功能入口：登录 www.hiwelink.com → 用户中心 → AI 智能客服（Chatbot）
一、产品简介
HiWelink AI 智能客服是一套嵌入式 AI 对话机器人：把一段代码放到您的网站（或电商店铺）后，访客即可在页面右下角与 AI 客服对话。
基于 RAG 知识库（文档/网页/视频/图片 OCR 向量化检索）回答业务问题；
对接 OpenAI 大模型流式生成回复，支持多语言（自动跟随访客语言）；
可绑定电商店铺（WooCommerce / Shopify / 通用 API），实现商品推荐、商品对比、订单查询；
自动采集访客联系方式，把高价值访客沉淀为客户线索；
支持多机器人、多域名独立部署、自有 API Key 接入、人工介入转接。
二、功能总览
角色
功能
访客端
对话窗口、欢迎语、FAQ 快捷命中、商品卡片、订单查询、联系人表单、聊天历史、多语言回复
商家端（用户中心）
多机器人、外观/行为/对话配置、FAQ 管理、知识库管理、电商绑定、域名嵌入、会话列表、人工接管
平台端（管理员后台）
OpenAI/Embedding 配置、限流与会话策略、实时推送、视频转写、Sitemap、OCR、人工介入开关
三、访客端使用说明（最终用户视角）
访客在您的网站上看到右下角的机器人气泡，点击即可开始对话：
开始对话：打开聊天窗口，AI 客服发送欢迎语；FAQ 或常见问题可一键点击提问。
自由提问：直接输入问题（支持中/英/西/阿等，回复自动使用访客的语言）。
查看商品：询问商品相关问题时，窗口内直接展示商品卡片（图片/价格/链接），可继续对比多个商品。
查询订单：绑定电商店铺后，说出订单号或邮箱即可查询订单状态。
留联系方式：AI 会在合适时机弹出联系人表单（姓名/邮箱等），提交后商家侧自动生成客户线索。
聊天记录：刷新页面后仍可加载本次会话历史继续对话。
访客数据（位置/设备/访问页面/浏览商品）会用于商家侧分析，但仅归属该商家租户，不跨商户共享。
四、商家端配置指南（用户中心）
入口：登录 → 用户中心 → AI 智能客服 → 「管理机器人」进入编辑页，共 5 个配置页签。
4.1 外观（Appearance）
机器人头像：上传机器人头像与窗口切换图标（气泡按钮图）。
机器人名称 / 简介：窗口顶部展示的名称与一句话简介。
欢迎消息：访客打开窗口后收到的首条消息。
主题色：窗口主色调（品牌色跟随）。
4.2 行为（Behavior）
语气（Tone）：专业/友好/简洁等回复风格。
客户指令（Instructions）：自定义对话规则，例如"先询问预算再推荐"、"禁止讨论竞品"等，注入 AI 提示词。
4.3 对话设置（Settings）
联系人收集：开启后 AI 会在对话中引导访客留下联系方式；
模式一：表单模式（对话后自动弹出结构化表单，必填校验）；
模式二：对话模式（AI 自然询问并从对话中提取姓名/邮箱）。
自有 OpenAI 配置（可选）：填写自己的 API Key、模型、温度、最大回复 Token、消息长度上限；开启后本机器人优先用您的 Key 计费与调用。
电商推荐：商品推荐开关、推荐数量、是否仅推荐有库存商品。
4.4 公司信息（Company Info）
配置公司名称、官网、邮箱、电话等，AI 回答中可引用。
4.5 FAQ 管理
录入"问题 → 答案"；访客消息与 FAQ 问题精确命中时，AI 不检索知识库、不调用大模型，直接返回答案（零成本秒回），并对措辞做自然润色。
FAQ 带点击量统计，便于持续优化。
4.6 知识库管理（RAG 知识库）
进入用户中心 → 知识库（文档）：
上传 PDF / Word / TXT / 网页 等文档，系统自动分块并向量化（Embedding）；
支持 视频转文字（平台开启后，提交视频链接自动生成文字稿入库）；
支持 Sitemap 抓取（提交站点地图批量收录网页内容）；
支持 图片文字识别 OCR（平台开启后，图片中的文字可被检索）。
访客提问时，系统先对问题做语义归一（缩写展开、大小写统一、音译转写）再检索最相关内容，连同会话历史一起交给大模型生成回答。
4.7 电商绑定（选做）
在用户中心绑定 WooCommerce / Shopify / 通用 API 店铺并保持"已激活"后，机器人即可：
商品搜索与推荐卡片展示；
多商品对比（如"A 与 B 哪个更好"）；
订单查询（确定性流程，不走大模型，准确率高）。
未绑定店铺时，AI 会如实告知"当前不支持订单查询"。
4.8 安装嵌入（Installation）
机器人通过以下任一方式部署到您的网站：
方式 A：嵌入脚本（推荐）
在「安装」页签为你的域名生成安装代码（Token），可添加多个域名并分别启用/停用；
复制 
<script> 嵌入代码，粘贴到网站 
</body> 前即可。
每个安装域消耗 1 个「嵌入域名」配额。
方式 B：电商插件（如 WordPress/WooCommerce）
按安装页签给出的插件方法，安装插件后在主题设置填入安装代码。
方式 C：主题函数 / 直接编辑（进阶）
主题 
functions.php 或主题文件直接引入嵌入脚本（安装页签提供模板代码）。
方式 D：聊天短链接（Chat Link）
复制专属短链接（short code），通过短信/邮件/WhatsApp 发给客户，访客打开即可直达与您机器人的会话（无需部署到网站）。
嵌入地址为 
https://www.hiwelink.com 提供的脚本，请勿使用本地地址。
五、会话与线索管理
会话列表（用户中心 → 会话）：查看所有访客会话，支持搜索、筛选、打开继续跟进；
人工接管：平台开启"人工介入"后，可将特定会话切给人工（客服）处理，人工回复实时推送给访客；
客户线索：访客留下联系方式后自动创建为联系人（来源=Chatbot），进入用户中心的联系人列表，供线索 AI 管理与跟进使用；新线索触发通知。
访客信息：会话自动记录访客地区（IP 归属地）、设备、访问页面、浏览商品等，辅助判断意向。
六、配额与限制
月度消息配额：每个商家账号每月可处理的访客消息条数受套餐限制，用尽后访客收到友好提示（机器人暂停回复）。
嵌入域名配额：可安装机器人的域名数量受套餐限制，删除域名可释放配额。
知识库大小：单文档大小、分块 Token 上限由平台 Embedding 设置控制。
限流：平台可设置每会话/每访客/每 IP 的消息频率限制，防滥用。
回复语言：默认英语；访客使用其他语言时 AI 自动跟随（平台可配置默认语言）。
七、常见问题（FAQ）
Q1：为什么机器人不回复？ 依次检查：机器人是否已启用（未暂停）；账号月度消息配额是否用尽；平台实时推送（Pusher/轮询）是否正常；平台限流是否触发。
Q2：知识库不生效？ 确认文档已上传并完成向量化（大文档需要处理时间）；问题与文档内容差异大时可能检索不到，可补充 FAQ 精确条目。
Q3：怎么让机器人推荐我的商品？ 在用户中心绑定电商店铺并保持激活；机器人的"电商推荐"开关开启；访客提到商品相关需求时即展示商品卡片。
Q4：客户留下的联系方式在哪里看？ 用户中心 → 联系人列表（来源显示为 Chatbot）；也可在会话详情中查看。
Q5：可以在我自己的多个网站同时部署吗？ 可以。每个域名生成一个安装 Token，可分别启用/停用，注意嵌入域名配额。
Q6：能用我自己的 OpenAI Key 吗？ 平台开启"商家自有 API"后，在机器人「对话设置」填写自己的 Key 与模型即可，优先使用您的配置。
Q7：访客长时间等待回复？ 回复由异步队列生成（AI 处理通常数秒）；若长时间无回复，请查看平台日志或联系管理员确认实时推送是否正常。
九、注意事项
嵌入脚本请部署在已白名单的域名，避免跨域限制与安全问题。
知识库文档请勿包含敏感个人信息；客户联系方式仅用于您的业务跟进。
平台级配置修改影响所有商家，请由管理员操作。
机器人暂停后访客无法发送消息，重启后会话可继续。

外贸社媒AI翻译

HiWelink 社媒 AI 翻译插件（HiwelinkTranslate）
版本：v1.0.0 品牌：HiWelink · 外贸社媒 AI 翻译
一个浏览器插件，同时统计 Facebook / Meta Business Suite、Instagram、WhatsApp Web、LinkedIn 的客户聊天，自动采集消息、实时翻译、识别高意向客户并生成统计分析。
一、功能特性
1. 多平台支持
只需安装一个插件、登录一次账号，即可同时覆盖：
平台
支持范围
Facebook / Meta
Meta Business Suite 收件箱的 Messenger 对话
Instagram
instagram.com/direct 私信聊天
WhatsApp
独立 web.whatsapp.com 聊天
LinkedIn
完整消息中心 + 页面右下角浮动聊天窗口
各平台按来源隔离去重，统计、详细数据与 CSV 导出均可按「全部 / Facebook / WhatsApp / Instagram / LinkedIn」筛选。
2. 实时翻译（四引擎）
客户的外语消息自动翻译为目标语言，并显示在原文下方；
输入中文后可生成客户目标语言草稿，确认后发送；
支持 30 种常用语言（英、西、葡、阿、东南亚语种、马来语、孟加拉语、蒙古语、印地语、乌兹别克语等）；
翻译引擎由管理员后台统一启用与配置，插件端仅可选择后台已启用的引擎：
Google 翻译
火山翻译
阿里云机器翻译
阿里千问 AI 翻译
切换引擎自动清空本地翻译缓存；
相同原文命中本地/云端译文缓存，减少重复请求；月度翻译字数受账号套餐配额限制。
3. 高意向识别
客户消息命中「想要 / 订购 / 多少钱 / 怎么买」等多语言关键词（覆盖 30+ 语言）→ 列入高意向；
客户消息中留下电话、邮箱或地址 → 直接升级高意向；
同一客户实际发送的消息超过 4 条 → 自动归类中意向；
第一条客户消息中的购买/询价/价格词不会直接触发高意向，从第二条起命中才升级（电话、邮箱、地址不受此限制）。
4. 客户统计面板（弹窗）
已识别消息、会话客户、高意向、待回复 四项核心指标；
客户问题分布（询价/采购、购买/合作、物流查询、售后问题、产品咨询、一般咨询）；
累计意向客户：高意向 · 立即跟进 / 中意向 · 持续培育 / 一般客户 · 首句分析；
按天切换查看，按平台筛选。
5. 客户分析与导出（详情页）
客户视图：客户姓名、意向、第一句话、关键/最新消息、客户消息数、发送/回复时间、已回复/待回复状态、打开原始会话；
消息明细视图：逐条客户消息、分类、意向、时间；
支持搜索、日期范围、平台、意向、联系方式（带电话/带邮箱/带电话或邮箱/同时带）筛选；
一键导出 CSV（支持按当前筛选条件或全部数据）。
6. 账号与云端服务
登录或注册（新账号免费试用一周，自动获得翻译赠送额度）；
登录状态、账号有效期、翻译配置、字符用量从云端实时读取；
账号到期 / 停用自动停止监控；
更换登录账号自动清理上一账号的本地缓存；
同一设备只能领取一次免费试用；同一公网 IP 30 天内最多领取 3 次。
7. 自动更新
定期检查 
https://www.hiwelink.com/downloads/latest.json；
发现新版本在弹窗顶部提示，可一键下载更新包，解压覆盖原插件文件夹后重新加载即可。
二、安装步骤
将下载的 ZIP 压缩包完整解压，不能直接在压缩包内安装。
打开 Chrome 或 Edge，进入「扩展程序」页面：
Chrome：
chrome://extensions
Edge：
edge://extensions
开启右上角开发者模式。
点击「加载已解压的扩展程序」。
选择解压后直接包含 manifest.json 的插件文件夹（HiwelinkTranslate）。
安装完成后，打开（或刷新）Meta Business Suite、
web.whatsapp.com、Instagram 私信、LinkedIn 消息页。
更新旧版本：把新文件覆盖到原插件文件夹，再在扩展程序页面点击「重新加载」。不要先卸载旧插件，以免浏览器清除本地登录状态和缓存。
三、首次使用
点击浏览器工具栏的插件图标打开弹窗。
在登录界面输入 HiWelink 账号 登录；没有账号可点击「注册并免费试用一周」跳转官网注册。
登录成功后弹窗显示「● 监控中」，即可打开各聊天平台开始采集。
打开插件「设置」页：
确认翻译引擎（默认 Google，仅显示后台已启用的引擎）；
选择目标语言（即您希望看到译文使用的语言，默认简体中文）；
开启「自动翻译」；
查看本月已用字符数。
四、日常使用
查看统计
点击插件图标：查看今日/历史的消息数、会话客户数、高意向数、待回复数、问题分布；
点击「查看详细数据与导出」进入详情页，可筛选、排序并导出 CSV。
实时监控开关
弹窗底部「实时监控」开关可随时暂停/恢复采集；关闭后停止采集，重新打开继续。
翻译语言栏
翻译语言栏默认跟随输入框；
拖动语言栏空白区域可切换为自由位置，并分别记住各平台的位置；
双击语言栏空白区域可恢复跟随输入框。
数据说明
聊天统计与翻译缓存保存在本机浏览器（启用扩展无限存储权限），不会自动过期，手动清除缓存或卸载插件才会删除；
账号有效期、翻译配置、字符用量等通过云端 
https://www.hiwelink.com 校验。
五、常见问题
Q1：插件提示「请打开或刷新 Meta 收件箱」？ 说明当前页面不是受支持的聊天页面。请打开 Meta Business Suite 收件箱、web.whatsapp.com、Instagram 私信或 LinkedIn 消息页。
Q2：提示「账号有效期已结束」？ 当前账号授权到期，续期请联系管理员（弹窗中显示邮箱/微信）。退出后可更换账号。
Q3：翻译不生效？
确认设置页「自动翻译」已开启；
确认翻译引擎已由管理员在后台启用；
确认账号月度字符配额未用完；
检查目标语言选择是否正确。
Q4：切换引擎后之前的译文还在吗？ 切换引擎会清空本地翻译缓存，重新翻译需要字符额度。
Q5：换电脑后数据还在吗？ 本机聊天数据不跨设备自动迁移。登录同一账号后可恢复账号配置（翻译设置、配额等），聊天数据需在原浏览器导出 CSV 备份。
六、版本记录
版本
说明
v1.0.0
多平台聊天采集、四引擎翻译（Google/火山/阿里云/千问）、高意向识别、客户统计、详情导出、自动更新

外贸AI找客

HiWelink 外贸 AI 找客插件（HiwelinkFinder）功能与使用说明
版本：v1.0.0 品牌：HiWelink · 外贸 AI 找客 / 外贸客户开发 接口服务：https://www.hiwelink.com（云端登录、同步均强制走线上地址）
一、产品简介
HiwelinkFinder 是一款面向外贸 B2B 业务员的客户线索采集插件：从 Google / Bing 搜索、Google / Bing Maps、LinkedIn、Facebook、WhatsApp Web 及任意网站，一键提取名称、电话、邮箱、网址四大核心字段（辅助提取职位、地址、公司、社媒链接），本地暂存、云端同步并智能去重，客户线索统一沉淀到 Hiwelink 云端线索库。
二、功能特性
1. 多平台自动识别
打开页面后插件自动识别当前平台并在弹窗中标注：
平台
标识
Google 搜索
google_search
Bing 搜索
bing
Google Maps
google_maps
Bing Maps
bing_maps
LinkedIn
linkedin
Facebook
facebook
WhatsApp Web
whatsapp
其他任意网站
generic_website
2. 四大核心字段采集
名称：
og:title → 页面标题 → H1 → 搜索结果显示卡 → Maps 商家名，逐级回退；
电话：
tel: 链接优先，页面文本正则扫描，Maps 商家电话；多个号码以 
; 分隔保留；
邮箱：
mailto: 优先，页面正则扫描（自动过滤 example/test 等黑名单域名、no-reply 等无效邮箱），多邮箱仅取第一个为主，其余写入备注；
网址/官网：显式"官网"链接 → 反查企业域名 → Maps 网站字段 → 页面根域名，统一去除协议前缀与尾部斜杠。
同时采集扩展字段：职位（job_title）、位置（location）、公司名（company）、社媒链接（linkedin/facebook/twitter/instagram/wa.me 等）。
3. 四种采集模式
模式
触发方式
行为
采集本页
弹窗「🚀 采集本页」/ 右键「采集本页线索」
秒级解析当前页面；搜索页则批量提取全部搜索结果线索
深度采集
弹窗「⛏️ 深度采集」/ 右键
自动发现页面中的 contact / about / team 链接，依次打开采集（最多 10 页，间隔 2 秒）
深采搜索结果
弹窗「🔎 深采搜索结果」/ 右键（仅搜索页显示）
打开搜索结果中每个网站（最多 10 站），逐一采集真实邮箱/电话
快速搜邮箱
弹窗「⚡ 快速搜邮箱」/ 右键（仅搜索页显示）
对搜索结果域名执行 
inbody:@域名 搜索引擎全文检索，不打开网站直接提取邮箱（并发 6，自动跳过搜索引擎/社交站自身域名）
4. 本地暂存与去重
采集结果先进入本地待同步队列（chrome.storage 无限存储），断网也能继续采集；
队列内按「邮箱|电话|名称」自动去重，容量上限 5000 条（超出自动淘汰最早数据）；
待同步数量以红色徽标显示在插件图标上（超过 99 显示 99+）。
5. 云端同步与智能去重
点击「☁️ 同步」或右键「立即同步」上传（每 100 条分块，自动带 
crawl_session_id 批次号）；
服务端按优先级合并：邮箱一致→合并更新（不覆盖商机金额/归属/星级等销售字段）、网址+名称相似→合并、仅电话一致→标记重复、无匹配→新增；
返回 新增/更新/跳过 统计；新线索自动发送系统通知；
每 30 分钟自动同步一次（需已登录且有待同步数据）；
每次同步写入采集历史（最近 200 条），可按批次追溯。
6. 同步队列管理页（manager.html）
点击弹窗「📋 管理队列」打开：
统计卡片：待同步线索 / 含邮箱 / 含电话 / 含网址 数量；
筛选与搜索：按名称/电话/邮箱/网址关键词搜索，按平台筛选；
批量操作：全选、删除选中、清空队列、单条删除；
立即同步与采集历史展示（时间、批次、新增/更新/跳过数）。
7. 右键菜单快捷操作
在任意网页右键即可使用：采集本页线索、深度采集本页、深采搜索结果各网站、快速搜邮箱（不打开网站）。
8. 账号体系
用户名/邮箱 + 密码登录；
未注册可跳转官网「注册并免费试用」；
登录状态云端校验，账号到期 / 停用 / 删除自动禁止采集与同步；
试用到期时弹窗提示联系管理员（邮箱 allen@hiwelink.com / 微信 18555112860）。
9. 清空本地数据
「🗑️ 清空本地数据」清除待同步队列与同步历史，保留登录状态，云端数据不受影响。
三、安装步骤
将下载的 ZIP 压缩包完整解压（不能直接在压缩包内安装）。
打开 Chrome 或 Edge 扩展程序页：
Chrome：
chrome://extensions
Edge：
edge://extensions
开启右上角开发者模式。
点击「加载已解压的扩展程序」，选择解压后直接包含 manifest.json 的 HiwelinkFinder 文件夹。
点击浏览器工具栏插件图标，登录 Hiwelink 账号即可开始使用。
更新旧版本：将新版文件覆盖到原插件文件夹，再到扩展程序页点击「重新加载」。不要先卸载旧插件，以免清除本地登录状态与待同步队列。
四、使用说明
1. 登录
点击插件图标 → 输入用户名/邮箱与密码 → 登录；
无账号点击「注册并免费试用」跳转 www.hiwelink.com/register 注册。
2. 采集当前页
打开目标网站（或 Google/Bing 搜索结果页、Maps 商家列表等）；
点击插件图标 → 「🚀 采集本页」；
查看统计（名称/电话/邮箱/网址数量），结果自动进入待同步队列。
3. 深度采集
在客户官网等页面点击「⛏️ 深度采集」，插件自动发现并打开 contact / about / team 等子页面逐页采集，聚合更完整的联系方式。
4. 深采搜索结果（搜索页专用）
在 Google/Bing 搜索结果页点击「🔎 深采搜索结果各网站」，后台依次打开结果网站采集真实邮箱/电话，适合把搜索结果批量转成线索。
5. 快速搜邮箱（搜索页专用）
点击「⚡ 快速搜邮箱」，对搜索结果域名执行搜索引擎全文检索，直接提取该域名下公开邮箱，不打开任何网站，秒级完成。
6. 同步到云端
点击「☁️ 同步」手动立即同步；
或等待每 30 分钟自动同步；
同步完成后查看新增/更新/跳过数量，新线索通知；
登录 www.hiwelink.com → 用户中心 → 联系人/线索 即可查看云端沉淀的客户数据。
7. 管理待同步队列
点击「📋 管理队列」：
查看待同步线索（含名称/联系方式/平台标签）；
按关键词或平台筛选，勾选删除不需要的数据；
点击「☁️ 立即同步」批量上传。
五、采集节奏与合规提示
安全延迟：深度采集、搜索深采默认每个网站间隔 2 秒，快速搜邮箱带并发节流，避免触发平台风控；
请在合理频率下使用，特别是 LinkedIn / Facebook 等平台，短时间大量请求可能导致账号受限；
采集数据仅用于您自身的客户管理工作，支持随时在云端导出或删除。
六、常见问题（FAQ）
Q1：为什么插件图标上一直有红色数字？ 红色数字 = 待同步队列条数。点击插件 → 「☁️ 同步」上传到云端后即消失；也可在「管理队列」中清理。
Q2：采集不到邮箱？ 网站本身未公开邮箱时无法提取；可尝试「深度采集」或「快速搜邮箱」补充；部分网站做了邮箱混淆/图片化，需要到页面内查看。
Q3：提示"账号已失效 / 请重新登录"？ 登录状态已过期或账号被停用/到期。重新登录；试用到期请联系管理员 allen@hiwelink.com。
Q4：同步时提示失败？ 确认网络正常且接口地址为 https://www.hiwelink.com；失败数据会保留在本地队列，恢复后可重新同步。
Q5：同步后云端没看到数据？ 登录 www.hiwelink.com → 用户中心 → 联系人/线索 查看；注意区分"本插件同步"与"社媒聊天采集"两个入口，线索归属当前登录账号。
Q6：换电脑/重装插件后数据会丢吗？ 请先同步到云端再重装。重装后登录同一账号，云端线索仍在；本地未同步队列无法自动恢复。
七、技术说明（可选）
云端地址强制为 
https://www.hiwelink.com（存储中出现其他地址一律回退，防本地环境串线）；
同步接口：
POST /api/v2/leads/sync（每批 100 条，Bearer Token 鉴权）；
本地存储键：
hiwelink_finder_cloud（登录态）、
hiwelink_finder_pending（待同步队列）、
hiwelink_finder_history（同步历史）；
WhatsApp 采集通过注入 
wa-bridge.js（WPP 库）读取会话联系人，仅在你打开 web.whatsapp.com 时生效。

外贸CRM线索AI管理

HiWelinkCRM 线索、客户公司与员工多账号管理说明
更新日期：2026-08-26 适用对象：HiWelink 商家用户（主账号）与雇员子账号 功能入口：登录 www.hiwelink.com → 用户中心 → 全部线索 / 全部客户 / Team（团队管理）
一、总体说明
HiWelink 云端客户库围绕 线索（联系人） 与 客户公司 两大对象组织，支持主账号 + 雇员子账号的团队协作模式：
线索（Contact）：一条客户记录，含联系方式、线索阶段、意向评分、星级、标签、自定义字段与跟进记录；
客户公司（Company）：一家客户企业，可关联多条线索，含行业、国家、地址、官网等企业信息；
团队（Team）：主账号可创建多个雇员子账号，每个雇员用独立账号登录官网用户中心或 Hiwelink Cloud 插件，数据按分配归属隔离。
二、线索管理
2.1 列表与统计
入口：用户中心 → 全部线索
统计卡片：线索总数、活跃线索、阻断（blocked）线索、已收藏线索数量；
搜索：按名称 / 电话 / 邮箱 / 网址关键词模糊搜索；
筛选：
线索状态（active 活跃 / blocked 阻断）；
线索阶段（lead_status，如 new / qualified 等）；
来源（source，如 Hiwelink Finder 插件同步 / AI 客服捕获 / 手动录入等）；
标签（tag）；
只看已收藏。
列表操作：单条查看、编辑、收藏、切换状态、删除。
2.2 新建 / 编辑线索
可填写字段：
分类
字段
基本信息
姓名、邮箱、电话、网址（官网）、职位、位置、公司
商机信息
线索阶段（lead_status）、意向星级、智能评分（lead_score 0-100）、商机金额等销售字段
归属信息
分配人（assigned_to）、所属客户公司
附加信息
标签、自定义字段、备注
邮箱 / 电话 / 网址在新建时会按租户内做重复拦截与提示，避免重复入库。
2.3 线索详情
完整资料 + 标签 + 自定义字段 + 所属公司；
跟进记录：查看历史跟进（方式、内容、时间），并新增跟进；
分配人信息与操作记录；
由社交插件采集的线索会标注平台来源（Facebook / Instagram / WhatsApp / LinkedIn）。
2.4 批量操作
列表勾选多条线索后支持：
批量删除；
批量分配：批量指定分配人（主账号操作）；
批量切换状态 / 星级；
批量打标签、批量填写自定义字段。
2.5 导入 / 导出
CSV 导入：先下载模板，按模板填好后上传；
去重规则：邮箱一致 → 判重跳过；无邮箱时按 姓名 + 电话 一致判重；
导入时自动关联/创建对应的客户公司。
CSV 导出：按当前搜索/筛选结果导出为 CSV，用于本地归档或二次分析。
2.6 员工可见范围
雇员子账号进入「全部线索」时，只能看到：
自己创建的线索；
分配给本人的线索；
未分配（暂无归属人）的线索。
主账号可看到该租户全部线索。
三、客户公司管理
3.1 列表与统计
入口：用户中心 → 全部客户
统计卡片：公司总数、已分配公司数；
搜索：按名称关键词搜索；
筛选：按行业（industry）、国家（country）、分配人（assigned_to）筛选；
列表展示各公司的关联线索数量（withCount）。
3.2 新建 / 编辑公司
基础资料：公司名称、行业、国家、地址、电话、邮箱、官网；
归属信息：分配人（assigned_to）；
同一租户内公司名称不允许重复（创建时自动拦截）。
3.3 公司详情
公司资料 + 分配人；
关联线索列表：该公司名下所有线索，可点击进入；
跟进记录：查看 / 新增跟进。
3.4 员工可见范围
与线索一致：雇员只能看到自建 + 分配本人 + 未分配的公司；主账号可见全部。
四、员工多账号（团队）管理
4.1 适用角色
仅主账号可进入「Team」进行团队成员管理；雇员子账号无权管理团队（访问返回 403）。
4.2 添加员工
主账号在 Team 页填写：
姓（first_name）（必填）、名（last_name）（选填）；
用户名（username）（唯一，可点击"自动生成"）；
邮箱（email）（唯一）；
密码（password）（至少 8 位）。
创建成功后，员工即可用该账号登录 官网用户中心 或 Hiwelink Cloud 社媒插件 / 找客插件。
4.3 人数上限（套餐配额）
团队人数受主账号套餐 
team_member_limit 控制：
基础套餐：5 人
成长套餐：10 人
专业套餐：20 人（或不限）
达到上限后创建提示："团队成员人数已达上限，请升级套餐后再添加"；
删除员工可释放名额。
4.4 员工登录后的可见模块
雇员子账号的用户中心只保留：
Dashboard（个人数据概览）
全部线索（自建 + 分配本人 + 未分配）
全部客户（同上范围）
AI 智能体（可绑定自己的智能体）
其余模块（聊天机器人、会话、知识库、店铺、分类、订阅、工单、团队管理等）对员工隐藏。
4.5 员工数据的隔离与安全
租户隔离：所有数据按主账号租户（client_id）隔离，不同主账号之间互不可见；
员工归属：员工创建/采集的线索自动归属该员工（assigned_to_id = 员工本人）；
分配机制：
主账号可将线索 / 公司批量分配（或取消分配）给任意员工；
员工只能看到并操作 自己 + 未分配 的数据，无法看到其他同事名下数据；
员工不可执行"分配"操作（仅主账号可分配）。
删除员工：删除后该员工账号无法登录，其名下数据的归属关系保留在租户内，可由主账号重新分配。
4.6 员工与 AI 智能体
雇员子账号同样可以绑定 AI 智能体（MCP）；
绑定后智能体只能查询/操作该员工可见范围（自建 + 分配本人 + 未分配）的线索、公司与跟进记录；
线索 / 公司的分配操作仍仅限主账号的智能体执行。
4.7 员工与 Hiwelink Cloud 插件
员工使用自己的子账号登录社媒翻译 / 找客插件后，采集与同步的数据会归属到该员工名下（云端同一租户）；
主账号可在用户中心按员工维度查看线索归属情况。
五、推荐协作流程
主账号在 Team 创建员工账号；
在「全部线索 / 全部客户」中按区域或客户类型批量分配给对应员工；
员工用子账号登录插件 / 用户中心，跟进属于自己的客户；
员工新增的线索自动归属本人，AI 客服 / 找客插件捕获的线索按登录账号归属；
主账号随时查看全量数据，统筹分配与清洗。
六、常见问题（FAQ）
Q1：员工能看到其他人的客户吗？ 不能。员工仅可见自建 + 分配本人 + 未分配的数据；已分配给其他同事的数据不可见。
Q2：未分配的线索谁都可以看到，会不会乱？ 未分配（无归属人）数据对主账号和所有员工可见，建议主账号及时分配归属，避免重复跟进。
Q3：员工离职怎么处理？ 在 Team 页删除该员工账号；其名下线索仍在租户内，主账号可将线索重新分配给其他员工。
Q4：添加员工提示人数已达上限？ 当前套餐的团队人数已用完，需升级套餐或删除不用的员工账号。
Q5：员工能登录哪些入口？ 官网用户中心（仅限分配的模块）以及 Hiwelink Cloud 翻译 / 找客插件。
Q6：员工能绑定 AI 智能体吗？ 可以。员工绑定后智能体只能操作其可见范围内的数据，分配类操作仅主账号可执行。
七、注意事项
团队管理、线索/公司分配、订阅管理为主账号专属操作；
数据严格按租户隔离，主账号与员工在同一个客户库内协作，请妥善管理员工账号与分配关系；
线索/公司的删除为不可恢复操作（软删除后不对外展示），删除前请确认。

外贸AI智能体

HiWelink AI 智能体（MCP）使用帮助说明
更新日期：2026-08-26 适用对象：外贸线索 AI 管理用户（主账号 / 雇员子账号均可绑定） 功能入口：登录 www.hiwelink.com → 用户中心 → AI 智能体绑定
一、这是什么
HiWelink AI 智能体通过标准 MCP（Model Context Protocol） 协议，把你自己常用的 AI 工具（Codex、Claude、Cursor、WorkBuddy 等）接入你的外贸线索库。
绑定账号后，你可以用自然语言让 AI 智能体直接操作业务数据，例如：
「帮我统计一下线索经营情况」
「查询状态为 qualified 的线索」
「新建一条客户线索，邮箱是 xxx」
「给这条线索做个意向评分」
「把最近 5 条跟进记录做个总结」
AI 以你的账号身份操作数据，全程受租户隔离保护：子账号只能看到自己可见的数据，主账号可操作全量数据。
二、支持的工具与接入端点
项目
说明
协议
MCP（Streamable HTTP + SSE）
接入地址
https://www.hiwelink.com/api/mcp/sse
消息端点
https://www.hiwelink.com/api/mcp/message
服务器信息
https://www.hiwelink.com/api/mcp
服务器名称
hiwelink-mcp（v1.0.0）
支持的 AI 客户端：OpenAI Codex、Claude（Desktop）、Cursor、腾讯 WorkBuddy 及其他支持自定义 MCP 的工具。
三、使用前提
已注册并登录 www.hiwelink.com，主账号或雇员子账号均可绑定（子账号绑定后仅可操作自建 + 分配给本人的数据）。
已在客户库（联系人/公司）中录入数据，或希望通过 AI 录入新数据。
已安装/可运行上述任意一种 AI 客户端。
四、使用流程（三步）
第 1 步：让智能体发起操作
在 AI 智能体对话中，直接说你的需求，例如：
「查询我的高意向线索」
智能体首次尝试操作你的数据时，会返回一个 6 位绑定码（如 
PZJI67）。
第 2 步：输入绑定码
打开 www.hiwelink.com 用户中心 → AI 智能体绑定。
在「绑定智能体」输入框中输入智能体返回的 6 位绑定码。
点击 确认绑定，提示「绑定成功」即完成。
第 3 步：回到智能体继续
回到 AI 智能体对话，让 TA 重新执行刚才的请求，即可正常查询/操作你的线索数据。
提示：绑定码有效期 15 分钟，过期请在智能体侧重新发起一次操作以获取新码。 绑定成功后，同一智能体无需重复绑定。
五、各 AI 客户端接入配置
1. OpenAI Codex CLI / SDK
codex mcp add hiwelink --sse https://www.hiwelink.com/api/mcp/sse
2. 腾讯 WorkBuddy
方式一：WorkBuddy 设置 → MCP → 添加自定义 MCP，粘贴配置
方式二：编辑 
~/.workbuddy/mcp.json（Windows：
C:\Users\用户名\.workbuddy\mcp.json）
{
  "mcpServers": {
    "hiwelink": {
      "url": "https://www.hiwelink.com/api/mcp/sse"
    }
  }
}
3. Claude Desktop / Cursor
编辑 
claude_desktop_config.json 或 Cursor 的 MCP 配置：
{
  "mcpServers": {
    "hiwelink": {
      "url": "https://www.hiwelink.com/api/mcp/sse"
    }
  }
}
六、AI 技能清单（共 19 项）
绑定后，智能体可调用以下技能操作你的数据：
线索（联系人）
技能
作用
leads_list
查询线索列表：按关键词、阶段、星级、分配人、来源、分页筛选
leads_stats
线索经营统计：总数、各阶段数量、星级、活跃/阻断、来源分布
leads_create
新建线索（邮箱/电话/网址任一重复自动拦截）
leads_update
更新线索：资料、阶段、星级、评分、备注、标签、归属
leads_score
智能分级评分（0-100）：采购频次/互动/需求明确度/企业实力/意向 5 维加权，自动给出高/中/低意向与跟进建议
leads_dedupe_check
查重：检查邮箱/电话/网址是否已存在
leads_assign
线索批量分配/取消分配（仅主账号）
客户公司
技能
作用
companies_list
查询客户公司列表（关键词/行业/国家/归属人筛选）
companies_create
新建客户公司（同名自动拦截）
companies_update
更新公司资料与归属
companies_assign
公司批量分配/取消分配（仅主账号）
团队
技能
作用
team_members
查询本账号团队成员，用于线索/公司分配
跟进记录
技能
作用
follow_ups_list
查询跟进记录（按线索/公司、方式、关键词、日期筛选）
follow_ups_create
新增跟进记录
follow_ups_update
更新跟进记录（乐观锁防冲突）
follow_ups_delete
删除跟进记录（软删除）
follow_ups_summary_save
同步 AI 总结（整体摘要/关键点/待办/建议）到跟进记录
follow_ups_summary_get
查询已同步的跟进总结
其他
技能
作用
binding_status
查询当前绑定账号、账号类型、可操作数据范围、可用技能
七、数据安全与权限
租户隔离：数据按账号（client_id）隔离，互不可见。
角色权限：
主账号：可操作全量数据，可分配线索/公司。
子账号（员工）：只能看到自建 + 分配给本人的数据，不可执行分配操作。
绑定规则：
一个智能体只能绑定一个账号；
一个账号可绑定多个智能体；
主账号与雇员子账号均可绑定；子账号可操作范围为自建 + 分配给本人的数据。
解绑：在「AI 智能体绑定」页的已绑定列表中点击「解绑」，即时撤销授权。
八、常见问题（FAQ）
Q1：绑定码过期/无效怎么办？ 绑定码有效期 15 分钟。回到 AI 智能体重新发起一次操作，让 TA 重新返回一个新绑定码，再到绑定页输入。
Q2：提示「该绑定码已被其他账号绑定」？ 同一智能体只能绑定一个账号。如需更换账号，先在原账号解绑，再让智能体重新发起操作获取新绑定码。
Q3：子账号绑定后能操作哪些数据？ 子账号（员工）绑定后，智能体只能查询和操作自建 + 分配给本人的线索/公司/跟进记录，与登录用户中心看到的数据范围一致；线索/公司的分配操作仍仅限主账号。
Q4：智能体说「操作失败 / 无权访问」？ 确认操作对象是否在当前账号数据范围内；子账号只能操作可见数据。
Q5：绑定后如何查看当前绑定状态？ 对智能体说「查询我的绑定状态」，TA 会调用 
binding_status 返回绑定账号、类型与数据范围。
九、注意事项
数据操作请谨慎授权，解绑或离职员工账号后请及时在绑定页撤销对应智能体。
AI 智能体的输出基于你的真实数据，操作前建议核对关键字段（如邮箱、电话）。
若 AI 智能体返回技术报错，请核对 MCP 配置地址是否为 
https://www.hiwelink.com/api/mcp/sse。