wechat_oa_api_plugin_dify

微信公众号API插件

作者: kakaxi3019
版本: 0.0.1
类型: 工具插件

功能概述

微信公众号API插件为Dify平台提供了与微信公众号后台直接交互的能力，使AI应用能够自动化完成微信公众号的内容创建、发布和管理。本插件封装了微信公众号的核心API，简化了认证流程和错误处理，让开发者能够轻松地将微信公众号集成到自己的AI应用中。

主要功能

• 获取访问凭证: 自动获取并管理微信公众号API的access_token
• 创建草稿: 支持创建包含文字和图片的微信公众号图文草稿
• 发布草稿: 将已创建的草稿发布到微信公众号
• 删除草稿: 删除未发布的草稿内容
• 删除素材: 删除已上传的永久素材

安装方式

本插件可通过Dify平台上的插件页面通过GitHub方式安装，详细请参考Dify官方文档

微信公众平台

微信公众平台官方网址：https://mp.weixin.qq.com

您需要先在微信公众平台注册并创建公众号，获取开发者ID(AppID)和密钥(AppSecret)才能使用本插件。

##使用指南

配置步骤

1. 在Dify平台中安装本插件
2. 调用插件API输入相应参数。
3. 测试连接是否成功
4. 在您的应用中启用该插件

使用示例

示例1：创建并发布图文内容

// 步骤1：获取access_token
{{wechat_get_access_token AppID="您的AppID" AppSecret="您的AppSecret"}}

// 步骤2：创建草稿
{% $draft_result = wechat_create_draft 
  access_token=$result 
  image_url="https://example.com/your-image.jpg" 
  title="AI生成的文章标题" 
  content="<p>这是AI生成的文章内容</p>" 
  author="AI助手" 
%}

// 步骤3：发布草稿
{% if $draft_result.success %}
  {{wechat_publish_draft 
    access_token=$result 
    draft_media_id=$draft_result.draft_media_id
  }}
{% else %}
  创建草稿失败: {{ $draft_result.error }}
{% endif %}

示例2：删除草稿

// 获取access_token
{{wechat_get_access_token AppID="您的AppID" AppSecret="您的AppSecret"}}

// 删除草稿
{{wechat_del_draft 
  access_token=$result 
  draft_media_id="您要删除的草稿ID"
}}

API参考

wechat_get_access_token

获取微信公众号API调用凭证。

参数:

• AppID: 微信公众号的AppID
• AppSecret: 微信公众号的AppSecret

返回:

• 成功时: 返回access_token字符串
• 失败时: 返回包含错误信息的对象 {success: false, error: "错误信息", access_token: null}

wechat_create_draft

创建微信公众号图文草稿。

参数:

• access_token: API调用凭证
• image_url: 封面图片URL
• title: 文章标题
• content: 文章内容（HTML格式）
• author: (可选) 作者名
• digest: (可选) 文章摘要
• content_source_url: (可选) 原文链接
• need_open_comment: (可选) 是否打开评论，0关闭，1打开

返回:

• 成功时: 返回包含草稿ID的对象 {success: true, error: null, draft_media_id: "ID", image_media_id: "图片ID"}
• 失败时: 返回包含错误信息的对象 {success: false, error: "错误信息", draft_media_id: null, image_media_id: null}

wechat_publish_draft

发布已创建的草稿。

参数:

• access_token: API调用凭证
• draft_media_id: 要发布的草稿ID

返回:

• 成功时: 返回发布ID字符串
• 失败时: 返回包含错误信息的对象 {success: false, error: "错误信息", publish_id: null}

wechat_del_draft

删除未发布的草稿。

参数:

• access_token: API调用凭证
• draft_media_id: 要删除的草稿ID

返回:

• 成功时: 返回"草稿删除成功"的消息
• 失败时: 返回包含错误信息的对象 {success: false, error: "错误信息", errcode: null, errmsg: null}

wechat_del_material

删除已上传的永久素材。

参数:

• access_token: API调用凭证
• media_id: 要删除的素材ID

返回:

• 成功时: 返回"永久素材删除成功"的消息
• 失败时: 返回包含错误信息的对象 {success: false, error: "错误信息", errcode: null, errmsg: null}

使用限制

为了分散服务器压力，每个IP每分钟内最多能调用同一接口五次。

IP白名单配置

根据微信公众号开发接口管理规定，通过开发者ID及密码调用获取access_token接口时，需要设置访问来源IP为白名单。请将以下IP添加至微信公众号-设置与开发-开发接口管理-IP白名单：

106.15.125.133

技术支持

如有任何问题或建议，请通过以下方式联系我们：

• 发送邮件至jupiter3019@163.com