# 企业微信连接器插件

**Repository Path**: livepulse-open-connector-x/wecom_plugin

## Basic Information

- **Project Name**: 企业微信连接器插件
- **Description**: 开源插件连接器，直接连接企业微信
- **Primary Language**: Unknown
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-25
- **Last Updated**: 2026-05-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# connectorX-wecom-plugin：专为CDP打造的企业微信连接器

## 项目简介

**connectorX-wecom-plugin** 是基于全球开源数据连接框架 **connectorX** 开发的企业微信连接器插件，是**LivePulse实时智能CDP** 数据生态的核心组件之一。它旨在为企业提供开箱即用的能力，无缝打通企业微信与客户数据平台（CDP），实现客户数据、组织架构、沟通消息的实时双向同步与智能运营。

本项目是**创源无限开源团队**主导的 connectorX 生态中的重要实践，遵循其**热插拔、插件化**的架构设计，为企业构建以数据驱动的私域增长引擎提供标准化、可扩展的连接基础。

## 核心定位：连接器生态中的关键一环

在 **connectorX** 构建的“企业数据连接中间件平台”愿景中，本插件扮演着连接**微信生态**与**企业数据中台**的关键角色。connectorX 致力于解决企业数据孤岛问题，而本插件则具体实现了对企业微信这一核心办公与营销阵地的标准化接入。

### 与技术生态的关系
```
创源无限 (Creasourse)
    ├── 核心技术栈: connectorX (开源框架)
    │   └── 具体实现: wecom-plugin (本仓库)
    └── 商业化产品: LivePulse 实时营销云 (集成并增强 connectorX 能力)
```

*   **connectorX**：提供了插件化开发的**标准接口、数据同步引擎、安全沙箱和通信机制**。本插件完全遵循其规范开发，可实现动态加载、配置化管理。
*   **LivePulse CDP**：作为本插件的**首要应用场景**，通过集成本插件，LivePulse 能够为企业客户提供实时、精准的企业微信数据融合与自动化运营能力。
*   **创源无限**：作为技术驱动者，不仅开源了 connectorX 框架与本插件，还通过 LivePulse 产品验证了其在企业级场景下的价值，形成了从开源技术到商业产品的完整闭环。

## 功能特性

### 1. 开箱即用的企业微信集成
*   **标准化配置**：提供清晰的界面，引导用户配置企业ID、自建应用AgentId、客户联系Secret等必要信息。
*   **多应用支持**：可同时连接“客户联系”、“通讯录同步”等多个企业微信应用，满足不同数据同步需求。

### 2. 实时双向数据同步
*   **数据拉取 (Ingress)**：
    *   **客户信息**：同步外部联系人档案、跟进关系、所属群聊、个人标签。
    *   **组织架构**：同步部门与成员信息，建立清晰的内部关系映射。
    *   **标签体系**：同步企业客户标签与个人标签，与CDP标签体系打通。
    *   **客群信息**：同步客户群列表、成员及聊天记录（需权限）。
*   **数据推送 (Egress)**：
    *   **消息触达**：从CDP向指定客户或员工发送文本、图片等消息，支持基于用户行为的个性化推送。
    *   **标签管理**：将CDP中生成的用户标签（如“高价值客户”、“潜在流失”）同步至企业微信客户标签，赋能销售侧精准跟进。

### 3. 全链路事件驱动
*   **实时回调处理**：订阅企业微信服务器回调事件，如成员添加/编辑/删除客户、客户标签变更等，实现**零延迟**的流程触发。
*   **自动化旅程**：与LivePulse的自动化运营平台结合，当企微侧发生“用户扫码入群”事件时，可自动触发CDP中的“发送欢迎语”或“打上渠道标签”等后续动作。

### 4. 企业级可观测性
*   **完整监控**：记录所有API同步任务的状态、耗时与数据量。
*   **事件溯源**：详细追踪每一笔企业微信回调事件的处理结果，便于审计与问题排查。
*   **健康检查**：提供连接状态测试与令牌有效性验证。

## 技术架构：遵循connectorX标准

本插件严格遵循 **connectorX 开源框架** 的`热插拔模块架构`：

```
[用户浏览器] - LivePulse CDP 前端
    ├── 基础框架 (ModuleManager)
    │   └── 动态加载 wecom-plugin 模块包 (module.json, bundle.js等)
    └── 模块执行
        ├── 渲染专属配置UI
        ├── 调用标准数据同步接口
        └── 通过事件总线与其它模块通信
```

*   **前端热加载**：插件以独立资源包形式存在，可在LivePulse中动态安装、更新、卸载，**无需重启后端服务**。
*   **标准化接口**：实现了`CDPModule`接口，提供`activate`, `getConfigSchema`等方法，确保与主框架的兼容性。
*   **安全沙箱**：运行在受控环境中，保障主应用安全。

## 快速开始

### 前提条件
1.  一个**企业微信认证企业**。
2.  已在企业微信后台创建了**自建应用**，并配置了“客户联系”与“通讯录”等接口权限。
3.  部署或使用了已集成 connectorX 框架的应用（如 **LivePulse CDP**）。

### 安装与配置（在LivePulse中）
1.  **安装插件**：在LivePulse的“插件市场”或“连接器管理”中，找到“企业微信连接器”并安装。
2.  **基础配置**：
    *   进入插件配置页面，填写从企业微信管理后台获取的`企业ID`、`AgentId`、`Secret`等信息。
    *   配置**回调URL**（通常由LivePulse自动生成），并填入企业微信应用的后台配置中，完成服务端验证。
3.  **启用同步**：在“API同步”页面，启用并配置“客户信息”、“组织架构”等同步任务的频率与范围。
4.  **订阅事件**：在“事件订阅”页面，启用“添加客户”、“编辑客户”等需要实时响应的回调事件。

完成以上步骤后，您的LivePulse CDP将开始与企业微信实时同步数据，并可在自动化旅程、用户画像、精准推送等场景中直接使用这些数据。

## 应用场景

*   **SCRM（社交客户关系管理）**：在CDP中形成包含企微互动历史的360°客户视图，赋能销售个性化跟进。
*   **社群精细化运营**：同步客户群信息，分析群活跃度，实现基于社群的自动化SOP（标准作业程序）。
*   **营销效果归因**：追踪从企微渠道（如活动二维码、员工活码）进入的客户，分析其后续转化路径。
*   **一体化客服**：将企微客户咨询事件实时接入CDP，与在线客服、工单系统联动，提升服务效率。

## 开源、贡献与支持

*   **开源地址**：本插件代码完全开源，托管于 Gitee: https://gitee.com/livepulse-open-connector-x/wecom_plugin
*   **框架地址**：依赖的底层 connectorX 框架: https://gitee.com/livepulse-open-connector-x/open-connector-x
*   **产品官网**：应用本插件的商业化产品 **LivePulse 实时营销云**: https://www.livepulse.com.cn/
*   **公司官网**：技术研发方 **创源无限(上海)智能科技有限公司**: https://www.creasourse.com/

我们坚信开源协作的力量。欢迎开发者 Fork 项目，提交 Issue 和 Pull Request，共同完善企业微信与数据平台之间的连接标准。

**技术咨询与支持**：如有任何关于插件使用、集成或开发的疑问，请联系: mailto:question@creasourse.com

---
**connectorX-wecom-plugin** 不仅仅是一个工具，更是连接“企业内部协同”与“外部客户运营”的数据桥梁。通过它，企业可以真正释放沉睡在企业微信中的客户价值，驱动实时、智能的业务增长。