为什么订单来了，App却毫无动静？
先想象两个场景：午高峰订单一个接着一个，骑手却把App挂在后台跑别的，没听到新单提醒，回头一看抢单大厅早被抢空了；顾客催单的电话打过来，商家才发现二十分钟前有一单根本没人处理。这两个场景的共同病根，十有八九是推送通知没有配置好。
海狐外卖系统的商户端App和骑手端App，都通过DCloud的UniPush服务下发消息提醒。配置完成后，新订单、催单、退款等关键事件会实时推送到手机通知栏，即使App不在前台也能第一时间收到。本文将手把手带您完成从DCloud后台到海狐系统后台的完整配置流程。
开始之前：先分清您用的是哪种App
海狐外卖系统支持两种形态的商户端/骑手端App，配置方式略有不同：
- 通用版App：直接使用海狐官方打包的「靠谱商家助手」（商户端）和「Delivery配送助手」（骑手端），无需自己申请和打包，使用官方默认推送参数即可。
- 自有品牌App：为您的平台定制开发、独立打包的App，需要在DCloud开发者后台创建自己的应用并获取专属推送参数。
下面以自有品牌App的完整配置流程为主线讲解，通用版App的用户可以直接跳到「通用版App参数说明」一节。
第一步：登录DCloud开发者后台
- 打开DCloud开发者后台：https://dev.dcloud.net.cn/
- 使用注册好的DCloud账号登录（如还没有账号，需先完成注册和开发者认证）。
- 进入「我的应用」，找到您为商户端或骑手端创建的应用，点击进入应用详情页。
[图片说明：DCloud开发者后台「我的应用」列表页]
第二步：核对应用各平台信息
在应用详情中，检查Android、iOS等各平台的信息是否与实际打包发布的一致，重点核对应用包名（PackageName）。
这一步非常关键：包名一旦和实际安装到用户手机上的App不一致，推送服务就找不到目标应用，后面所有配置都是白搭。如果近期改过包名或重新打包过，务必在这里同步更新。
第三步：开通并配置UniPush
- 在应用详情页找到UniPush（DCloud联合个推提供的推送服务），点击开通。
- 按页面指引填写各平台（Android / iOS）的应用信息并提交审核。
- 开通成功后，进入UniPush的配置页面，确认推送通道状态为已启用。
[图片说明：应用详情页UniPush开通入口]
第四步：获取UniPush参数
点击「应用配置」，在参数区域可以看到配置推送所需的四项关键信息，请逐一记录：
- AppID：应用的标识
- AppKey：应用密钥
- MasterSecret：服务端密钥（注意保密，仅用于服务器端接口调用，切勿泄露或写进客户端代码）
- PackageName：应用包名
其中MasterSecret权限最高，拿到它就可以向您的全部App用户群发推送消息，请像保管支付密码一样保管它。
第五步：在海狐外卖系统后台填写参数
- 登录海狐外卖系统总后台，找到推送通知（UniPush）相关的参数配置项。
- 商户端和骑手端是两组独立的参数，需要分别填写，注意不要填反——填反的表现通常是商户收不到提醒、骑手端却能收到测试推送。
- 将上一步获取的AppID、AppKey、MasterSecret、包名逐项填入对应位置，保存。
- 保存后建议立即发起一次测试推送，分别在商户端和骑手端确认能否正常收到，再投入正式使用。
通用版App参数说明
如果您直接使用海狐官方通用版App，无需自己注册DCloud应用，按以下默认参数配置即可：
骑手端（Delivery配送助手）
- 个推AppID：
aumlbRGbyX8qD4QmestXr3 - 个推AppKey：
xn4H22sS7O9pM4yExtXjS2 - 个推包名：
com.seafox.delivery - MasterSecret：属于服务端密钥，请通过海狐科技售后渠道获取，请勿公开传播
商户端（靠谱商家助手）
- 个推AppID：
pct0S5PuKm6IpTogf6ukp2 - 个推AppKey：
RhfMyPHIKhANSYxYIa1eh4 - 个推包名：
com.seafox.shop - MasterSecret：属于服务端密钥，请通过海狐科技售后渠道获取，请勿公开传播
AppID和AppKey是跟随App客户端分发的公开参数，MasterSecret则不同——它相当于推送服务的”总钥匙”，任何拿到它的人都能向您的所有用户推送消息，所以务必妥善保管。
常见问题（FAQ）
Q1：参数都填了，为什么App还是收不到推送？
按以下顺序排查：
- 核对包名是否与DCloud后台、实际安装的App完全一致；
- 检查AppID、AppKey、MasterSecret是否有输入错误（特别注意大小写和首尾空格）；
- 确认手机系统设置中已允许该App的通知权限，且未被省电策略限制后台运行（可参考我们的安卓后台权限设置教程）；
- 用后台的测试推送功能单独验证一次，判断是配置问题还是手机端问题。
Q2：提示Token获取失败或”应用未授权”是怎么回事？
通常是UniPush服务未正常开通，或应用信息审核未通过。请回到DCloud后台确认UniPush状态为「已开通」，并检查各平台信息是否已提交审核并通过。
Q3：Android能收到，iPhone收不到，怎么解决？
iOS的推送走的是苹果APNs通道，需要单独在UniPush后台上传iOS推送证书（p12或p8格式）并保证证书未过期。请检查iOS证书配置，证书过期后推送会静默失败。
Q4：自有品牌App和通用版App的参数可以混用吗？
不可以。每个DCloud应用的参数都是独立的，混用会导致推送全部失败。请严格按您实际使用的App形态填写对应参数。
Q5：不小心把MasterSecret泄露给别人了怎么办？
请立即登录DCloud开发者后台重置MasterSecret，并同步在海狐系统后台更新为新值。重置后旧密钥即刻失效，可将影响降到最低。
相关功能推荐
推送通知配好后，建议顺手完成这两项设置，让接单出餐链路全程自动化：
- 商户门店设置：如何设置自动打印、自动接单、自动通知配送——订单从下单到打印、通知配送一气呵成，高峰期少出错
- 安卓手机无障碍权限与后台设置——确保App在后台常驻，语音播报和推送双双在线