# 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 接入、人工介入转接。

---

## 二、功能总览

<table id="bkmrk-%E8%A7%92%E8%89%B2-%E5%8A%9F%E8%83%BD-%E8%AE%BF%E5%AE%A2%E7%AB%AF-%E5%AF%B9%E8%AF%9D%E7%AA%97%E5%8F%A3%E3%80%81%E6%AC%A2%E8%BF%8E%E8%AF%AD%E3%80%81f" style="width: 95.5952%; height: 135.984px;"><thead><tr style="height: 29.7969px;"><th style="width: 19.5517%; height: 29.7969px;">角色</th><th style="width: 80.3685%; height: 29.7969px;">功能</th></tr></thead><tbody><tr style="height: 29.7969px;"><td style="width: 19.5517%; height: 29.7969px;">访客端</td><td style="width: 80.3685%; height: 29.7969px;">对话窗口、欢迎语、FAQ 快捷命中、商品卡片、订单查询、联系人表单、聊天历史、多语言回复</td></tr><tr style="height: 46.5938px;"><td style="width: 19.5517%; height: 46.5938px;">商家端（用户中心）</td><td style="width: 80.3685%; height: 46.5938px;">多机器人、外观/行为/对话配置、FAQ 管理、知识库管理、电商绑定、域名嵌入、会话列表、人工接管</td></tr><tr style="height: 29.7969px;"><td style="width: 19.5517%; height: 29.7969px;">平台端（管理员后台）</td><td style="width: 80.3685%; height: 29.7969px;">OpenAI/Embedding 配置、限流与会话策略、实时推送、视频转写、Sitemap、OCR、人工介入开关</td></tr></tbody></table>

---

## 三、访客端使用说明（最终用户视角）

访客在您的网站上看到右下角的机器人气泡，点击即可开始对话：

1. **开始对话**：打开聊天窗口，AI 客服发送欢迎语；FAQ 或常见问题可一键点击提问。
2. **自由提问**：直接输入问题（支持中/英/西/阿等，回复自动使用访客的语言）。
3. **查看商品**：询问商品相关问题时，窗口内直接展示商品卡片（图片/价格/链接），可继续对比多个商品。
4. **查询订单**：绑定电商店铺后，说出订单号或邮箱即可查询订单状态。
5. **留联系方式**：AI 会在合适时机弹出联系人表单（姓名/邮箱等），提交后商家侧自动生成客户线索。
6. **聊天记录**：刷新页面后仍可加载本次会话历史继续对话。

> 访客数据（位置/设备/访问页面/浏览商品）会用于商家侧分析，但仅归属该商家租户，不跨商户共享。

---

## 四、商家端配置指南（用户中心）

入口：登录 → 用户中心 → **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：嵌入脚本（推荐）**

1. 在「安装」页签为你的域名生成**安装代码（Token）**，可添加多个域名并分别启用/停用；
2. 复制 `<script>` 嵌入代码，粘贴到网站 `</body>` 前即可。
3. 每个安装域消耗 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 处理通常数秒）；若长时间无回复，请查看平台日志或联系管理员确认实时推送是否正常。

---

## 九、注意事项

- 嵌入脚本请部署在已白名单的域名，避免跨域限制与安全问题。
- 知识库文档请勿包含敏感个人信息；客户联系方式仅用于您的业务跟进。
- 平台级配置修改影响所有商家，请由管理员操作。
- 机器人暂停后访客无法发送消息，重启后会话可继续。

</body>

# 外贸社媒AI翻译

# HiWelink 社媒 AI 翻译插件（HiwelinkTranslate）

#   


> 版本：v1.0.0 品牌：HiWelink · 外贸社媒 AI 翻译

一个浏览器插件，同时统计 **Facebook / Meta Business Suite、Instagram、WhatsApp Web、LinkedIn** 的客户聊天，自动采集消息、实时翻译、识别高意向客户并生成统计分析。

---

## 一、功能特性

### 1. 多平台支持

只需安装一个插件、登录一次账号，即可同时覆盖：

