SDK 接入的基本流程
- 后台「渠道接入-App」创建应用,拿到 AppKey/AppID 这类凭证。
- 按官方开发文档把 SDK 集成进 App:iOS 一般用 CocoaPods 或手动拖入,Android 用 Gradle 依赖或 AAR 包。
- 初始化 SDK(填入凭证),在「联系客服」按钮处调起会话界面。
- 发条测试消息,确认工作台能收到、能正常对话。
具体类名、方法名、版本要求以美洽官方开发文档为准,SDK 会持续更新,别照抄网上旧教程。
集成时值得用上的能力
- 传用户信息:把 App 里的用户 ID、昵称、会员等级传给客服,接待时一眼看到是谁。
- 未读消息数:SDK 提供未读数回调,可以在 App 里显示小红点。
- 自定义界面:配色、头像、入口样式一般都能改,和 App 风格统一。
常见集成问题
- 初始化失败:检查凭证有没有复制错、包名/Bundle ID 和后台配置是否一致。
- Android 收不到消息:查厂商推送通道配置和网络权限。
- iOS 审核:对话功能属常规客服能力,正常过审;注意别在审核期间关着工作时间导致审核员看到留言页误判功能不可用。
