wechat-public-account-push 是一个用于微信公众号/微信测试号给用户执行微信推送的脚本，改编自目前小红书/知乎突然火起来的【给女朋友的七夕浪漫，微信自动推送消息】，用Nodejs实现而成。

如果这个项目很有意思，帮忙右上角点个 star✨ 支持我们 ❤❤

如果有任何需要帮助可以联系wangxin.leo@outlook.com ❤❤

>>> 点这里获取更新公告✨

重要通知：

微信团队于2023-05-04日晚12点下线【自定义颜色】、【emoji表情符号】、【自定义换行】、【尾部/备注字段】。

【微信测试号】的推送服务已受到影响，原有的推送模板需要用户自行修改，详见 如何修复因2023-05-04微信推送服务规范整改，导致推送服务异常

使用服务号推送不受影响

详细功能如下：

• 支持多个收件人设置成不同的测试号模板，专属定制更贴心
• 推送每日天气
• 各类文案集锦
• 支持农历生日提醒
• 每日/明日/每周/每年星座运势
• 大学生课程表
• 前N个值得纪念的日子
• 推送回执
• 自定义出参，模板定制更个性
• 网页自动生成配置插件
• 支持gitee go / github actions 不需要拥有服务器，白嫖actions执行，每天定时发送
• 支持本地化部署每天定时发送
• 支持多推送渠道

[目录]

• 1. 如何使用
  • 1.1. 第一步：选用一个合适的消息通道
  • 1.2. 第二步：完成配置文件，并运行wechat-public-account-push
    • 1.2.1 方式一：使用网页工具自动生成Github-Action配置(不准时，排队执行，胜在免费)
    • 1.2.2 方式二：使用Github-Action(不准时，排队执行，胜在免费)
    • 1.2.3 方式三：使用Gitee-go(定时任务收费，前200分钟免费，非常准时)
    • 1.2.4 方式四：下载程序包到本地或服务器运行(需要有自己的服务器，使用系统的定时任务非常准时)
    • 1.2.5 方式五：使用云函数运行（需要使用运营商提供的 付费 云函数功能，非常准时)
• 2. 公众号模板参数说明
• 3. config参数说明
• 4. template-config推送模板参数说明
• 5. 常用的推送模板样例
• 6. GitHub/Gitee 如何更改自动执行时间
  • 6.1 github action如何更改自动执行时间
  • 6.2 gitee go如何更改自动执行时间
• 7. 常见问题
• 8. 版本发布及更新
  • 8.1 重新fork
  • 8.2 GitHub Fetch Upstream Branch
  • 8.3 actions 脚本自动
• 9. 成为开源贡献成员
  • 9.1 贡献代码
  • 9.2 贡献文档
• 10. 致谢
  • 贡献/参与者
• 11. wechat-public-account-push答疑群
• 12. 其他

Github 仓库地址：wangxinleo/wechat-public-account-push

Github 镜像仓库地址（国内备用01）：wangxinleo/wechat-public-account-push

Github 镜像仓库地址（国内备用02）：wangxinleo/wechat-public-account-push

Gitee 国内仓库地址：wangxinleo/wechat-public-account-push

注意：

• 本仓库开源的初衷是看不下去营销号用这么一个简单的脚本刻意在网络上肆意要求加群/关注微信公众号才能获取源码的行为
• 本应用仅用于学习和测试，作者本人并不对其负责，请于运行测试完成后自行删除，请勿滥用！
• 所有代码都是开源且透明的，任何人均可查看，程序不会保存或滥用任何用户的个人信息
• 请仔细阅读配置文档，自己对自己的配置负责

运行图示：

新手教学⭐点击开始学习

1. 如何使用

wechat-public-account-push 实现自消息推送的原理，是通过调用一系列开放的api实现的, 所以也非常适合初学者学习。

要使用 wechat-public-account-push, 我们只需要选择合适的消息通道, 得到相关配置信息进行配置即可

1.1. 第一步：选用一个合适的消息通道

您可以在以下消息通道中选择一适合自己的消息通道

推荐通道

iOS 可以无后台推送，推荐使用

2022年9月22日 Android 无法正常推送，MiPush 把 pushdeer 应用的推送权限暂停。原因是要求pushDeer审核推送内容。

⭐PushDeer >>> 点击使用

其他通道

免费版每个接收用户每天允许推送200条消息，付费版每个接收用户每天1000条

1分钟内接收5次请求，超出的请求将不再推送。另外对于相同的内容，1小时内限制发送3条。

消息推送时显示的是 设备通知，标题需要进入公众号查看

消息放置在消息列表，方便随时查看

不再是xxxx测试号，而是推送加服务号，更美观

此通道可能会被腾讯弃用，请评估风险后再选择

⭐pushplus推送加服务号 >>> 点击使用

免费版每个接收用户每天允许推送5条消息，付费版每个接收用户每天1000条

消息推送时显示的是 设备通知，标题需要进入公众号查看

消息放置在消息列表，方便随时查看

不再是xxxx测试号，而是方糖服务号，更美观

此通道可能会被腾讯弃用，请评估风险后再选择

