美洽怎么设置客服会话消息离线推送？

要在美洽设置客服会话消息的离线推送，先在美洽后台开启离线推送并配置推送模版，再在移动端接入美洽SDK并在平台上传各厂商推送凭证（如APNs、FCM或三方推送服务），必要时使用美洽的Webhook或消息推送API做自定义转发，最后通过测试设备校验权限、渠道与证书，常见问题包括证书错配、系统省电策略和权限被禁用。记录日志便于排查建议备份

先把概念讲清楚：离线推送到底在做什么？

简单来说，离线推送就是当用户不在会话界面或应用处于后台/被系统杀掉时，依然能把客服发来的消息通过操作系统的通知机制送达用户手机。这样可以保证重要消息不会被错过，提高响应率和转化。美洽本身负责消息的接收、路由和触发推送的逻辑，但要真正把通知推到用户设备上，需要把推送凭证和参数交给相应的推送通道（APNs / FCM / 各厂商推送）。

用一句话理解工作流

• 用户A向客服发消息 → 美洽服务端接收并存储 → 判定用户B离线 → 触发离线推送 → 通过预配置的推送通道把通知下发到用户设备。

为什么有时推送不到？先把常见坑记下

在动手之前，你可以先把下面这些“常见坑”放在心上，排查会更快：

• 证书/凭证配置错误：APNs 的证书/密钥、Android 的 FCM Server Key 或各厂商的 AppKey 配置不对会导致推送失败。
• Bundle/Package 不一致：上传到推送平台的包名或 Bundle ID 必须和应用一致。
• 权限被禁用：用户或系统关闭了通知权限、或被厂商的省电策略限制。
• Android 通知渠道问题：Android 8.0+ 必须建立通知渠道，否则通知可能不显示。
• Token/Device ID 失效：设备的 push token 过期或未正确上报给美洽。

在美洽后台如何一步步设置（实操指南）

下面按操作步骤把流程讲清楚，像自己在后台点界面那样一步一步走。

1）在美洽后台开启离线推送功能

• 登录美洽管理控制台。
• 找到“设置”/“消息设置”/“推送设置”之类的入口（不同版本位置可能略有差别）。
• 启用“离线推送”或“会话消息离线推送”开关，并选择默认推送模版（大多数场景推荐先使用默认模板测试）。
• 在模板中配置通知的 标题、正文、透传字段（会话 ID、客服 ID、未读数等），并设置语言/占位符。

2）在美洽后台上传推送凭证（应用和厂商信息）

这一项是关键——美洽要能代表你把通知交给推送厂商。通常你需要提供如下信息：

把这些凭证上传到美洽控制台对应的通道配置处。上传后，美洽会使用这些凭证把通知通过对应通道发送给设备。

3）移动端要接入美洽的 SDK 并上报设备信息

• 在 Android/iOS 应用中接入美洽的官方 SDK，确保 SDK 能在应用启动时拿到并上报设备的 push token（或厂商设备 ID）。
• 对于 Android：要向美洽上报 FCM token 或厂商 token；并在 AndroidManifest 里配置相关权限与服务。注意 Android 8.0+ 需建立通知渠道。
• 对于 iOS：上报 device token，并确保应用正确配置了 APNs 的证书或 Key，且在 Xcode 中打开了 Push Notification Capability 和 Background Modes（Remote notifications）。
• 对接第三方推送时，可能还需在客户端集成厂商 SDK（例如华为 Push、Xiaomi Push），并保证 SDK 在后台也能接收通知。

4）决定由美洽直接推送还是由你自己中转（Webhook/API）

美洽通常能直接把离线消息推送到用户设备，但有些团队出于合规、监控、或自定义业务需要，会选择用美洽的事件回调（Webhook）或消息 API 自行转发。两种方式各有优缺点：

• 美洽直推：配置简单、维护少；美洽负责推送策略与重试。
• 自建中转：更灵活可控（可以在推送前做过滤、个性化、埋点）；但增加维护成本，需要你自己管理推送凭证与重试逻辑。

测试流程（别跳过，这里是重点）

