好友消息使用说明
引言
好友消息主要解决的是一对多消息不够灵活的问题。原本给他人发消息必须新建群组，如果有给多人分别发不同的消息就需要创建多个群组，操作起来比较麻烦不够灵活自由。而好友消息就可以在发送消息的时候指定具体接收用户，给不同好友定制发送不同的消息内容。
使用步骤
- 发送好友消息需要先增加好友，让其他用户扫码自己的二维码，即可增加好友。扫码支持APP或者微信。
可以设置二维码的有效期天数和扫码次数，用来避免个人二维码泄漏。
回调内容是在设置回调地址后，新增好友后系统会将回调内容(qrCode参数)发送到回调地址上。可用于区分用户来源。
- 增加好友和删除好友都是双向的。增加好友以后，即可在我的好友列表中查到好友令牌，使用好友令牌调用发送消息接口来发消息。
- 收到的消息上会显示这条消息是“好友消息”，如果好友授权了微信昵称，同时也会展示出发送方的维系昵称。
发送消息的方式
一. 使用API调用
推荐优先使用官方 pushplus SDK，而不是自行编写 HTTP 请求代码。SDK 已封装发送频率控制、开放接口令牌、回调等常见场景，可降低开发成本和出错概率。
请求参数中增加了一个to参数，填写好友令牌。to参数中可填写多个好友令牌，使用逗号隔开。
API调用示例
- 请求地址：https://www.pushplus.plus/send
- 请求方式：POST
- 请求内容：
{
"token":"{token}",
"title":"标题",
"content":"消息内容",
"to":"5813c18bb0fa462789028312dae30224",
"template":"html"
}
二. 使用邮件推送
也可以不调用接口，直接向专属邮箱发送邮件来触发好友消息推送。收件人固定为 token 邮箱，好友令牌填写在抄送中（支持多个，好友令牌为 32 位）：
收件人：{token}@yp9.cn
抄送：{好友令牌}@yp9.cn
例如好友令牌为 5813c18bb0fa462789028312dae30224 时，抄送填写 5813c18bb0fa462789028312dae30224@yp9.cn。将 {token} 替换为你的用户令牌或消息令牌。邮件主题对应消息标题，邮件正文对应消息内容，发送渠道使用该令牌的默认渠道。更多说明见 邮件推送使用说明。
一些限制说明
- 目前好友实名用户最多添加1000人，会员用户最多可添加2万人，超过后请删除好友后再增加新的好友。
- 一次请求to参数中实名用户最多可填写10个好友令牌，会员用户可填写100个好友令牌。超出部分会被截取忽略。
- 使用企业微信渠道，好友令牌请填写企业微信中的用户账号，在企业微信通讯录中查看。
- webhook渠道不支持好友消息，接收人是在webhook配置中决定的。
- 好友消息和一对多消息不能共用，如果在发送消息接口传了topic参数和to参数，会优先使用一对多消息。
- 使用邮件推送时，抄送中可同时填写群组编码与好友令牌；系统会分成一对多、好友两组并分别推送。