⭐server酱服务号 >>> 点击使用

测试号的标题不能修改为自定义的名称，不能修改测试号的头像

推送的消息必须要点进订阅号才能收到

每次要修改内容必须要自定义模版

此通道可能会被腾讯弃用，请评估风险后再选择

⭐微信测试号 >>> 点击使用

2022年6月20日后创建的应用需要填写可信IP，且可信IP不可公用，因此新应用无法按此配置通道

2022年9月23日后可信IP无法直接填写，需要验证企业域名才允许使用，意味着此方式将不再向个人提供服务

⭐企业微信应用消息 >>>(已删除)

1.2. 第二步：完成配置文件，并运行wechat-public-account-push

1.2.1 方式一：（可能仅支持微信测试号）使用网页工具自动生成Github-Action配置(不准时，排队执行，胜在免费)

以下为@shuangxunian ShuangxuNian大佬 提供的网页配置插件

使用时请详细参考其提供的具体文档

感谢 ShuangxuNian大佬 的贡献

✨配置自动生成 传送门 >>>

❓配置自动生成 教程 >>>

❓配置完成后如何手动运行或者更改自动运行时间? 点开链接查看4. 5. >>>

1.2.2 方式二：使用Github-Action(不准时，排队执行，胜在免费)

世界上最大的同性交友平台(不是)，需要一定的英语基础，编辑的时候请不要使用网页的自动翻译

❓Github-Action部署教程 >>>

1.2.3 方式三：使用Gitee-go(定时任务收费，前200分钟免费，非常准时)

国产代码仓库，和github逻辑基本一致。全中文，对萌新友好。

❓Gitee-Go部署教程 >>>

1.2.4 方式四：下载程序包到本地或服务器运行(需要有自己的服务器，使用系统的定时任务非常准时)

如果是 Nodejs 开发者，直接 Clone 源码，然后 VS 打开后即可直接本地进行运行和调试。

对于不是开发者的朋友，可以通过以下教程到本地或任意服务器运行

❓本地或在线服务器部署教程 >>>

1.2.5 方式五：使用云函数运行（需要使用运营商提供的 付费 云函数功能，非常准时)

由 @ZzqiZQute zz 大佬提供代码迁移及教程编辑

❓云函数部署教程 >>>

2. 公众号模板参数说明

以下参数可以被微信公众号的模板消息{{xxx.DATA}}捕获，用来自定义小伙伴们需要的信息。

目前可被推送模板获取的字段如下：

删除线 为已废除的参数

基础类

天气类（由于是免费接口，服务器并不稳定会拿不到数据，推荐使用下方的天行接口）

节假日

{index}替换为要显示的第N-1个

用法示例：

为了能在微信推送中使用，长文本被截取成20个字符每段

wx_holidaytts_0.DATA -> 今天是工作日啊~距离下个周六，还有3天;

wx_holidaytts_1.DATA -> 距离最近的一个节日是9月29日的中秋节，

...

wx_holidaytts_999.DATA

每日N句

{index}替换为要显示的第N-1个

用法示例：

为了能在微信推送中使用，长文本被截取成20个字符每段

wx_one_talk_0.DATA -> 风起，花飘零，梦醒时分，却有几多愁，上

wx_one_talk_1.DATA -> 心头。

...

wx_one_talk_999.DATA

星座运势

计时类

{index}替换为要显示的第N-1个

用法示例：

距离第1近的生日消息和节日消息请填写

wx_birthday_0.DATA -> 距离 宝贝 的生日还有122天

第2节课请填写

wx_course_schedule_1.DATA -> 08:00-09:35 高等数学

