通道使用说明
提示
通道使用说明
# 推送通道和组合通道
推送通道是【一封传话】的最小原子单位, 可以用来设置各个具体推送配置(例如企业微信webhook、钉钉、飞书webhook配置), 而组合通道只是一个用来装推送通道的盒子，这样调用一次组合通道就会自动将里面所有推送通道都调用一遍了。例如创建一个微信+钉钉的组合通道A后, 生成了通道码: af9882daf802c7e21c7648f1b9475683
通过推送API推送消息, 微信和钉钉将会同时收到消息, 后续如果还需要增加邮件通道, 无需修改任何代码, 只需创建好邮件通道, 并将"父通道"设置为组合通道A即可。
无论是推送通道还是组合通道, 您都可以创建很多个, 以满足您不同的业务类型。
# 口令提醒
口令提醒功能是【一封传话】是移动端高级特性, 本质上属于是带有预设参数的组合通道, “口令码”本质上等价于“组合通道码”, 并且增强了一些特性, 使得口令具备组合通道所有特性之外（现在电脑端也能看到提醒并修改、还能额外绑定其他通道）, 还具备以下特性:
- 支持定时提醒, 您可以在移动端预设按年、按月、按天、按小时、按分钟进行定时提醒, 无需您手动触发, 目前移动端提供了十几种预设提醒供您一键添加到“我的提醒”。
- 支持口令提醒, 口令码具备组合通道所有特性外, 还支持“仅提醒一次”高级功能, 通过API调用后提醒将自动停止, 移动端可以将head、body默认参数映射成其他软件传递的参数。
- 支持增强webhook推送完成后提醒, webhook推送通道可以帮您请求指定网址, 在移动端创建"调用url"提醒后, 可以帮您请求指定网址后再发送消息到您指定的消息推送通道, 特别适合自动签到业务。
- 电脑端可将通道升级为提醒，升级为提醒后成员可以在移动端查看、退出加入的提醒。注意，一旦升级为提醒后就不能回退到普通推送通道。
Tips: 增强特性有一点小代价, 会消耗掉额外的性能来支持新特性。如果没有使用到这些新特性, 在手机端创建完提醒后, 完全将/trigger/替换为/send/调用API也不会有任何问题哦, 这样send调用性能最佳, 执行速度最快。
已优化trigger, 性能接近于send, 两种API实测1000人+接口调用耗时均不超过500ms，可放心使用trigger接口。
# 从PC端通道升级到移动端口令
一封传话支持将PC端创建的推送通道(或者组合通道)升级为移动端的口令提醒，升级以后不仅可以使用高级特性，还可以在移动端进行管理成员列表。具体升级办法如下：
先登录电脑端官网，如果您要升级的通道是非组合通道，请先创建一个组合通道，并将待升级通道修改“父通道”指向组合通道；
然后在到移动端点击底部”新建+“创建一个口令提醒，然后刷新电脑端官网的通道管理页面，你会在”提醒管理“区域看到刚才移动端创建好的提醒；
在电脑端修改刚才新建的提醒，将“推送通道:”下拉框切换选中步骤1中的组合通道，点击“保存”按钮升级完毕。
升级后的历史成员都能在移动端”个人中心“——”我的提醒“——”我加入的“查看到当初扫码加入的提醒了，如果在移动端退出提醒，将会自动退出扫码加入的通道。
升级后，开发者可以通过移动端展示的trigger API实现高级推送特性。
# 组合通道的妙用
问: 既然我可以在移动端创建提醒的时候选择任意通道进行组合, 那么电脑端的通道管理又有啥用呢？
答：在移动端创建的提醒每种通道类型最多选择一个，而电脑端，即使是同一种推送通道(例如钉钉群机器人)可以绑定几十个, 然后指向同一个组合通道, 适合向几十个钉钉群同时推送公告的业务场景，只需推送一次系统会自动将消息分发到几十个子通道。
下面演示电脑端随意组合的原理，这里我们演示如何创建一个组合通道(微信推送)实现多通道推送，假设一个月后我们需要新增(邮件推送), 只需在电脑端绑定一下即可，完全不要修改代码。
# 点击新增推送按钮，创建一个“组合”类型的通道
# 点击“修改”按钮，修改一个我们以前的创建过的微信推送通道
# 将父通道切换为刚才新增加的组合通道后点击“保存”按钮
这时候，我们的微信推送通道就绑定到组合通道上了，我们不仅可以通过组合通道code进行微信推送，以前通过微信通道code依然有效哦。
# 接下来我们点击新增加好的组合通道的“详情”按钮
详情底部会展示这个组合通道下绑定的所有子通道列表，如果需要剔除某些子通道，复制子通道的通道code去消息推送首页找到后，将父通道设置为“请选择”保存即可。‘’
# 进入到组合通道的在线测试页面后, 点击“发送测试”按钮后，您的微信会收到推送哦
复制请求参数输入框里的网址，去浏览器上粘贴，同样会触发组合推送。
# 如果我们打开微信测试推送通道的详情页面，我们可以看到“最近消息记录”
推送内容：您的传递的body字符串; 响应内容：当时调用send、trigger的API返回的json字符串。
# 点开“推送内容”按钮查看不会将消息变更为已读
# 再回到推送通道页面，一个月后我们新增邮件推送通道
# 由于我的账号是微信扫码直接登录的，首次创建邮件通道会提示我绑定个人邮箱
# 点击”发送“按钮后，您输入的个人邮箱会收到一个6位数的验证码（如果没收到可能是进垃圾箱或者您直接联系客服）
# 复制验证码——粘贴——保存，这时再点击新增通道的”保存“按钮就创建好了
# 接下来点击”修改“按钮为刚才创建好的邮件通道指定父通道为”组合通道测试“，点击保存
# 后面打开组合通道详情验证的是否绑定成功，这里就不做套娃说明
Tips: 目前组合通道能绑定的子通道个数暂未做限制，与您能创建的总通道数量有关，如需提升上限请联系客服。