美洽开发者集成与二次开发怎么用？

企业已经有一套成熟的 CRM 或 ERP 系统，客服数据还在手动导出导入，效率低还容易出错。想深度定制客服工作台，增加企业专属的功能模块。希望将美洽的客服能力嵌入到自己的 App 或网站中。这些需求，都离不开美洽的 API 接口和 SDK 工具。美洽支持 API 接口接入，企业可以将美洽的客服系统与自身的业务系统进行无缝对接，提升工作效率，为用户提供更为流畅的体验。同时，美洽提供 iOS 和 Android 原生 SDK，开发者可在 30 分钟内完成移动端客服功能的集成。

美洽开放平台概述

开放平台的核心价值

美洽提供了丰富的开放能力，包括开放 API 接口、JS 代码拓展性、iframe 嵌入、服务数据双向同步等。美洽顾客中心可以接入企业顾客数据进行更新管理，对接主要通过接口方式，美洽在顾客对话接入的时候，主动去调用企业接口获取顾客信息更新至顾客中心。企业可以将美洽的客服系统与自身的业务系统进行无缝对接，这种对接不仅提升了工作效率，还能为用户提供更为流畅的体验。

集成场景一览

美洽 API 接口适用于多种业务场景：电商企业将美洽的客服系统与订单管理系统对接，实现订单状态的自动查询和客服的实时响应；SaaS 服务企业将客户服务与产品使用数据进行整合，提升客户满意度；金融机构实现快速的客户查询和服务的及时推送。美洽提供云端托管服务，也支持 API 集成与高级自定义部署，其企业级稳定性与良好的安全设计，是大中型企业客服系统首选方案。

美洽 SDK 版本

美洽提供 iOS 和 Android 原生 SDK，支持快速集成。iOS SDK 最新版本为 3.9.30（2026 年 3 月更新），Android SDK 最新版本为 4.1.8（2026 年 3 月更新）。SDK 支持自定义 UI、多语言设置、机器人消息富文本显示等功能。

API 对接：顾客名片 API 配置

配置步骤

美洽顾客中心可以接入企业顾客数据进行更新管理。企业需先在美洽工作台->设置->顾客管理->顾客名片 API 配置进行相关配置才可使用该功能。配置说明：URL 为企业对外的域名 url，需要美洽这边可以访问；AppID 为接口验证提供给美洽的 ID；AppSecret 为与 ID 对应的 Secret，用于验证；同步选项用于决定当两边都有字段数据时，以哪边的数据为准。

接口调用规范

美洽规定对接接口路径为 /get_client_info，即美洽会采用 POST {URL}/get_client_info 方式去企业拉取数据。请求示例：

json

POST http://meiqia.com/get_client_info{  “appid”: “meiqia”,  “appsecret”: “meiqia-test”,  “client_id”: “1”,  “tel”: “12345678”}

参数说明：appid、appsecret 为企业配置数据，主要用于企业对该接口访问的验证；client_id 为企业对于顾客的唯一标识；tel 为顾客的电话号码（仅在呼入电话时回传）。

接口应返回如下格式的数据：

json

{  “code”: 0,  “msg”: “error msg”,  “client_id”: “企业顾客id”,  “data”: [    {“key”: “name”, “value”: “meiqia”},    {“key”: “age”, “value”: “25”}  ]}

code 为 0 表示成功，data 数组包含用户详细信息。该接口不仅可以同步顾客名片已有字段的属性值，也可以进行新增属性的添加同步。对于新增字段，同步时会自动在顾客名片字段中新增相应字段并默认为显示，这里新增字段会受到顾客名片最多 50 个字段的限制。

iOS SDK 集成

集成步骤

iOS 开发者在美洽工作台的“应用与集成”中下载 iOS SDK，按照文档指引将 SDK 导入 Xcode 项目。SDK 支持 CocoaPods 和手动导入两种方式。集成完成后，应用内即可唤起客服会话窗口，用户无需跳转到外部浏览器即可发起咨询。

SDK 功能特性

iOS SDK 支持以下功能：自定义 UI 样式、设置当前语言（支持多语言）、优化底部功能按钮的自定义适配、优化机器人消息富文本图片显示、优化首条消息重复和关联消息显示等问题。支持设置多语言，满足出海企业的本地化需求。

版本信息

iOS SDK 最新版本为 3.9.30（2026 年 3 月 4 日更新），Android SDK 同步更新到 4.1.7。SDK 持续迭代，修复已知问题并优化体验。

Android SDK 集成

集成步骤

Android 开发者在美洽工作台下载 Android SDK，将 SDK 集成到 Android Studio 项目。SDK 支持 Gradle 自动依赖和手动导入两种方式。集成后，可在应用的任意页面添加客服入口按钮，用户点击后直接进入客服会话。

SDK 功能特性

