pushplus(推送加) 文档中心
文档中心
常用工具
智能助手
官网
文档中心
常用工具
智能助手
官网
  • 简介

    • 介绍
    • 服务协议
    • 用户隐私协议
    • 联系我们
  • 使用说明

    • 一对一消息
    • 一对多消息
    • 好友消息
    • 文本命令
    • 会员功能
    • 收/发消息设置
    • 系统功能额度
    • 消息接口限制
    • 实名认证说明
    • 预处理信息配置
  • API文档

    • 消息接口文档
    • 开放接口文档
    • 消息回调说明
    • 返回码说明
    • Demo代码
    • pushplus MCP Server
  • 渠道配置

    • 发送渠道说明
    • 短信渠道配置
    • 语音渠道配置
    • 绑定自己的微信公众号
    • webhook渠道配置
    • 邮件渠道配置
    • 企业微信应用配置
    • 浏览器插件使用教程
    • 桌面应用程序使用教程
    • APP渠道使用说明
  • 消息模板

    • 消息模板说明
    • 支付成功通知模板
    • Jenkins插件
    • 阿里云监控
    • 路由器插件
  • 扩展应用

    • xxl-job推送设置
    • 推送到企业微信机器人
    • 推送到钉钉机器人教程
    • 推送到飞书机器人教程
    • 通过腾讯轻联实现发短信
    • 通过集简云发送企业微信消息
    • 调用IFTTT的webhook
    • 自定义webhook配置
  • 常见问题

    • 常见问题
    • APP上没有通知弹框
    • Get请求导致的问题
    • 实名认证相关问题
    • 用户token和消息token有什么区别
    • 发送消息接口限制
    • 微信消息模板是否可以自定义
    • 收不到消息如何排查
    • 才收到几条消息却被限制发送了
    • IP被禁止访问原因
    • 如何解封账号
    • 一对多消息为什么只有我自己收到
    • 提示无用户接收消息
    • 如何在公众号中显示推送内容
    • 菜单上的激活消息有什么用
    • 是否支持发送图片
    • 消息内容中如何换行
    • 用户信息状态不合法
    • 接口是否支持https
    • json模板如何正确展示
    • pushplus官网

预处理信息配置

一. 场景说明

  有一些场景消息内容是第三方返回的,无法直接修改。比如阿里云监控报警,仅是配置一个webhook的地址。但是又想自己对消息内容进行微调修改。原本做法需要自己写一段逻辑,先webhook到自己程序的地址上,然后处理好以后在服务端请求pushplus的发送消息接口。一是需要自行开发,二是还需要有服务器进行部署。为了方便处理这种场景,新增加了一个预处理(pre)的字段,可提前在页面上配置对消息内容的处理代码,发送消息的时候直接带上编码参数即可。相当于把原本自己编码的逻辑放在pushplus服务器上,在发消息的时候一并给处理了。

  当然这么强大的功能还是有一些限制的。

    1. 仅提供会员使用。
    1. 对于脚本代码性能上有所限制,防止死循环、异常逻辑、挖矿等恶意行为。
    1. 暂时支持原生JavaScript语言。

二. 配置操作

配置之前请确保您已经开通会员。在"我的"-> "个人中心" -> "预处理信息" 中新增一条预处理信息。

  • 预处理名称:方便用户自己查看的,随便定义。
  • 预处理编码:在发送消息接口中有一个pre字段,就需要填写这个值。用户自定义。
  • 预处理代码:针对消息内容的处理代码逻辑。

在填写完成以后,可以点击测试按钮来检测编写的预处理代码是否有问题。
在弹框中的消息内容填写原本收到的消息内容,然后点击确认后会看到预处理代码执行后的结果。如有报错也会显示在结果框内。

三. 预处理代码示例

代码中内置了一个全局上下文变量content,这个变量来指代“消息内容”。所以你要改变消息内容就需要重新给这个变量赋值。

1. 重新自定义消息内容

content = '新定义的消息内容'

2. 追加内容

content += '追加的内容'

3. 替换内容

//把消息内容中的a替换成b

content = content.replace('a','b')

4. 正则表达式

//验证消息内容是否是手机号码,返回true或false

const regex = /^1[3-9]\d{9}$/;
content = regex.test(content).toString();

三. 发送消息中使用

1. 官网“试一试”中使用

可以直接在官网的 “发消息”-> "一对一消息" -> "试一试"中。预处理编码下拉框中选择之前录入好的信息,点击发送即可。

2. 发送消息接口中使用

发送消息接口中新增了pre参数,只需要将预处理编码填到pre字段中即可。以下示例,其中appendMsg就是用户自定义的预处理编码。

  • 请求地址:http://www.pushplus.plus/send
  • 请求方式:POST
  • 请求内容:
{
    "token":"{token}",
    "title":"这是标题",
    "content":"消息内容正文",
    "pre": "appendMsg"
}

可以看到收到的消息内容已经追加,并不是接口报文中的content字段内容了。

更新时间: 2024/8/26 11:47
上一页
实名认证说明