开发与集成

美洽有开放 API 吗?能和我们自己的 CRM/订单系统对接吗?

有开放 API:会话、客户、工单等数据都能读写,和自己 CRM/订单系统对接是标准用法。

API 能做什么

和自有系统对接:API 与回调你的业务系统CRM / 订单API 调用Webhook 回调美洽开放接口客户 / 会话 / 工单美洽工作台常见用法:进对话前把订单/会员信息推给客服;会话或工单状态变化回调你的系统,双向不脱节。
图:开放接口对接:通过 API 把订单/会员信息带进会话,通过 Webhook 把会话/工单变化回调业务系统

美洽开放平台提供 RESTful 风格的 API,常见能力包括:查询/导出会话记录、读写客户资料、创建和更新工单、获取坐席状态、推送消息等。接口清单、请求格式、字段说明以官方开发文档为准。API 能力一般需要专业版及以上套餐。

和自己系统对接的典型场景

  • CRM 对接:客服接待界面直接显示你们 CRM 里的客户等级、消费记录。
  • 订单查询:客户报订单号,客服一键(或自动)查到订单状态发过去。
  • 数据同步:每天把会话和客户数据同步进自己的数据仓库做分析。
  • 业务触发:你们系统里订单发货异常,自动在美洽建工单让客服跟进。

对接步骤

  1. 后台「设置-开放平台/API」创建应用,拿 AppKey/Secret 这类凭证。
  2. 按文档用凭证换访问令牌(注意令牌有效期和刷新逻辑)。
  3. 技术同学按文档调接口,先在测试环境跑通再上线。
  4. 控制调用频率,触发限流会返回错误,做好重试和降级。
凭证保密AppSecret 等同于账号密码,只能放服务端,千万别写进前端代码或小程序里。
← 返回全部问题

美洽 实际界面截图

美洽下载