测试分成功能测试与场景测试，逐项核对：

• 功能测试：在控制台发送测试推送，确认设备能收到通知；检查通知标题/内容/自定义字段是否正确。
• 场景测试：关闭应用、锁屏、切换网络、切换到飞行模式再恢复、切换到低电量模式等，确认各种状态下推送稳定性。
• 日志验证：在美洽后台查看推送发送日志，必要时打开 SDK 的 debug 日志，记录 token 上报、推送请求、第三方返回结果。
• 用户体验：测试点击通知能否唤起会话页面并带上正确的会话上下文（conversation_id），防止开起后看不到消息。

常见问题与排查办法（思路导向）

• 推送下发失败：看美洽后台的推送发送日志，看第三方返回的错误码（如证书无效、token 无效）。
• 用户收不到通知但日志显示已发送：排查设备侧的通知权限、通知渠道是否被关闭、厂商省电策略、token 是否过期。
• iOS 仅在开发环境生效：检查 APNs 证书是否为生产版且与应用在 App Store 证书一致；注意 .p8 的 Key ID / Team ID 配置。
• Android 通知内容不对：确认美洽模版里的占位符被正确替换；确认透传字段键名和客户端解析一致。
• 厂商推送不稳定：建议同时上报多家推送通道（FCM + 厂商推送），并在服务器端或美洽控制台设置优先级与兜底逻辑。

高级话题：更细致的配置与优化建议

• 多通道合并策略：在不同厂商推送间做优先级，先尝试厂商推送（在部分机型更稳定），失败再 fallback 到 FCM。
• 通知分级与节流：对销售/运营类频繁消息，可设计合并策略（把短时间内的多条消息合并成一句摘要），避免骚扰。
• 深度链接与上下文：在推送的透传字段中包含 conversation_id、message_id、source 等，点击后直达会话并定位到具体消息。
• 本地化与多语言：根据用户偏好在推送模板中使用多语言占位符，避免拼接导致显示杂乱。
• 隐私与合规：通知内容避免敏感信息直显，必要时使用脱敏或只提示有新消息并要求用户打开 App 查看。

示例：一个典型的离线推送 Payload（参考）

下面是一个常见结构示例，供你和开发同学沟通设计时参考（具体键名以美洽文档或你们约定为准）。

{
  "to": "",
  "notification": {
    "title": "客服回复了你",
    "body": "客服小美：您好，我这边查到您的订单已发货",
    "click_action": "OPEN_CONVERSATION"
  },
  "data": {
    "conversation_id": "conv_123456",
    "message_id": "msg_654321",
    "sender": "agent_1001",
    "unread_count": 3,
    "source": "meiqia"
  }
}

排查清单（发给运维或开发前用）

• 美洽后台：离线推送开关已开启；模版已保存并处于可用状态。
• 凭证：APNs / FCM / 厂商推送凭证已上传，且与当前应用包一致。
• 客户端：美洽 SDK 已接入，设备 token 已上报到美洽。
• 系统设置：测试设备通知权限、通知渠道打开；查看是否有厂商省电或后台限制。
• 日志：美洽发送日志/第三方返回日志/客户端 debug 日志均正常。

如果你要更“稳”，可以做的额外事情

• 在应用内定期上报 token，后端校验并在发现 token 变化时及时更新美洽侧记录。
• 对关键的会话消息（退订、支付失败、紧急通知）采用短信或邮件作为兜底。
• 在后端保留推送失败的重试队列，并对常见返回码做分类处理（可立刻重试、延迟重试、人工干预）。
• 做统计与监控：推送送达率、打开率、用户受限设备占比等，帮助定位问题机型或策略调整。

写到这里，我自己也会想到，实际操作时最好先在测试环境把端到端链路走一遍：从客服发送消息、到美洽触发推送、第三方通道响应、最终设备收到并点击唤起会话。记录好每一步的日志和返回码，遇到问题按上面的清单逐项排查，通常能迅速找到并修复问题。希望这些步骤和提示能让你在美洽上把离线推送稳稳设置好，跑起来就能少出坑，多省心。