美洽怎么设置客服消息推送？

在美洽，先在管理后台“设置→消息与通知”开启推送并选择渠道（浏览器、移动推送、邮件、短信、微信模板等），为各渠道填写凭证与模板，配置触发事件（新消息、分配、未读、离线）与路由，移动端需在 SDK 配置厂商推送并上传证书/密钥，公众号需绑定并填写模板 ID。完成后用控制台测试并检查日志，注意权限、证书与厂商限制。

先把整体流程说清楚：像搭个邮差系统

想象你要把信送到用户手里，首先要决定“信用哪种交通工具”——微信、短信、手机推送或浏览器提示；接着要准备“车票”——也就是各种厂商的密钥和证书；然后约定“什么时候送信”——触发规则，比如有新消息就送或客服分配时送；最后你得做“送信测试”和监控，确认信到人手里。美洽的消息推送其实就是这么一套：选择渠道、填写凭证、设定触发与路由、在客户端/SDK做配合、测试与监控。

美洽支持哪些推送方式？（先列清单）

• 浏览器推送：PC/移动浏览器的通知。
• 移动端推送：通过厂商推送（如腾讯云、华为、JPush、苹果 APNs/FCM 等）的通知，推送到客服 App / 客户设备。
• 微信公众号/小程序模板消息：给关注用户或小程序用户发送模板消息。
• 邮件通知：通过 SMTP 发送的邮件提醒。
• 短信通知：通过短信服务商的 API 发送短消息。
• Webhook / 第三方回调：把事件推给你自己的服务，再由你来负责二次推送。

在管理后台一步步配置（管理员视角）

1）进入消息推送设置

登录美洽管理后台，通常在“设置”或“系统管理”下找到“消息与通知”或“消息推送”。这里是总开关的地方：先确认要开启哪几种渠道，然后逐项配置凭证和模板。

2）为每个渠道填写凭证/密钥

不同渠道需要不同信息：

• 浏览器推送：通常需要 Service Worker 的配置，且需要在控制台启用 Web Push 并填写公钥（VAPID）等信息。
• 移动推送（Android/iOS）：填写第三方推送服务的 AppKey/AppSecret，或上传苹果的 APNs 证书 (.p12)，以及 Android 侧需要的 FCM/厂商推送配置。
• 微信公众号/小程序：需要绑定公众号/小程序并填写 AppID、AppSecret、模板 ID，以及获取用户 openid 的流程说明。
• 邮件：填写 SMTP 地址、端口、用户名、密码或专用授权码。
• 短信：填写短信服务商（阿里云/腾讯云/其它）的 API Key、Secret 和签名等。
• Webhook：填写目标 URL，并选择鉴权方式（签名/Token/HTTPS）。

3）配置触发规则与路由

推送并不是“所有事情都推一次”，你要定规则，例如：

• 新会话到达时给在线客服推送
• 用户离线发消息时给管理员/邮箱发离线告警
• 会话长时间未响应时发送未读提醒
• 会话被分配或转接时推送目标客服

这些规则在美洽后台通常以“触发事件”或“通知规则”的形式存在，你可以设置条件（技能组、标签、优先级）和目标（某个客服、全部在线、某个技能组）。记得设置节流策略，比如同一用户的相似事件不要在短时间内重复推太多条。

4）编辑推送模板

推送通常需要模板来控制标题、正文和跳转参数。模板里会用占位符（如{{user_name}}、{{content}}、{{session_id}}）。编辑时注意：

• 模板变量要与系统提供的变量一致
• 区分不同渠道的长度限制（短信短、微信模板有字段限制）
• 为移动推送加入 click_action 或自定义数据，便于用户点击后打开会话

客户端与 SDK 层面的配合（开发者视角）

Web（浏览器）端要做的事

• 在页面注册 Service Worker 并在后台允许接收 Push（使用 VAPID 公钥等）。
• 用户首次访问时请求通知权限：Notification.requestPermission()。
• 处理推送消息并实现点击行为（比如打开或聚焦到对应会话页面）。
• 测试时打开浏览器控制台的 Service Worker/Push 调试窗口，观察 payload。

移动端（App / 小程序）要做的事

移动端推送往往是最容易出问题的地方，所以要把几个关键点落实好：

• 获取并上报设备 token：App 启动时从厂商 SDK（FCM、APNs、JPush 等）拿到 token 或 deviceId，并上报给美洽或自己的服务器。
• 在美洽后台上传证书/密钥：比如 iOS 的 .p12/推送证书，Android 的 API Key / FCM Server Key，或第三方厂商的 AppKey。
• 处理点击回调：推送消息里带上会话 id，App 点击后打开对应会话或跳转到客服页。
• 注意系统设置：安卓厂商（小米、华为、OPPO 等）有后台限制，需要在 App 做适配或提醒用户在系统设置中允许自启动/省电白名单。

