企业微信外部客户 AI 接待与自动备注系统

客户会话列表

🎭 点此直接扮演客户提问/回复：

🏷️ 功能1：直接替我的企微自动修改备注

企微备注名 (remark)：待提取...

企微描述 (description)：待提取...

✅ 无需二次扫码！客户每回一句话，系统直接调用企微 externalcontact/remark 替你的企业微信修改备注与描述。

📋 功能3：AI 实时搜集的品牌客户档案待评估

所属行业/品类：

业务渠道/规模：

AI声量现状：

核心合作诉求：

联系电话：

追问轮次：

0 轮

🧑‍💼 功能4：关键节点反馈 & 人工介入回复等待触发节点

当核心需求搜集完成（或客户询问价格/方案）时，系统自动向你企微推送《客户需求摘要卡》，并生成下方建议回复话术：

发送后会话将标记为「人工已接管」

🎯 一、自动发公司介绍 & AI 追问话术配置（功能 2 & 功能 3）

公司/产品名称 (COMPANY_NAME)

自动发送的公司介绍 (WELCOME_INTRO)

紧跟介绍发送的破冰问题 (FIRST_QUESTIONS)

需要搜集的核心维度 (REQUIRED_FIELDS)

最大自动追问轮数 (MAX_FOLLOWUP_TURNS)

🧠 二、大模型 API 配置（兼容 DeepSeek / 通义千问 / OpenAI）

接口地址 (LLM_BASE_URL)

通义千问填 https://dashscope.aliyuncs.com/compatible-mode/v1；DeepSeek填 https://api.deepseek.com/v1

模型名称 (LLM_MODEL)

⚠️ 阿里云千问标准模型名请填：qwen-max、qwen-plus 或 qwen-turbo（不要填 qwen-3.8-max）

大模型 API Key (LLM_API_KEY) —— 请填 sk- 开头的密钥（已改为明文显示防粘错）

🏢 三、企业微信对接配置（微信客服 + 客户联系自动改备注 + 内部通知）

企业 ID (WECOM_CORP_ID)

自建应用 Secret (WECOM_APP_SECRET)

自建应用 AgentId (WECOM_AGENT_ID)

回调 Token (WECOM_CALLBACK_TOKEN)

回调 EncodingAESKey (WECOM_CALLBACK_AES_KEY)

接收需求卡片与直接接管会话的员工企微账号 (WECOM_STAFF_USERID)

内部销售群机器人 Webhook (WECOM_GROUP_WEBHOOK_URL，可选)

AI 收集完需求后，自动切换为「人工直接接管同一聊天窗口」 (AUTO_TRANSFER_TO_HUMAN)

是否向客户发送第二个「员工企微好友二维码」 (AUTO_SEND_CONTACT_QR)

💡 为什么之前用内部机器人报 853006，而这套架构能完美走通？

企业微信里的「群机器人 / 内部智能机器人」官方仅限企业内部群使用，外部微信用户无法添加，且拉取接口有严格的灰度白名单限制（报 853006）。
而本系统采用企业微信官方专门为外部客户设计的 「微信客服 API」+「客户联系 API」 双通道组合：

微信客服通道：任何外部微信用户无需先加好友，扫客服码或点链接即可进入聊天 -> 触发本系统自动发公司介绍 + AI多轮追问并提取需求（未认证企微也可免费接待100名外部客户）。
节点通知人工：AI 收集齐「行业+设备数+痛点」后，立刻通过企微自建应用/内部群机器人把《客户需求摘要卡》发到你手机企微上，并支持直接人工接管回复。
客户联系通道（自动改企微好友备注）：AI 收集完需求后自动附上带专属参数（state=kf_客户ID）的员工企微二维码，客户一扫码加你好友，系统立即调用 /cgi-bin/externalcontact/remark 自动把客户的「公司-行业-设备数-痛点」写入你企微通讯录的好友备注与描述中！

🛠️ 四步完成企业微信后台配置（约 10 分钟）

第 1 步：创建自建应用（获取 CorpID 与 Secret）

1. 登录企业微信管理后台 -> 我的企业 -> 复制最下方的 企业ID (CorpID)。
2. 进入 应用管理 -> 自建 -> 创建应用（名称如：AI客户接待助手，可见范围选你自己）。
3. 进入创建好的应用，复制 AgentId 和 Secret，填入本系统「⚙️ 配置」页。

第 2 步：把本服务暴露到公网（配置回调 URL）

企业微信推送消息需要能访问你的 /wecom/callback 接口：
• 如果你用云服务器：将本项目放到服务器上运行 npm start，回调地址填 http://你的服务器IP或域名:3000/wecom/callback。
• 如果你先在本地电脑测试：运行免费内网穿透工具（如 npx localtunnel --port 3000 或 cpolar http 3000），获得公网 HTTPS 地址后拼接 /wecom/callback。

第 3 步：开启「微信客服」并绑定 API 回调

1. 在企微后台进入 应用管理 -> 微信客服 -> 创建一个客服账号（如“XX设备云顾问”），在「接待人员」里先不要挂人工（或开启 API 接管）。
2. 往下滑找到 「通过 API 管理微信客服」 -> 点击「去设置」：
3. 在「接收事件服务器」中点击「点此随机获取」生成 Token 和 EncodingAESKey，先复制到本系统「⚙️ 配置」页并点保存，然后再回到企微后台填入 URL https://你的域名/wecom/callback 点保存即可一次通过验证！
4. 在下方「可调用接口的应用」中勾选你刚才创建的自建应用 AI客户接待助手。

第 4 步：开启「客户联系」权限（实现加好友自动修改企微备注）

1. 在企微后台进入 客户联系 -> 客户 -> API 展开菜单。
2. 在「可调用接口的应用」中勾选你的自建应用 AI客户接待助手。
3. 在「接收事件服务器」中填入相同的回调 URL、Token 和 EncodingAESKey。这样客户扫码加你企微好友的瞬间，系统就能收到事件并自动把他的行业、设备数和痛点写进你的企微好友备注里！