系统设置
本地测试先连接企业微信 API，系统自动识别承接成员和企微标签；正式客户同步再配置数据库和回调。
企微接入配置
当前用于本地 API 测试，不要求 CRM 先上线，也不要求公网回调地址。
集成配置状态
{
"corpId": "ww188b8083f02b35a4",
"agentId": "",
"contactSecretConfigured": true,
"contactSecretMasked": "U6C0••••TSYk",
"tokenConfigured": true,
"tokenMasked": "bihu••••d77a",
"aesKeyConfigured": true,
"aesKeyMasked": "Vdmo••••yP69",
"followUserids": "metafeng,LinWenGuangaven,LinWenGuangaven01,yuanfeng,LinWenGuanJiangai,XieYiPeng",
"apiBaseUrl": "https://qyapi.weixin.qq.com/cgi-bin",
"dataSourceMode": "postgres",
"databaseUrlConfigured": true,
"databaseUrlMasked": "postgresql://crm_app:••••@127.0.0.1:5432/wecom_ai_crm",
"syncLimit": 100,
"liveWriteEnabled": false,
"storageMode": "database",
"kfSecretConfigured": false
}
{
"appId": "",
"appSecretConfigured": false
}
{
"openAiConfigured": false
}
mock
企微与 AI 接口检查
这里显示本地测试、正式存储和回调能力的实际状态。
| 配置项 | 说明 | 状态 |
|---|---|---|
| DATA_SOURCE_MODE | 数据源模式，生产接企微时不能是 mock | 已配置 |
| WECOM_CORP_ID | 企业微信 CorpID | 已配置 |
| WECOM_AGENT_ID | 应用 AgentID | 未配置 |
| WECOM_TOKEN | 回调 Token | 已配置 |
| WECOM_ENCODING_AES_KEY | 回调解密 Key | 已配置 |
| WECOM_CONTACT_SECRET | 企微自建应用 Secret，且应用必须已加入客户联系可调用应用 | 已配置 |
| WECOM_FOLLOW_USERIDS | 参与客户同步的企微成员 UserID，多个用英文逗号分隔 | 已配置 |
| WECOM_LIVE_WRITE_ENABLED | 真实写入企微标签开关，默认关闭以避免误刷标签 | 未配置 |
| WECOM_KF_SECRET | 微信客服 Secret | 未配置 |
| WECOM_KF_OPEN_KFID | 微信客服接待账号 ID | 未配置 |
| OPENAI_API_KEY | AI 自动回复密钥 | 未配置 |
| OPENAI_MODEL | AI 自动回复模型 | 未配置 |
企微接入蓝图
| 入口路由 | 事件类型 | 用途 |
|---|---|---|
| /api/v1/wecom/contact/events | external_contact_change | 客户进入企微、标签或归属变化时同步 CRM |
| /api/v1/wecom/tag-sync/pull | change_external_tag | 企微标签更新后回拉到 CRM，保持两端标签一致 |
| /api/v1/wecom/kf/events | customer_service_message | 客户发消息后进入会话中心和 AI 首轮接待流程 |
处理阶段
验签与解密
事件入库
客户识别与去重
标签双向同步
标签与阶段更新
AI 判断是否自动回复
需要时转人工
系统输出
回写企微客户标签
回写客户阶段
记录 AI 回复日志
进入待跟进队列
汇总 ROI 与转化漏斗