Home Assistant 企微通集成 企业微信应用workchat_integration

yzg790787394

Home Assistant 企微通集成

企微通集成允许Home Assistant与企业微信（WorkChat）无缝集成，实现双向通信功能。通过此集成，您可以：

📨 从Home Assistant向企业微信发送各种类型的消息（文本、图片、文件、卡片等）
📥 接收企业微信发送的消息（文本、图片、位置等）
📊 在Home Assistant中展示接收的消息内容和回调信息
🌟 功能概览
📨 消息发送：支持多种消息类型发送到企业微信
📤 文件上传：上传媒体文件到企业微信服务器
🔄 双向通信：接收企业微信的消息回调并处理
📊 传感器集成：将接收的消息和状态展示为传感器实体
🔐 安全验证：支持企业微信的安全验证机制
📦 安装

详情见：
https://github.com/yzg790787394/workchat_integration

⚙️ 配置
步骤1：获取企业微信参数
在开始配置前，您需要从企业微信管理后台获取以下信息：

企业ID（Corp ID）：企业微信的唯一标识
应用Secret：企业微信应用的密钥
应用Agent ID：企业微信应用的ID
Token：用于回调验证的令牌
EncodingAESKey：用于消息加密的密钥
步骤2：在Home Assistant中添加集成
进入Home Assistant的 设置 > 设备与服务 > 集成
点击右下角的 + 添加集成
搜索并选择 “企微通”
填写以下配置参数：
企业ID：您的企业ID
应用Secret：应用的密钥
应用Agent ID：应用的ID
Token：回调验证令牌
EncodingAESKey：加密密钥
接收用户：默认接收消息的用户（如或指定用户ID）@all
外部URL：Home Assistant的外部访问地址（自动填充）
点击 提交 完成配置
步骤3：设置企业微信回调
配置完成后，您需要将回调URL设置到企业微信后台：

在集成配置完成后，检查日志中显示的回调URL（格式如：）https://your-ha-domain/api/workchat_callback/your_token
登录企业微信管理后台
进入"应用管理" > 选择您的应用 > "接收消息"
点击“设置API接收”
填入以下信息：
URL：Home assistant中显示的回调URL
Token：与配置中相同的Token
EncodingAESKey：与配置中相同的EncodingAESKey
保存设置并启用

最好一定要配置可信IP

更新新版本，增加自定义菜单触发信息
实体信息

Zuray

<Integration yzg790787394/workchat_integration> Repository structure for v1.0.0 is not compliant
<Integration yzg790787394/workchat_integration> v1.0.0 版本的仓库结构不符合规范

chaosl

牛逼！动态IP无法配置IP白名单，功能还能正常使用吗？

guxingtianya

需要配置IP白名单吗

yzg790787394

chaosl 发表于 2025-6-21 23:45
牛逼！动态IP无法配置IP白名单，功能还能正常使用吗？

动态ip配置了还是可以用好久的。我的正常使用。更新新版本了去看看吧。

yzg790787394

guxingtianya 发表于 2025-6-22 00:32
需要配置IP白名单吗

需要的。动态ip配置了还是可以用好久的。我的正常使用。更新新版本了去看看吧。

yzg790787394

Zuray 发表于 2025-6-21 22:03
Repository structure for v1.0.0 is not compliant
v1.0.0 版本的仓库结构不符合规范

github小白一名，不太会用。

隔壁的王叔叔

嗯，不错，不错

loveyolanda

原来的需要IPV4公网，换成IPV6公网后企业微信不支持就没用了，这个不知道还IPV6能搞不？

kndo

应该是目录结构不太对，现在这样没法识别

README.md之外的插件文件放在
custom_components/workchat_integration

根目录下还需要一个hacs.json

{
    "name": "workchat integration",
    "render_readme": true,
    "homeassistant": "2024.04"
}

复制代码