(请确保在配置文件中设置了正确的天数）

天行简单API

以下配置需要在天行数据上申请对应的接口，并将APIKEY放置在配置文件的TIAN_API.key字段中

天行天气API

以下配置需要在天行数据上申请对应的接口，并将APIKEY放置在配置文件的TIAN_API.key字段中

点击此处申请接口

该接口每次调用独立按次计费，具体计费规则请查阅接口文档

{offset}替换为距离今天的天数

用法示例：

今天的 天气信息请填写

tian_api_weather_weather_0.DATA -> 晴转多云

明天的 天气信息请填写

tian_api_weather_weather_1.DATA -> 多云转晴

(请确保在配置文件中设置了正确的天数）

推送回执(特有, 仅在其他模板发送完成后才能获取)

自定义计时及自定义文本插槽

小伙伴在只要在CUSTOMIZED_DATE_LIST 和 SLOT_LIST 中按格式填写相应内容

微信测试模板即可获取到你配置中设置好的内容了。

例如，您可以在配置文件中设置一个 love_day, 然后在【微信模型消息】中就可以用{{love_day.DATA}} 获取到内容了。

么么哒！
今天是我们在一起的的第{{love_day.DATA}}天

爱你！

大概的实现原理类似于下图标注的这样：

但是有以下情况需要注意，不要占用表中已有的关键字，会发生不可预料的状况噢！

3. config参数说明

配置文件的详细说明，使用旧配置的小伙伴可以对照此文档增加新的配置

❓config参数说明 >>>

4. template-config推送模板参数说明

配置文件的详细说明，使用旧配置的小伙伴可以对照此文档增加新的配置

❓template-config推送模板参数说明 >>>

5. 常用的推送模板样例

收录一些常用好看的模板消息

❓常用的推送模板样例 >>>

6. GitHub/Gitee 如何更改自动执行时间

6.1 github action如何更改自动执行时间

这里的脚本使用的是 github 的 workflow 定时任务, 具体脚本文件放置在:

wechat-public-account-push/.github/workflows/weixin-push-on-time.yml

这里简单说明一下如何更改自动执行时间

目前脚本默认执行时间为 每天的 北京时间上午 07:30

如果想要变更脚本定时任务执行时间,可以更改以下代码段

on:
 workflow_dispatch:
 schedule:
  # 每天国际时间2:10 运行, 即北京时间 10:10 运行
  - cron: '30 23 * * *'

推荐设置: 30 22 * * * 或 30 23 * * * 等冷门时间，拥堵率低

定时任务注意尽量避免设置在 utc 0:00, XX:00 这类高拥堵时段。

定时任务注意尽量避免设置在 utc 0:00, XX:00 这类高拥堵时段。

定时任务注意尽量避免设置在 utc 0:00, XX:00 这类高拥堵时段。

或使用https://crontab.guru帮助配置

6.2 gitee go如何更改自动执行时间

7. 常见问题

关于获取accessToken:请求失败invalid appsecret rid xxxxx

关于推送失败，报40001- 4000X

关于目前仅支持测试号的问题

关于定时任务好像没有自动执行（?）

Issues（议题）板块可以用来提交Bug和建议；

Discussions（讨论）板块可以用来提问和讨论。

所以如果你有疑问，

• 请先确认是否可以通过升级到最新版本解决
• 然后搜索文档（特别是配置说明文档和常见问题文档）查看是否已有解决方案

如果确认还未解决，可以自己提交 Issue，我会尽快确认并解决。

8. 版本发布及更新

关于新版本发布后，如何同步最新的内容到自己 Fork 的仓库

8.1 重新fork

删掉后重新Fork会导致之前配置过的GitHub Secrets和提交的代码更改全部丢掉，只能重新部署。

8.2 GitHub Fetch Upstream Branch

• 在自己的项目仓库中选择 "Sync fork"

• 点击 "Update branch" 完成

可能会遇到 因为冲突需要你们删除你们已经更改的记录

如果只是纯粹更改配置，放心大胆的点删除, 然后更新最新代码仓库就好了。

如果你更改了源代码进行了部分定制, 请注意备份代码段。

8.3 actions 脚本自动

以后会考虑加入actions 脚本每周自动更新fork仓库，但是目前精力不足，只能采用上述保守方案

建议每个人先看看更新的内容是否是自己需要的再进行更新。

也建议把右上角的 Star 点一下，这样有重要更新时就会有邮件推送了。

9 成为开源贡献成员

9.1 贡献代码

如果你有好的想法，欢迎向仓库贡献你的代码，贡献步骤：

• 搜索查看 Issue，确定是否已有人提过同类问题或者有新的想法

• 确认没有同类 Issue 后，自己可新建 Issue，描述问题或建议

• 如果想自己解决，请 Fork 仓库后，在develop 分支进行编码开发，完成后提交 PR 到 develop 分支，并标注解决的 Issue 编号

我会尽快进行代码审核，测试成功后会合并入 main 主分支，提前感谢您的贡献。

9.2 贡献文档

文档部分由于我个人精力有限（写文档比写代码累多了），所以有些地方写的很简略，甚至有遗漏和错别字，不能贡献代码的朋友也欢迎来一起维护文档，欢迎 PR 来纠正我，一样都算是对开源做贡献了。

10. 致谢

贡献/参与者

@LordonCN Lordon

@ZzqiZQute zz

@shuangxunian ShuangxuNian

@只会前端的小废物

感谢那些默默支持我, 鼓励我继续更新这个小玩具的朋友。

感谢所有参与到开发/测试中的朋友们，是大家的帮助让 TA 越来越好！ (*´▽｀)ノノ

11. wechat-public-account-push答疑群

不管文档写得多详细，还是会有人不会呐！还是建个群答疑吧!

群我隐藏在文档里了哼哼，不仔细看文档可找不到加群的地方哦！

2022-09-10 算啦还是不隐藏了，你们来尽情问吧。

12. 运行

注意，在官方文档中有这么一段：

To prevent unnecessary workflow runs, scheduled workflows may be disabled automatically. When a public repository is forked, scheduled workflows are disabled by default. In a public repository, scheduled workflows are automatically disabled when no repository activity has occurred in 60 days.

也就是说，定时执行的任务需要每隔 60 天激活一次。

使用 “import repository” 功能重新导入自己已经fork过的仓库，选为私有后，就不会出现这种情况了。

13. 其他

时区查询: https://www.zeitverschiebung.net/cn/all-time-zones.html

城市数据: https://github.com/baichengzhou/weather.api/blob/master/src/main/resources/citycode-2019-08-23.json