网站首页 > 厂商资讯 > 环信 >

微信小程序云信IM的离线推送通知如何设置？

微信小程序云信IM的离线推送通知是提高用户体验、增强应用粘性的重要功能。本文将详细介绍如何在微信小程序云信IM中设置离线推送通知，帮助开发者更好地利用这一功能。

一、准备工作

注册微信小程序：在微信公众平台注册一个微信小程序，并获取AppID。
创建云开发环境：在微信公众平台后台，创建云开发环境，并获取云函数环境ID。
安装云开发工具：下载并安装微信开发者工具，配置云开发环境。
获取云函数密钥：在云开发控制台获取云函数密钥，用于后续签名。

二、离线推送通知原理

微信小程序云信IM的离线推送通知是通过微信服务器发送的。当用户在小程序中接收消息时，微信服务器会将消息存储在本地，并在用户重新打开小程序时展示。离线推送通知的实现过程如下：

开发者通过云函数向微信服务器发送推送请求。
微信服务器根据请求内容，生成离线推送消息。
微信服务器将离线推送消息存储在本地。
用户重新打开小程序时，微信服务器将离线推送消息展示给用户。

三、设置离线推送通知

创建云函数

在微信开发者工具中，创建一个云函数，用于发送离线推送通知。例如，创建一个名为sendPushNotification的云函数。

编写云函数代码

在云函数目录下，创建一个名为sendPushNotification.js的文件，并编写以下代码：

const cloud = require('wx-server-sdk')

cloud.init({

  env: cloud.DYNAMIC_CURRENT_ENV

})



exports.main = async (event, context) => {

  const wxContext = cloud.getWXContext()

  const openid = wxContext.OPENID

  const pushData = {

    touser: openid,

    title: '消息标题',

    content: '消息内容',

    // 其他推送参数...

  }

  try {

    const res = await cloud.callFunction({

      name: 'sendPush',

      data: {

        pushData: pushData

      }

    })

    return res.result

  } catch (e) {

    console.error(e)

    return {

      error: e

    }

  }

}

创建云函数sendPush

在云函数目录下，创建一个名为sendPush.js的文件，并编写以下代码：

const cloud = require('wx-server-sdk')

cloud.init()



const appid = '你的AppID'

const secret = '你的云函数密钥'



exports.main = async (event, context) => {

  const pushData = event.pushData

  const url = `https://api.weixin.qq.com/cgi-bin/message/subscribe/send?access_token=ACCESS_TOKEN`

  const timestamp = Date.now()

  const nonceStr = Math.random().toString(36).substr(2, 15)

  const signature = sha1(`timestamp=${timestamp}&noncestr=${nonceStr}&access_token=ACCESS_TOKEN`).toUpperCase()



  const data = {

    touser: pushData.touser,

    title: pushData.title,

    content: pushData.content,

    // 其他推送参数...

  }



  const options = {

    method: 'POST',

    data: JSON.stringify(data),

    header: {

      'content-type': 'application/json',

      'Authorization': `Bearer ${access_token}`

    }

  }



  try {

    const res = await request(url, options)

    return res

  } catch (e) {

    console.error(e)

    return {

      error: e

    }

  }

}

获取Access Token

在云函数sendPush.js中，需要获取Access Token。可以通过以下方式获取：

const getAccessToken = async () => {

  const url = `https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=${appid}&secret=${secret}`

  const res = await request(url)

  return res.access_token

}

调用云函数

在云函数sendPushNotification.js中，调用sendPush云函数，发送离线推送通知。

const getAccessToken = require('./getAccessToken')

const sendPush = require('./sendPush')



exports.main = async (event, context) => {

  const openid = event.openid

  const pushData = {

    touser: openid,

    title: '消息标题',

    content: '消息内容',

    // 其他推送参数...

  }

  try {

    const access_token = await getAccessToken()

    const res = await sendPush({

      pushData: pushData,

      access_token: access_token

    })

    return res

  } catch (e) {

    console.error(e)

    return {

      error: e

    }

  }

}

四、注意事项

离线推送通知需要在小程序后台开启，具体操作请参考微信小程序官方文档。
离线推送通知的推送内容有限制，请确保推送内容符合微信小程序规范。
离线推送通知的发送频率有限制，请合理控制发送频率。
离线推送通知的接收效果受用户网络环境、设备等因素影响，请提前测试。

通过以上步骤，您可以在微信小程序云信IM中设置离线推送通知。合理利用这一功能，可以提升用户体验，增强应用粘性。