美洽全渠道集成与 API 开发指南？

企业客服系统的部署，往往卡在渠道接入这一步。网站要嵌入代码，App 要集成 SDK，CRM 要对接 API……每个渠道都有不同的技术方案，开发团队常常为此焦头烂额。美洽提供了一套完整的开发者工具链，支持网站代码嵌入、移动端 SDK 集成、API 接口对接，最快 5 分钟即可完成全渠道部署。

全渠道接入能力概览

支持的渠道类型

美洽支持网站、APP、微信公众号、微信小程序、微博、QQ、小红书、WhatsApp 等 20 多个主流平台的一键接入，所有渠道消息汇聚到统一工作台管理。运营人员无需在多个 App 间切换，通过统一工作台即可聚合回复所有消息。美洽的全渠道接入功能，是企业实现统一客户管理和高效服务的核心模块，通过将网站、App、微信公众号、微信小程序、微博及其他第三方社交平台统一接入一个后台，企业客服可以在同一工作台处理所有渠道的客户咨询，实现消息集中、管理便捷、服务高效。

全渠道接入的核心特点

多渠道统一管理，网站、App、微信公众号、小程序、微博及第三方社交媒体平台消息在后台统一显示；自动消息聚合，不同渠道的客户消息自动聚合，坐席无需切换平台即可响应；客户标签与分组，可根据来源、行为或咨询内容为客户打标签，实现分组管理与精准营销；渠道统计与分析，提供各渠道客户数量、咨询量及响应效率统计报表，便于优化资源分配。

网站接入：5 分钟完成部署

代码嵌入步骤

在美洽后台选择“渠道管理”模块，点击“添加网站渠道”。填写网站名称、URL 及所需接入页面信息，系统生成客服嵌入代码。将生成的 JavaScript 代码插入网站源代码，设置客服窗口显示位置、样式及欢迎语。可设置自动弹窗规则，例如访问首页停留时间超过 5 秒自动弹出聊天窗口，引导客户咨询。美洽采用异步加载机制，最小化对页面性能的影响，在美洽注册后，你会获得一段专属代码，只需将此代码复制粘贴到网站技术人员即可完成接入。核心实现代码为动态加载美洽脚本，通过 _MEIQIA(‘entId’, YOUR_ENT_ID) 完成初始化。支持静态 HTML 网站、WordPress、Vue/React 等前端项目，以及 Shopify、Magento 等电商平台，最快只需 5 分钟即可完成接入。

窗口样式与功能配置

可设置聊天窗口的主题颜色、图标、欢迎语及快捷回复按钮。不同渠道消息可设置优先级，例如网站咨询为高优先级，社交媒体消息为普通优先级。系统可按部门、坐席技能或客户类型自动分配消息，确保问题快速落地。支持同一客户消息由多坐席同时处理，坐席可在后台查看协作历史与备注，提高协作效率。

App 端 SDK 集成

iOS SDK 集成

美洽为 iOS 应用提供了完整的 SDK 集成方案。iOS 开发者在美洽工作台的“应用与集成”中下载 iOS SDK，按照文档指引将 SDK 导入 Xcode 项目。SDK 支持 CocoaPods 和手动导入两种方式。集成完成后，应用内即可唤起客服会话窗口，用户无需跳转到外部浏览器即可发起咨询。美洽提供 iOS 和 Android 原生 SDK，开发者可在 30 分钟内完成移动端客服功能的集成。在美洽后台选择“添加 App 渠道”，输入应用包名或 App ID 完成绑定，下载并集成美洽提供的 SDK 到 App 客户端，确保聊天功能与 App 功能兼容，可自定义消息推送设置、界面风格及快捷回复按钮，提供一致的用户体验。

Android SDK 集成

Android 开发者在美洽工作台下载 Android SDK，将 SDK 集成到 Android Studio 项目。SDK 支持 Gradle 自动依赖和手动导入两种方式。集成后，可在应用的任意页面添加客服入口按钮，用户点击后直接进入客服会话。美洽 SDK 提供了多种 API 供开发者调用，实现客户在线咨询、留言、投诉等功能。使用管理员权限账号登陆美洽，在 设置 –> SDK 页面中，选择添加 App 配置，根据提示配置 App 信息，然后添加 APP 即可得到 appkey 用于配置。

SDK 功能特性

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

微信公众号与小程序接入

授权绑定

在渠道管理模块选择“添加公众号/小程序”，使用企业公众号管理员账号授权绑定。授权后系统可同步公众号菜单、粉丝信息及消息数据。支持设置自动回复、关键词回复及消息转人工客服规则。可按粉丝标签分组，例如新用户、VIP 客户或活动参与者，实现精准服务和营销。美洽通过集成微信开放平台的 API 与微信进行对接，确保企业可以在美洽平台上直接管理微信客户服务。

多渠道统一管理

对于教育咨询行业常见的“评论区获客”，美洽 AI 员工能实现全天候秒回，并自动发放留资卡，合规且高效。一个工作台即可聚合抖音、小红书、微信等全渠道消息，来源可追溯，转化更精准，团队协同效率大幅提升。美洽还支持与海外主流社交平台如 WhatsApp、Facebook Messenger、Instagram、Line、Telegram 等无缝对接，实现全渠道客服服务，满足全球客户的需求。

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 个字段的限制。

第三方工单系统对接

API 密钥获取与签名验证

在美洽的管理后台，进入“API 设置”页面，您可以生成一个新的 API 密钥。请妥善保存该密钥，避免泄露。您也需要在第三方工单系统中进行相应的设置，以确保两者能够正常通信。API 调用使用 API Public Key 和 API Secret Key 进行签名验证，签名算法采用 HMAC-SHA1，确保请求的安全性和完整性。

集成后的数据闭环

当客服创建工单时，系统自动将工单信息同步到 CRM，实现问题处理的全程追踪。工单流转到对应部门后，处理进度实时反馈，客户满意度可提升 30% 以上。通话中未解决的问题可一键创建工单，自动填充客户信息和通话摘要，工单流转到对应部门处理，形成完整服务闭环。在美洽的场景中，API 接口的引入使得企业能够将美洽的客服系统与自身的业务系统进行无缝对接，这种对接不仅提升了工作效率，还能为用户提供更为流畅的体验。

集成后的核心应用场景

客服工作台自动弹屏

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

AI 自动打标签同步

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

总结

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