Android SDK 支持更改 UI 样式、多语言设置、根据自定义 id 获取未读消息等功能。App 端支持将用户设备信息和应用版本传递给客服，支持传递自定义参数（如用户 ID、会员等级），客服可在工作台查看这些信息，提供更精准的服务。

版本信息

Android SDK 最新版本为 4.1.8（2026 年 3 月 25 日更新），iOS SDK 同步更新到 3.9.30。SDK 已迁移到 androidx，支持最新的 Android 开发环境。

网页插件快速接入

嵌入代码部署

美洽采用异步加载机制，最小化对页面性能的影响。在美洽注册后，你会获得一段专属代码，只需将此代码复制粘贴到网站技术人员即可完成接入。核心实现代码为动态加载美洽脚本，通过 _MEIQIA(‘entId’, YOUR_ENT_ID) 完成初始化。支持静态 HTML 网站、WordPress、Vue/React 等前端项目，以及 Shopify、Magento 等电商平台，最快只需 5 分钟即可完成接入。

自定义客服窗口样式

美洽支持自定义客服窗口的样式，包括窗口颜色、位置、按钮图标、欢迎语等。企业可以根据品牌 VI 调整客服窗口的外观，保持统一的品牌形象。美洽的网站插件和移动应用 SDK 支持丰富的外观和功能定制，只需点一下鼠标，就可以修改网站插件的颜色、样式和各种功能。

主动邀请功能配置

美洽的主动邀请功能可以根据访客行为（如浏览时间、页面停留深度）自动触发对话邀请，将被动等待转变为主动服务。在“主动邀请”设置中，可以配置触发条件（例如访客停留超过 30 秒、浏览特定页面、即将离开网站等），设置邀请话术和邀请频率，系统会自动执行。

集成后的核心应用场景

场景一：客服工作台自动弹屏客户画像

当客户发起咨询时，美洽自动调用 CRM 接口获取客户信息，在客服工作台右侧显示客户画像。客服无需询问“您买过什么产品”，直接基于完整信息提供服务。系统整合官网、App、小程序、微信、抖音等 20+ 渠道的客户对话数据，通过统一客户 ID 体系，确保多触点数据在 CRM 中完整呈现。

场景二：App 内客服嵌入

通过 iOS/Android SDK，企业可以将美洽客服功能直接嵌入到自己的 App 中。用户在 App 内遇到问题时，无需跳转到外部浏览器即可发起咨询。SDK 支持上传用户设备信息和应用版本，客服可快速了解用户的使用环境和遇到的问题。

场景三：企业微信集成

企业微信用户可以将美洽接入企业微信工作台，员工在企业微信内即可处理客户咨询，无需切换应用。美洽通过集成微信开放平台的 API 与微信进行对接，确保企业可以在美洽平台上直接管理微信客户服务。

场景四：AI 自动打标签同步到 CRM

美洽 AI 通过多轮对话自动识别客户的核心需求，并实时打上标签。这些标签自动同步到 CRM 系统中，为销售跟进提供精准的客户画像。所有对话数据实时同步至多维度看板，美洽 AI 会自动为客户打标签，生成“顾客印象”总结，为后续的精准营销提供数据支撑。

集成注意事项

安全性与权限控制

美洽 API 采用密钥认证机制，确保只有授权的应用可以调用接口。建议企业定期更换 API 密钥，避免密钥泄露。在调用 API 时，建议使用 HTTPS 协议，确保数据传输过程中的安全。API 调用使用 API Public Key 和 API Secret Key 进行签名验证，签名算法采用 HMAC-SHA1，确保请求的安全性和完整性。

错误处理与重试机制

API 调用过程中可能遇到网络超时、服务端异常等问题。开发者应在代码中实现错误处理和重试机制，确保系统的鲁棒性。美洽 API 返回标准的 HTTP 状态码和错误信息，便于开发者快速定位问题。

限流策略

为了防止滥用，美洽 API 有合理的限流策略。企业应根据实际业务量评估 API 调用频率，避免超出限制。如需更高调用配额，可联系美洽商务团队申请。

总结

美洽开发者集成与二次开发的完整流程可以概括为“API 对接、SDK 集成、网页嵌入”三步。API 对接：在工作台配置顾客名片 API（URL、AppID、AppSecret），接口路径为 /get_client_info，支持新增字段自动同步，最多 50 个字段；SDK 集成：iOS SDK 最新 3.9.30，Android SDK 最新 4.1.8，支持自定义 UI、多语言设置，30 分钟完成移动端集成；网页嵌入：复制嵌入代码 5 分钟完成部署，支持自定义客服窗口样式，主动邀请功能配置。美洽提供云端托管服务，也支持 API 集成与高级自定义部署，其企业级稳定性与良好的安全设计，是大中型企业客服系统首选方案。通过 API 开放平台，企业可以将美洽的客服能力无缝嵌入到自身的业务体系中，实现真正的“客服即服务”。