构建集成

移动端聊天 SDK

为你面向客户的 iOS、Android 或 React Native 应用添加 Sonny 客服聊天。客户可以在你的应用内联系你的团队，使用的正是你现有的 Sonny 收件箱。

在找客服团队用来回复的应用？安装 Sonny 客服应用。

选择你的 SDK

连接你的应用

  1. 在已启用移动端的 Sonny 环境中，打开渠道 → 在线聊天 → 移动应用。由所有者或管理员为每个平台及 Bundle ID 或应用 ID 创建一个应用密钥。
  2. 按照仓库 README 安装 SDK。使用你的站点 ID 和该构建目标的公开应用密钥进行配置。React Native 需要分别使用 iOS 和 Android 的应用密钥。
  3. 以全屏对话的形式显示聊天，或将其嵌入你的应用中。同一时间只保留一个活动的聊天视图。
  4. 对于已登录的客户，在你的服务器上创建身份 JWT 并传给 SDK。退出登录时调用 reset() 以开始新的访客会话。

应用密钥是公开的标识符。身份签名密钥和通知服务商密钥始终保存在你的服务器上或 Sonny 受保护的设置中。

推送通知

通知权限和令牌获取由你的应用负责。SDK 在 iOS 上接受 APNs 令牌，在 Android 上接受 FCM 令牌，并处理 Sonny 通知的点击。投递需要你自己应用的凭据：APNs 签名密钥及 Apple 团队/密钥 ID，或你 Firebase 项目的 FCM 服务账号。Sonny 客服应用的凭据属于另一个应用。在本预览期间，推送投递仍在验证中。

  1. 在移动应用中上传你应用的服务商凭据。对于 APNs，请让沙盒或生产环境与你的构建相匹配。
  2. 打开应用，允许通知，并把令牌传给 SDK。刷新设置中的设备列表，按注册时间选择你的测试设备。
  3. 把应用切到后台，然后选择发送测试推送。检查设备是否收到。设置中的状态会显示服务商是否已接受或一个安全的错误代码；仅被接受并不代表已送达。
  4. 测试对话时，在访客断开连接的情况下发送一条客服或 AI 回复。当你的应用把点击转发给 handlePush 时，回复通知会打开对应的对话。通用测试通知不会打开对话。

报告问题或参与贡献

在你所用 SDK 的仓库中提交 issue。请注明其版本或提交、你的操作系统和框架版本，以及一个简短的复现示例。每个仓库都接受 Pull Request，并包含贡献和安全问题报告指南。请勿在公开 issue 中包含客户数据、身份 JWT、设备令牌和私钥。

相关文档