<table id="bkmrk-%E5%B9%B3%E5%8F%B0-%E6%94%AF%E6%8C%81%E8%8C%83%E5%9B%B4-facebook-%2F-m"><thead><tr><th>平台</th><th>支持范围</th></tr></thead><tbody><tr><td>Facebook / Meta</td><td>Meta Business Suite 收件箱的 Messenger 对话</td></tr><tr><td>Instagram</td><td>instagram.com/direct 私信聊天</td></tr><tr><td>WhatsApp</td><td>独立 web.whatsapp.com 聊天</td></tr><tr><td>LinkedIn</td><td>完整消息中心 + 页面右下角浮动聊天窗口</td></tr></tbody></table>

各平台按来源隔离去重，统计、详细数据与 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`；
- 发现新版本在弹窗顶部提示，可**一键下载更新包**，解压覆盖原插件文件夹后重新加载即可。

---

## 二、安装步骤

1. 将下载的 ZIP 压缩包**完整解压**，不能直接在压缩包内安装。
2. 打开 Chrome 或 Edge，进入「扩展程序」页面： 
    - Chrome：`chrome://extensions`
    - Edge：`edge://extensions`
3. 开启右上角**开发者模式**。
4. 点击「**加载已解压的扩展程序**」。
5. 选择解压后**直接包含 manifest.json** 的插件文件夹（HiwelinkTranslate）。
6. 安装完成后，打开（或刷新）Meta Business Suite、`web.whatsapp.com`、Instagram 私信、LinkedIn 消息页。

> 更新旧版本：把新文件覆盖到原插件文件夹，再在扩展程序页面点击「重新加载」。**不要先卸载旧插件**，以免浏览器清除本地登录状态和缓存。

---

## 三、首次使用

1. 点击浏览器工具栏的插件图标打开弹窗。
2. 在登录界面输入 **HiWelink 账号** 登录；没有账号可点击「注册并免费试用一周」跳转官网注册。
3. 登录成功后弹窗显示「● 监控中」，即可打开各聊天平台开始采集。
4. 打开插件「**设置**」页： 
    - 确认**翻译引擎**（默认 Google，仅显示后台已启用的引擎）；
    - 选择**目标语言**（即您希望看到译文使用的语言，默认简体中文）；
    - 开启「自动翻译」；
    - 查看本月已用字符数。

---

## 四、日常使用

### 查看统计

- 点击插件图标：查看今日/历史的消息数、会话客户数、高意向数、待回复数、问题分布；
- 点击「查看详细数据与导出」进入详情页，可筛选、排序并导出 CSV。

### 实时监控开关

- 弹窗底部「实时监控」开关可随时暂停/恢复采集；关闭后停止采集，重新打开继续。

### 翻译语言栏

- 翻译语言栏默认跟随输入框；
- 拖动语言栏空白区域可切换为自由位置，并分别记住各平台的位置；
- 双击语言栏空白区域可恢复跟随输入框。

### 数据说明

- 聊天统计与翻译缓存保存在**本机浏览器**（启用扩展无限存储权限），不会自动过期，手动清除缓存或卸载插件才会删除；
- 账号有效期、翻译配置、字符用量等通过云端 `https://www.hiwelink.com` 校验。

---

## 五、常见问题

**Q1：插件提示「请打开或刷新 Meta 收件箱」？** 说明当前页面不是受支持的聊天页面。请打开 Meta Business Suite 收件箱、web.whatsapp.com、Instagram 私信或 LinkedIn 消息页。

**Q2：提示「账号有效期已结束」？** 当前账号授权到期，续期请联系管理员（弹窗中显示邮箱/微信）。退出后可更换账号。

**Q3：翻译不生效？**

- 确认设置页「自动翻译」已开启；
- 确认翻译引擎已由管理员在后台启用；
- 确认账号月度字符配额未用完；
- 检查目标语言选择是否正确。

**Q4：切换引擎后之前的译文还在吗？** 切换引擎会清空本地翻译缓存，重新翻译需要字符额度。