微信公众号 / 小程序的注意点

微信的模板消息需要：

• 用户必须有对应的权限（关注公众号或触发小程序 formId）。
• 填写正确的模板 ID、跳转页面路径和数据字段。
• 注意模板消息的频次限制和字段文字长度。

测试与调试：要像验车一样仔细

配置完别急着上线，按下面顺序测试：

• 控制台内置的“发送测试”或“发送预览”功能（如果有），分别针对每个渠道试发。
• 真实设备测试：不同 Android 厂商、iOS 真机、不同浏览器都要试。
• 查看美洽后台的推送日志，确认第三方返回的状态码（如 APNs/FCM 的回执、短信平台的回执）。
• 在 App 端打印接收到的 payload，确认字段和跳转逻辑正确。
• 对失败的回执做分析：证书错误、token 失效、配额超限、权限被拒绝。

常见问题与解决方法（经验贴）

• 浏览器不弹通知：检查 Notification 权限是否被拒绝；Service Worker 是否注册成功；VAPID 公钥是否正确。
• iOS 没有声音或没有通知：检查 APNs 证书是否过期，推送 payload 是否包含必要字段（alert、sound、badge）。
• Android 推送延迟或丢失：厂商省电策略、应用被杀死、token 失效；建议使用厂商推送并提示用户白名单设置。
• 微信模板不下发：检查模板 ID、用户是否关注、字段是否合规、是否超过频率限制。
• 邮件或短信没到：检查 SMTP/短信服务商返回的错误信息、签名和模板是否通过审核。
• 推送太频繁导致用户骚扰：在规则里加入节流、合并通知或只发送摘要。

推送事件到渠道的示例映射（给你参考怎么设计规则）

运维与监控：把“送信人”的健康监测好

推送系统要监控三类数据：

• 成功率：三天/七天的到达率，按渠道分。
• 失败原因分布：证书错误、token 失效、权限被拒、厂商返回限流等。
• 用户反馈：是否存在被投诉或退订的情况。

美洽后台通常提供日志和回执，你也可以把 Webhook 接入自建监控，用 Prometheus/ELK 类工具做二次分析。

合规与用户体验（别踩这几坑）

• 获取用户同意：在发送营销类或非常频繁的消息前，先做显式同意与退订入口。
• 控制频率：对同一用户同类型推送做节流、合并或摘要化处理。
• 隐私保护：不要在推送标题里泄露敏感信息（如账号、部分身份证号、详细订单信息等）。
• 本地化：根据用户语言/时区调整文案与发送时间，避免夜间骚扰。

一些具体的排查小技巧

• 看日志先看“状态码+错误描述”，APNs 常见是证书、token、payload 太大；FCM 常见的是 401/403。
• 如果推送在某个平台稳定失败，尝试用厂商自带的调试工具发消息，看返回是否一致。
• Android 厂商定制系统问题，先在该机型上做白名单/自启动/通知栏权限测试。
• 短信/邮件被拦截，先确认签名/发信 IP/域名是否被列入黑名单。

实战建议（容易被忽略的细节）

• 给推送加上业务上下文：比单纯“你有新消息”更好，例如“订单12345 有新回复，点击查看”。
• 为不同级别的事件设不同渠道：紧急问题用短信+APP 推送，普通提醒用邮箱或应用内角标。
• 做好回落策略：例如用户未收到 APP 推送，再发邮件或微信模板作为补偿。
• 推送测试用例化：把测试步骤写成检查单，定期跑，避免配置被改坏后无人察觉。

一个典型的上线流程（给你参照）

• 在测试环境完成所有渠道的凭证配置并通过测试推送。
• 开发在 SDK 层实现 token 上报与点击跳转的处理逻辑。
• 在生产后台上线规则并先做小范围内测（灰度）。
• 监控接收率和错误率，收集用户反馈，调整节流与文案。
• 正式放量后继续观察并把数据落盘以备审计。

常见术语小词典（快速理解用）

• Token / DeviceId：设备的唯一标识，用于推送目标定位。
• APNs / FCM：苹果和谷歌的推送服务，Android 上厂商会有自己的通道。
• 模板 ID：微信/短信/邮件用的模板编号，决定可填字段与样式。
• 节流（Throttling）：限制单位时间内同一用户或同一事件的推送次数。

说了这么多，嗯，我想到的关键点都放进来了：后台先开关渠道并填凭证，编辑模板并设触发和路由，客户端把 token 上报并处理点击，最后做详尽测试与监控。推送看着简单，其实每条消息都牵涉到权限、证书、厂商限制和用户体验，细心做就能把“被打扰”和“及时响应”之间找出平衡。关于具体界面那个按钮在哪儿、字段名是什么，你在后台设置页按提示一步步填就是了，遇到具体错误代码再来问我，我们可以按错误逐条拆解。