**Q5：换电脑后数据还在吗？** 本机聊天数据不跨设备自动迁移。登录同一账号后可恢复账号配置（翻译设置、配额等），聊天数据需在原浏览器导出 CSV 备份。

---

## 六、版本记录

<table id="bkmrk-%E7%89%88%E6%9C%AC-%E8%AF%B4%E6%98%8E-v1.0.0-%E5%A4%9A%E5%B9%B3%E5%8F%B0%E8%81%8A%E5%A4%A9%E9%87%87%E9%9B%86"><thead><tr><th>版本</th><th>说明</th></tr></thead><tbody><tr><td>v1.0.0</td><td>多平台聊天采集、四引擎翻译（Google/火山/阿里云/千问）、高意向识别、客户统计、详情导出、自动更新</td></tr></tbody></table>

# 外贸AI找客

# HiWelink 外贸 AI 找客插件（HiwelinkFinder）功能与使用说明

> 版本：v1.0.0 品牌：HiWelink · 外贸 AI 找客 / 外贸客户开发 接口服务：[https://www.hiwelink.com（云端登录、同步均强制走线上地址）](https://www.hiwelink.com%EF%BC%88%E4%BA%91%E7%AB%AF%E7%99%BB%E5%BD%95%E3%80%81%E5%90%8C%E6%AD%A5%E5%9D%87%E5%BC%BA%E5%88%B6%E8%B5%B0%E7%BA%BF%E4%B8%8A%E5%9C%B0%E5%9D%80%EF%BC%89)

---

## 一、产品简介

HiwelinkFinder 是一款面向外贸 B2B 业务员的**客户线索采集插件**：从 Google / Bing 搜索、Google / Bing Maps、LinkedIn、Facebook、WhatsApp Web 及任意网站，一键提取**名称、电话、邮箱、网址**四大核心字段（辅助提取职位、地址、公司、社媒链接），本地暂存、云端同步并智能去重，客户线索统一沉淀到 Hiwelink 云端线索库。

---

## 二、功能特性

### 1. 多平台自动识别

打开页面后插件自动识别当前平台并在弹窗中标注：

<table id="bkmrk-%E5%B9%B3%E5%8F%B0-%E6%A0%87%E8%AF%86-google-%E6%90%9C%E7%B4%A2-goog"><thead><tr><th>平台</th><th>标识</th></tr></thead><tbody><tr><td>Google 搜索</td><td>google\_search</td></tr><tr><td>Bing 搜索</td><td>bing</td></tr><tr><td>Google Maps</td><td>google\_maps</td></tr><tr><td>Bing Maps</td><td>bing\_maps</td></tr><tr><td>LinkedIn</td><td>linkedin</td></tr><tr><td>Facebook</td><td>facebook</td></tr><tr><td>WhatsApp Web</td><td>whatsapp</td></tr><tr><td>其他任意网站</td><td>generic\_website</td></tr></tbody></table>

### 2. 四大核心字段采集

- **名称**：`og:title` → 页面标题 → H1 → 搜索结果显示卡 → Maps 商家名，逐级回退；
- **电话**：`tel:` 链接优先，页面文本正则扫描，Maps 商家电话；多个号码以 `;` 分隔保留；
- **邮箱**：`mailto:` 优先，页面正则扫描（自动过滤 example/test 等黑名单域名、no-reply 等无效邮箱），多邮箱仅取第一个为主，其余写入备注；
- **网址/官网**：显式"官网"链接 → 反查企业域名 → Maps 网站字段 → 页面根域名，统一去除协议前缀与尾部斜杠。

同时采集扩展字段：**职位（job\_title）、位置（location）、公司名（company）、社媒链接（linkedin/facebook/twitter/instagram/wa.me 等）**。

### 3. 四种采集模式

<table id="bkmrk-%E6%A8%A1%E5%BC%8F-%E8%A7%A6%E5%8F%91%E6%96%B9%E5%BC%8F-%E8%A1%8C%E4%B8%BA-%E9%87%87%E9%9B%86%E6%9C%AC%E9%A1%B5-%E5%BC%B9%E7%AA%97%E3%80%8C%F0%9F%9A%80"><thead><tr><th>模式</th><th>触发方式</th><th>行为</th></tr></thead><tbody><tr><td>**采集本页**</td><td>弹窗「🚀 采集本页」/ 右键「采集本页线索」</td><td>秒级解析当前页面；搜索页则批量提取全部搜索结果线索</td></tr><tr><td>**深度采集**</td><td>弹窗「⛏️ 深度采集」/ 右键</td><td>自动发现页面中的 contact / about / team 链接，依次打开采集（最多 10 页，间隔 2 秒）</td></tr><tr><td>**深采搜索结果**</td><td>弹窗「🔎 深采搜索结果」/ 右键（仅搜索页显示）</td><td>打开搜索结果中每个网站（最多 10 站），逐一采集真实邮箱/电话</td></tr><tr><td>**快速搜邮箱**</td><td>弹窗「⚡ 快速搜邮箱」/ 右键（仅搜索页显示）</td><td>对搜索结果域名执行 `inbody:@域名` 搜索引擎全文检索，**不打开网站**直接提取邮箱（并发 6，自动跳过搜索引擎/社交站自身域名）</td></tr></tbody></table>

### 4. 本地暂存与去重

- 采集结果先进入**本地待同步队列**（chrome.storage 无限存储），断网也能继续采集；
- 队列内按「邮箱|电话|名称」自动去重，容量上限 5000 条（超出自动淘汰最早数据）；
- 待同步数量以**红色徽标**显示在插件图标上（超过 99 显示 99+）。

### 5. 云端同步与智能去重

- 点击「☁️ 同步」或右键「立即同步」上传（每 100 条分块，自动带 `crawl_session_id` 批次号）；
- 服务端按优先级合并：**邮箱一致→合并更新**（不覆盖商机金额/归属/星级等销售字段）、**网址+名称相似→合并**、**仅电话一致→标记重复**、**无匹配→新增**；
- 返回 新增/更新/跳过 统计；新线索自动发送系统通知；
- 每 **30 分钟自动同步**一次（需已登录且有待同步数据）；
- 每次同步写入采集历史（最近 200 条），可按批次追溯。

### 6. 同步队列管理页（manager.html）

点击弹窗「📋 管理队列」打开：

- **统计卡片**：待同步线索 / 含邮箱 / 含电话 / 含网址 数量；
- **筛选与搜索**：按名称/电话/邮箱/网址关键词搜索，按平台筛选；
- **批量操作**：全选、删除选中、清空队列、单条删除；
- **立即同步**与**采集历史**展示（时间、批次、新增/更新/跳过数）。

### 7. 右键菜单快捷操作

在任意网页右键即可使用：采集本页线索、深度采集本页、深采搜索结果各网站、快速搜邮箱（不打开网站）。

### 8. 账号体系

- 用户名/邮箱 + 密码登录；
- 未注册可跳转官网「注册并免费试用」；
- 登录状态云端校验，账号**到期 / 停用 / 删除**自动禁止采集与同步；
- 试用到期时弹窗提示联系管理员（邮箱 allen@hiwelink.com / 微信 18555112860）。

### 9. 清空本地数据

「🗑️ 清空本地数据」清除待同步队列与同步历史，**保留登录状态**，云端数据不受影响。

---

## 三、安装步骤

1. 将下载的 ZIP 压缩包**完整解压**（不能直接在压缩包内安装）。
2. 打开 Chrome 或 Edge 扩展程序页： 
    - Chrome：`chrome://extensions`
    - Edge：`edge://extensions`
3. 开启右上角**开发者模式**。
4. 点击「**加载已解压的扩展程序**」，选择解压后直接包含 manifest.json 的 **HiwelinkFinder** 文件夹。
5. 点击浏览器工具栏插件图标，登录 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；失败数据会保留在本地队列，恢复后可重新同步。](https://www.hiwelink.com%EF%BC%9B%E5%A4%B1%E8%B4%A5%E6%95%B0%E6%8D%AE%E4%BC%9A%E4%BF%9D%E7%95%99%E5%9C%A8%E6%9C%AC%E5%9C%B0%E9%98%9F%E5%88%97%EF%BC%8C%E6%81%A2%E5%A4%8D%E5%90%8E%E5%8F%AF%E9%87%8D%E6%96%B0%E5%90%8C%E6%AD%A5%E3%80%82)

**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 新建 / 编辑线索

可填写字段：

<table id="bkmrk-%E5%88%86%E7%B1%BB-%E5%AD%97%E6%AE%B5-%E5%9F%BA%E6%9C%AC%E4%BF%A1%E6%81%AF-%E5%A7%93%E5%90%8D%E3%80%81%E9%82%AE%E7%AE%B1%E3%80%81%E7%94%B5%E8%AF%9D%E3%80%81"><thead><tr><th>分类</th><th>字段</th></tr></thead><tbody><tr><td>基本信息</td><td>姓名、邮箱、电话、网址（官网）、职位、位置、公司</td></tr><tr><td>商机信息</td><td>线索阶段（lead\_status）、意向星级、智能评分（lead\_score 0-100）、商机金额等销售字段</td></tr><tr><td>归属信息</td><td>**分配人（assigned\_to）**、所属客户公司</td></tr><tr><td>附加信息</td><td>标签、自定义字段、备注</td></tr></tbody></table>

> 邮箱 / 电话 / 网址在新建时会按租户内做**重复拦截与提示**，避免重复入库。

### 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 插件

- 员工使用自己的子账号登录社媒翻译 / 找客插件后，采集与同步的数据会归属到**该员工名下**（云端同一租户）；
- 主账号可在用户中心按员工维度查看线索归属情况。

---

## 五、推荐协作流程

1. 主账号在 Team 创建员工账号；
2. 在「全部线索 / 全部客户」中按区域或客户类型**批量分配给**对应员工；
3. 员工用子账号登录插件 / 用户中心，跟进属于自己的客户；
4. 员工新增的线索自动归属本人，AI 客服 / 找客插件捕获的线索按登录账号归属；
5. 主账号随时查看全量数据，统筹分配与清洗。

---

## 六、常见问题（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 以**你的账号身份**操作数据，全程受租户隔离保护：子账号只能看到自己可见的数据，主账号可操作全量数据。

---

## 二、支持的工具与接入端点

<table id="bkmrk-%E9%A1%B9%E7%9B%AE-%E8%AF%B4%E6%98%8E-%E5%8D%8F%E8%AE%AE-mcp%EF%BC%88streama"><thead><tr><th>项目</th><th>说明</th></tr></thead><tbody><tr><td>协议</td><td>MCP（Streamable HTTP + SSE）</td></tr><tr><td>接入地址</td><td>`https://www.hiwelink.com/api/mcp/sse`</td></tr><tr><td>消息端点</td><td>`https://www.hiwelink.com/api/mcp/message`</td></tr><tr><td>服务器信息</td><td>`https://www.hiwelink.com/api/mcp`</td></tr><tr><td>服务器名称</td><td>`hiwelink-mcp`（v1.0.0）</td></tr></tbody></table>

支持的 AI 客户端：**OpenAI Codex**、**Claude（Desktop）**、**Cursor**、**腾讯 WorkBuddy** 及其他支持自定义 MCP 的工具。

---

## 三、使用前提

1. 已注册并登录 www.hiwelink.com，**主账号或雇员子账号均可绑定**（子账号绑定后仅可操作自建 + 分配给本人的数据）。
2. 已在客户库（联系人/公司）中录入数据，或希望通过 AI 录入新数据。
3. 已安装/可运行上述任意一种 AI 客户端。

---

## 四、使用流程（三步）

### 第 1 步：让智能体发起操作

在 AI 智能体对话中，直接说你的需求，例如：

> 「查询我的高意向线索」

智能体首次尝试操作你的数据时，会返回一个 **6 位绑定码**（如 `PZJI67`）。

### 第 2 步：输入绑定码

1. 打开 www.hiwelink.com 用户中心 → **AI 智能体绑定**。
2. 在「绑定智能体」输入框中输入智能体返回的 **6 位绑定码**。
3. 点击 **确认绑定**，提示「绑定成功」即完成。

### 第 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 项）

绑定后，智能体可调用以下技能操作你的数据：

### 线索（联系人）

<table id="bkmrk-%E6%8A%80%E8%83%BD-%E4%BD%9C%E7%94%A8-leads_list-%E6%9F%A5%E8%AF%A2%E7%BA%BF"><thead><tr><th>技能</th><th>作用</th></tr></thead><tbody><tr><td>`leads_list`</td><td>查询线索列表：按关键词、阶段、星级、分配人、来源、分页筛选</td></tr><tr><td>`leads_stats`</td><td>线索经营统计：总数、各阶段数量、星级、活跃/阻断、来源分布</td></tr><tr><td>`leads_create`</td><td>新建线索（邮箱/电话/网址任一重复自动拦截）</td></tr><tr><td>`leads_update`</td><td>更新线索：资料、阶段、星级、评分、备注、标签、归属</td></tr><tr><td>`leads_score`</td><td>智能分级评分（0-100）：采购频次/互动/需求明确度/企业实力/意向 5 维加权，自动给出高/中/低意向与跟进建议</td></tr><tr><td>`leads_dedupe_check`</td><td>查重：检查邮箱/电话/网址是否已存在</td></tr><tr><td>`leads_assign`</td><td>线索批量分配/取消分配（仅主账号）</td></tr></tbody></table>

### 客户公司

<table id="bkmrk-%E6%8A%80%E8%83%BD-%E4%BD%9C%E7%94%A8-companies_list"><thead><tr><th>技能</th><th>作用</th></tr></thead><tbody><tr><td>`companies_list`</td><td>查询客户公司列表（关键词/行业/国家/归属人筛选）</td></tr><tr><td>`companies_create`</td><td>新建客户公司（同名自动拦截）</td></tr><tr><td>`companies_update`</td><td>更新公司资料与归属</td></tr><tr><td>`companies_assign`</td><td>公司批量分配/取消分配（仅主账号）</td></tr></tbody></table>

### 团队

<table id="bkmrk-%E6%8A%80%E8%83%BD-%E4%BD%9C%E7%94%A8-team_members-%E6%9F%A5"><thead><tr><th>技能</th><th>作用</th></tr></thead><tbody><tr><td>`team_members`</td><td>查询本账号团队成员，用于线索/公司分配</td></tr></tbody></table>

### 跟进记录

<table id="bkmrk-%E6%8A%80%E8%83%BD-%E4%BD%9C%E7%94%A8-follow_ups_lis"><thead><tr><th>技能</th><th>作用</th></tr></thead><tbody><tr><td>`follow_ups_list`</td><td>查询跟进记录（按线索/公司、方式、关键词、日期筛选）</td></tr><tr><td>`follow_ups_create`</td><td>新增跟进记录</td></tr><tr><td>`follow_ups_update`</td><td>更新跟进记录（乐观锁防冲突）</td></tr><tr><td>`follow_ups_delete`</td><td>删除跟进记录（软删除）</td></tr><tr><td>`follow_ups_summary_save`</td><td>同步 AI 总结（整体摘要/关键点/待办/建议）到跟进记录</td></tr><tr><td>`follow_ups_summary_get`</td><td>查询已同步的跟进总结</td></tr></tbody></table>

### 其他

<table id="bkmrk-%E6%8A%80%E8%83%BD-%E4%BD%9C%E7%94%A8-binding_status"><thead><tr><th>技能</th><th>作用</th></tr></thead><tbody><tr><td>`binding_status`</td><td>查询当前绑定账号、账号类型、可操作数据范围、可用技能</td></tr></tbody></table>

---

## 七、数据安全与权限

- **租户隔离**：数据按账号（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`。