七鱼云客服CRM对接指南 · GitBook

七鱼云客服CRM桥基指挥的

简介

概述

七鱼云客服零碎可以跟随作伴 CRM 零碎停止桥基。

桥基分轻量级的桥基桥基使联系两种办法。

  • 轻量级的桥基这蠲经过 Web / iOS / Android SDK 开端逆命题,将访客的物作为决定因素去世给七鱼云客服零碎。
  • 桥基使联系是指作伴供给物圆形的的 HTTP 使联系,由七鱼云客服零碎转会,获取访客的相互相干物,并能了解录音同时在的、地位较高的访客ID试验效能。

轻量级的桥基的录音由作伴合意的人客户端(或网站)将录音使求助于给七鱼云客服零碎,录音将显示在如今问答题和客户维修服务经过。。桥基使联系的录音由作伴接合供给物,由七鱼云客服零碎客服端转会,录音将显示在片刻物的贴标签于。

轻量级的桥基和桥基使联系的片刻阐明,请地区显示轻量 CRM 桥基 CRM 桥基使联系章节。两桥基榜样的比得上,请显示与称呼委任桥基榜样比得上章节。

文档商定

访客:是指作伴合意的人用户用功。,诸如,作伴用功 App 合意的人用户,或提问网站或作伴 Web 合意的人用户。

作伴接合:指桥基使联系办法下,作伴供给物给七鱼云客服零碎的 HTTP 使联系。

客户维修服务站客户维修服务接合:都是指七鱼云客服零碎供给物给客服用功的任务使处于某种假定的经济状况之下,即客服登录七鱼云客服零碎后用功的 Web 接合。

Web SDK:指七鱼云客服零碎供给物的 Web 端功绩器,供作伴将七鱼云客服效能嵌入到官网或 Web 合意的人中。首要包孕在线提问 JS 寄给报社。

iOS SDK:指七鱼云客服零碎供给物的 iOS 平台功绩器包,供作伴将七鱼云客服效能嵌入到 iOS 合意的人中。首要包括一体 .a 动态库,和圆形的求助于的头寄给报社、资源寄给报社。

Android SDK:指七鱼云客服零碎供给物的 Android 平台功绩器包,供作伴将七鱼云客服效能嵌入到 Android 合意的人中。首要包括一体以上所述的 .jar 包,和圆形的相互相干的资源寄给报社。

JSON:作伴 CRM 零碎与七鱼云客服零碎桥基,用功录音播送 JSON 体式。在大多数经济状况下,录音被往事在一体阻碍,对一体录音项的表现阻碍元素。录音项包括的接,有些是本质的的,有些是可选的,请小心显示每个使联系的录音限度局限。使发誓人:JSON引见、JSON在线反省器。

轻量 CRM 桥基

轻量 CRM 桥基这蠲经过 Web / iOS / Android SDK 开端逆命题,可以将访客的物作为决定因素去世给七鱼云客服零碎。

Web SDK 转会

转会()时,将包括用户物 JSON 去世给七鱼云客服零碎。

({
    "uid":"zhangsan",
    "data":JSON.stringify([
        {"key":"real_name", "value":"恶霸"},
        {"key":"mobile_phone", "hidden":true},
        {"key":"email", "value":[email protected]},
        {"index":0, "key":"account", "label":"账号", "value":"zhangsan" , "href":""},
        {"index":1, "key":"sex", "label":"性特征", "value":"有度地位的人"},
        {"index":5, "key":"reg_date", "label":"对齐日期", "value":"2015-11-16"},
        {"index":6, "key":"last_login", "label":前番登录时期, "value":"2015-12-22 15:38:54"}
    ])
});

坚持到底:data情节的接的需求()停止序列化。为了保持健康良好的通用性,若要伴奏较低版本的浏览图书报刊者(如IE8及更低版本)则需引入第三方JSON库,如 JSON3。

iOS SDK 转会

创办一体QYUserInfo包围,将包括用户物 JSON 串补。转会setUserInfo当将这QYUserInfo包围作为决定因素去世给七鱼云客服 SDK。

QYUserInfo *userInfo = [[QYUserInfo 分派] 设定初值]
userInfo.userId = @"uid";
userInfo.data = @"[{\"key\":\"real_name\", 花费:粗鲁的人},""{\"key\":\"mobile_phone\", \"hidden\":true},""{\"key\":\"email\", 花费:[email protected]},""{\"index\":0, \"key\":\"account\", \"label\":\"账号\", \"value\":\"zhangsan\", \"href\":\"\"},""{\"index\":1, \"key\":\"sex\", \"label\":\"性特征\", \"value\":\"有度地位的人\"},""{\"index\":5, \"key\":\"reg_date\", 贴标签于:\\签到对齐日期, \"value\":\"2015-11-16\"},""{\"index\":6, \"key\":\"last_login\", 贴标签于:前番登录时期, \"value\":\"2015-12-22 15:38:54\"}]";

[[QYSDK sharedSDK] setUserInfo:userInfo];

Android SDK 转会

创办一体YSFUserInfo包围,将包括用户物 JSON 串补。转会()当将这YSFUserInfo包围作为决定因素去世给七鱼云客服 SDK。

YSFUserInfo userInfo = new YSFUserInfo();
userInfo.userId = "uid";
userInfo.data = "[{\"key\":\"real_name\", 花费:粗鲁的人},
                  {\"key\":\"mobile_phone\", \"hidden\":true},
                  {\"key\":\"email\", 花费:[email protected]},
                  {\"index\":0, \"key\":\"account\", \"label\":\"账号\", \"value\":\"zhangsan\" , \"href\":\"\"},
                  {\"index\":1, \"key\":\"sex\", \"label\":\"性特征\", \"value\":\"有度地位的人\"},
                  {\"index\":5, \"key\":\"reg_date\", 贴标签于:\\签到对齐日期, \"value\":\"2015-11-16\"},
                  {\"index\":6, \"key\":\"last_login\", 贴标签于:前番登录时期, \"value\":\"2015-12-22 15:38:54\"}]";

(用户物)

决定因素阐明

七鱼云客服零碎轻量级的桥基射中靶子决定因素,不顾是 Web SDK、iOS SDK、不然 Android SDK,经过用户的不平常的IDuid和用户物的表现 JSON 阻碍data结合。

在 Web SDK 中uiddata全部连续的出如今 JSON 中。iOS SDK 和 Android SDK 中,健康状况的构架限度局限生计用户物:iOS 中为QYUserInfo,Android 中为YSFUserInfo。iOS SDK 中,作为用户不平常的编号字母行的盟员。,盟员代表用户物 JSON 字母行。Android SDK 中,作为用户不平常的编号字母行的盟员。,盟员代表用户物 JSON 字母行。

以下决定因素uid地区对应 Web SDK 射中靶子 JSON 实地的 uid、iOS SDK 射中靶子、Android SDK 射中靶子data地区对应 Web SDK 射中靶子 JSON 实地的 data、iOS SDK 射中靶子、Android SDK 射中靶子

决定因素 典型 葡萄汁 阐明
uid String 不平常的的用户首数。
data Array / String 用阻碍(或说 JSON 字母行阻碍),在放大的客户端显示物。

经过data一体部署兵力场(iOS / Android SDK 是一体 JSON 字母行阻碍)描绘用户的片刻物,阻碍射中靶子每个元素代表一体录音项。在项主语对的外形为根底,额定的实地的添加到限度局限的显示作风。录音项限度局限如次:

实地的 典型 葡萄汁 阐明
key String 该该该该录音项的专门名称。,倾向于区别的录音。经过real_namemobile_phoneemail倾向于保存实地的,地区对应客户维修服务站用户物射中靶子“姓名”、“电话机听筒”、信箱三项录音。保存适应的关头词录音项,indexlabel无补的属性,其显示按次及专门名称由七鱼云客服零碎称呼委任。
value Mixed 录音显示,花费,不限度局限典型,地基实践需求。
label String 录音的显示专门名称。
index Int 排序,当显示录音,地基录音项index升阶的花费;不要设置index排向后面的录音项;index录音项或不鉴于同上的设置 JSON 在中心的的按次排列。
href String 超链接地址。假使称呼委任值,录音将显示为超链接花样,点击跳绳到称呼委任的值 URL 地址。
hidden Boolean 仅对mobile_phoneemail两保护区无效,指代适应的录音遮住,true为遮住,false不要遮住。假使您缺乏称呼委任,Windows 默许值是false不遮住。

坚持到底:real_namemobile_phoneemail尤其三个保护区:

  • 假使用功保存实地的,录音将显示在对应的专门名称、“电话机听筒”、信箱的位,按次、专门名称不克不及称呼委任;
  • 假使用功保存实地的,“姓名”、“电话机听筒”、信箱对应的录音将弱被剪辑,为了录音主件转变;在一通缺乏保存,这三项,填写客户维修服务规范,你也可以批改;
  • 经过mobile_phoneemailhidden实地的遮住,real_name不成遮住;
  • 假使既想经过轻量级的桥基供给物“姓名”、“电话机听筒”、信箱三项录音,也预料客服可以批改、这些物的保管,你可以幸免保存关头词,区别key供给物录音;这在色遇接头代表物,只因为在独特的可接到的东西的经济状况下缺乏使更新用户物。。

坚持到底: 使求助于的录音将地基预安装的花样连续的显示在七鱼云客服喊出名字以寻找适应的位上。假使录音是敏感的、高获得处所的需求,应在使求助于时做的脱敏处置。七鱼云客服零碎弱对录音做额定的处置。

示意图,敬请期待

作伴 CRM 桥基使联系

要领

作伴 CRM 使联系由作伴和客户供给物,七鱼云客服零碎将在电话机联络的时分转会假定的使联系,并将前往使联系录音以商定的花样显示在客户维修服务接合上。
作伴要了解这些使联系,可认为七鱼云客服零碎供给物用户物、定货单物等。 CRM 录音,为客户维修服务,实用的地获取油腻的的物任务,为了供给物更合适的的维修服务。

作伴接合为圆形的 HTTP (或 HTTPS使联系),由七鱼云客服零碎起点转会。七鱼云客服零碎跟随作伴 CRM 该零碎用功这些使联系停止录音道路立体枢纽,录音通常是在 JSON 体式睁开。即:

  • 七鱼云客服零碎转会作伴接合时,通常是向作伴接合 POST 描绘勤勉书的情节 JSON;
  • 作伴接合前往录音给七鱼零碎时,前往长度包括勤勉书的录音 JSON。

请小心显示每个使联系描绘录音体式。

为了确保录音的获得处所、思索必然的可扩展性。,作伴需提早给七鱼云客服零碎分派appidappsecret为试验接合。钞票度使发誓榜样。

本文档射中靶子使联系地址都是绝对某面。完成或完毕的接合 URL 需求在七鱼云客服设法对付端停止设置。

跨域提问

获取 token来试验用户的度使联系外,对立面使联系都由七鱼云客服零碎客服端前端起点转会,因而这些使联系需求伴奏跨域提问。使联系的适应头域(Header)中需求添加以下决定因素:

Access-Control-Allow-Headers: origin, x-csrftoken, content-type, accept, x-auth-code, X-App-Id, X-Token
Access-Control-Allow-Method: POST, GET, OPTIONS
Access-Control-Allow-Origin: 

经过Access-Control-Allow-Origin射中靶子xxx必须交换为作伴在七鱼云客服零碎上勤勉的二级区名。

顾虑更多物,请参阅 W3C Recommendation: Cross-Origin Resource Sharing。

使联系度使发誓

使联系度使发誓有两种可选:

  • 假使作伴供给物获取 token 的使联系,全部后续的勤勉书appidtoken认同了墨守法规的需求(如本文档中所示);
  • 假使作伴不供给物获取 token 的使联系,全部勤勉书都是连续的用功的。appsecret当做token用功。

特殊地,假使作伴不供给物获取 token 的使联系,以后葡萄汁将使联系 HTTPS 科学实验报告。(如今临时限度局限)

也有度使发誓决定因素去世两个选择权:

  • 在勤勉书 在健康状况的JSON:关头决定因素"appid""token"(如本文档中所示);
  • 在勤勉书的头域(Header)中:区名的决定因素"X-App-Id""X-Token"

获取 token

GET /get_token

与对立面使联系区别,获取 token 使联系为 GET 勤勉书。该使联系由七鱼云客服零碎后端维修满足需要转会,地基无效的前往时期决定转会。

勤勉书

决定因素 典型 葡萄汁 阐明
appid String 作伴分派给七鱼云客服零碎的 appid
appsecret String 作伴分派给七鱼云客服零碎的 appsecret

适应

接合必须前往一体包括 token 性和无效性 JSON。

{
    "rlt": 0,
    "token": "qiyukf_security_token",
    "expires": 7200000
}
实地的 典型 葡萄汁 阐明
rlt Int / String 显示使联系的成。值为0使联系转会成。片刻描绘了口误编码。,见Appendix I节。
token String 随后的接合无效用功电话机 token。
expires Int 记号说这从剩相抵成熟的 手写本数(非未兑的时期戳)。假使您缺乏称呼委任、不足或失效的,则Windows 默许值是 2 小时。记号完整失败后,对立面使联系必须前往一体口误编码2

获取用户物

POST /get_user_info

七鱼云客服零碎在需求获取访客片刻物时,将转会使联系。
前往的录音会显示在如今问答题好的的SID,历史的会话在立刻的问答题特性区的更多物。

用户的不平常的首数将被需求 POST 的使联系。

勤勉书

{
    "appid": "qiyukf",
    "token": "qiyukf_security_token",
    "userid": "zhangsan"
}
决定因素 典型 葡萄汁 阐明
appid String 作伴分派给七鱼云客服零碎的 appid。
token String 现行无效的 token。
userid String 用户的不平常的首数。

坚持到底:userid来喝彩用户开端逆命题,相反的事物完毕 SDK 的设定初值编码时去世给七鱼云客服零碎的决定因素中。

适应

接合必须前往一体包括用户录音的 JSON。

{
    "rlt": 0,
    "data": [
        {"index": 0, "key": "account", "label": "账号", "value": "zhangsan"},
        {"index": 1, "key": "name", "label": "姓名", "value": "恶霸", "edit": true, "map": "real_name"},
        {"index": 2, "key": "phone", "label": "电话机听筒", "value": "13800000000", "edit": true, "map": "mobile_phone"},
        {"index": 3, "key": "email", "label": "EMail", "value": [email protected], "edit": true, "map": "email"}
    ],
    "modify_cb": "url"
}
实地的 典型 葡萄汁 阐明
rlt Int / String 显示使联系的成。值为0使联系转会成。片刻描绘了口误编码。,见Appendix I节。
data Array 表现录音阻碍的用户物。
modify_cb String 假使作伴预料客服可以在七鱼云客服零碎中使更新客户的物,这供给物了一体使联系地址,回调后客户物批改。上面限度局限的使联系。

经过data与用户描绘阻碍的片刻物场,阻碍射中靶子每个元素代表一体录音项。在项主语对的外形为根底,额定的实地的添加到限度局限的显示作风。录音项限度局限如次:

实地的 典型 葡萄汁 阐明
key String 该该该该录音项的专门名称。,倾向于区别的录音。特殊地,假使录音可以剪辑(见edit实地的描绘),key作为使求助于到回调使联系的勤勉书的情节。。
value Mixed 录音显示,花费,不限度局限典型,地基实践需求。
label String 录音的显示专门名称。
index Int 排序,当显示录音,地基录音项index升阶的花费;不要设置index排向后面的录音项;index录音项或不鉴于同上的设置 JSON 在中心的的按次排列。
edit Boolean 指代录音不顾可以剪辑,true为可剪辑,false不成剪辑的。可剪辑时该项录音的值将显示在一体输出框内,经过剪辑情节会听筒机modify_cb使求助于使更新接合。
map String 蠲该项录音不顾与七鱼云客服零碎中紧握的录音项有熭相干。至若真正的名字real_name,电话机听筒号码是mobile_phone,电子信箱为email。假使一体录音项不顾立刻map值,则该录音也会同时在的显示在“如今问答题”中向右转舵用户材料区的“用户材料”贴标签于页下对应的项主语中,适应的项主语和历史运动会运动会的向右转舵。

坚持到底: 前往的录音将地基预安装的花样连续的显示在七鱼云客服喊出名字以寻找适应的位上。假使录音是敏感的、高获得处所的需求,必须作为补偿脱敏处置。七鱼云客服零碎弱对录音做额定的处置。

示意图,敬请期待

使更新用户物

POST /[modify_cb]

用户的不平常的首数和被批改的物会被作为勤勉书情节 POST 的使联系。

经过用户物收集使联系地址/get_user_info前往的modify_cb称呼委任的情节。

勤勉书

{
    "appid":"qiyukf",
    "token":"qiyukf_security_token",
    "userid":"zhangsan",
    "data":[
        {"key":"name", "value":"有害的幼虫"},
        {"key":"phone", "value":"1397777777X"}
    ]
}
决定因素 典型 葡萄汁 阐明
appid String 作伴分派给七鱼云客服零碎的 appid。
token String 现行无效的 token。
userid String 用户的不平常的首数。
data Array 用功一体阻碍来表现批改用户物录音。

坚持到底:userid来喝彩用户开端逆命题,相反的事物完毕 SDK 的设定初值编码时去世给七鱼云客服零碎的决定因素中。

经过data用功批改后的录音部署兵力描绘使求助于,阻碍射中靶子每个元素代表一体录音项。在项主语对外形:

实地的 典型 葡萄汁 阐明
key String 该该该该录音项的专门名称。,倾向于区别的录音。key花费喝彩获取用户物/get_user_info前往录音项对应的物key
value String 录音的批改值。作为一体字母行播送。

适应

接合必须前往一体包括用户物使更新树或花草结果的 JSON。

{
    "rlt":0,
    "data":[
        {
            "key":"name",
            "msg":"The name is too long.。"
        },
        {
            "key":"phone",
            "msg":电话机听筒号码体式口误。"
        }
    ]
}
实地的 典型 葡萄汁 阐明
rlt Int / String 显示使联系的成。值为0使联系转会成。片刻描绘了口误编码。,见Appendix I节。
data Array rlt不为0时,一体阻碍射中靶子每个录音批改完整失败点明说。

经过data一种改良的音讯完整失败描绘阻碍实地的,阻碍射中靶子每个元素代表一体录音项。录音项限度局限如次:

实地的 典型 葡萄汁 阐明
key String 该该该该录音项的专门名称。,倾向于区别的录音。适应勤勉书的录音项key
msg String 倾向于很录音批改完整失败的口误点明。

为了获取物

POST /get_order

七鱼云客服零碎在转会获取访客片刻物使联系/get_user_info时,将转会使联系。该使联系从事于电职业定货单物,也可以用功于筑职业的买卖物。
前往的录音会显示在如今问答题好的的SID,历史的会话在立刻的问答题特性区的更多物。
这两个贴标签于下,用户的定货单物将显示在用户的片刻物中。/get_user_info前往上面的录音)。

用户的不平常的首数将被需求 POST 的使联系。

勤勉书

{
    "appid": "qiyukf",
    "token": "qiyukf_security_token",
    "userid": "zhangsan""count": 10,
    "from": 0
}
决定因素 典型 葡萄汁 阐明
appid String 作伴分派给七鱼云客服零碎的 appid。
token String 现行无效的 token。
userid String 用户的不平常的首数。
count Int 需求回复次序的最大定量。与from与用功分页。
from Int 偏移量是勤勉书的前往按次列表,与count与用功分页。

坚持到底:userid来喝彩用户开端逆命题,相反的事物完毕 SDK 的设定初值编码时去世给七鱼云客服零碎的决定因素中。

适应

该使联系包括称呼委任的用户必须前往一体列表的按次 JSON。

{
    "rlt": 0,
    "count": 99,
    "orders": [
        {
            "index": 0,
            "blocks": [
                {
                    "index": 0,
                    "is_title": true,
                    "data": [
                        { "index": 0, "key": "orderid",  "label": "定货单号", "value": "00001", "href": "url"}
                    ]
                },
                {
                    "index": 1,
                    "data": [
                        {"index": 0, "key": "product", "label": "合意的人专门名称", "value": 易使皱起, "href": "url"},
                        {"index": 1, "key": "amount", "label": "领取要点", "value": "元"}
                    ]
                },
                {
                    "index": 2,
                    "data": [
                        {"index": 0, "key": "basic_proc", "label": "根底合意的人", "value": 渤海人寿保险费 , "href": "url"},
                        {"index": 1, "key": "revenue_yesterday", "label": 昨天重现, "value": "元"},
                        {"index": 2, "key": "revenue_amount", "label": "累计进项", "value": "元" }
                    ]
                }
            ]
        },
        {}
    ]
}
实地的 典型 葡萄汁 阐明
rlt Int / String 显示使联系的成。值为0使联系转会成。片刻描绘了口误编码。,见Appendix I节。
count Int 跑用户定货单录音总额,而定货单定量复原勤勉书。用于寻呼把持。
orders Array 阻碍射中靶子用户定货单列表录音。

定货单有多层嵌套的录音:

  • orders每个元素表现一体定货单;
  • 每个定货单的物可以鉴于情节类别,陷于多个块显示,定货单的blocks阻碍是生计在这些块;
  • 每个区块data一组假定的录音,相似地物录音的用户,阻碍射中靶子每个元素代表一体录音项,在项主语对的外形为根底,额定的实地的添加到限度局限的显示作风。

跟随orders每个定货单的录音限度局限:

实地的 典型 葡萄汁 阐明
index Int 排序,地基定货单列表index升阶的花费;不要设置index定货单将被排向后面;index同上或不要设置的按次将鉴于按次 JSON 在中心的的按次排列。
blocks Array 以一体阻碍包括块。

跟随blocks在每个录音块的限度局限:

实地的 典型 葡萄汁 阐明
index Int 排序,显示按次时期块打字员index升阶的花费;不要设置index成直角的在后排。;index同上或不设置设路障于将鉴于 JSON 在中心的的按次排列。
data Array 该块包括带有阻碍的录音。。
is_title Boolean 指代块为头衔的行,true那是头衔的行,false这过失头衔的行。当一体成直角的向,它将以按次头衔的花样显示。;和块上单击,该命令将启动/功能。

跟随data在它的每个录音项的限度局限:

实地的 典型 葡萄汁 阐明
key String 该该该该录音项的专门名称。,倾向于区别的录音。
value Mixed 录音显示,花费,不限度局限典型,地基实践需求。
label String 录音的显示专门名称。
index Int 排序,当显示录音,地基录音项index升阶的花费;不要设置index排向后面的录音项;index录音项或不鉴于同上的设置 JSON 在中心的的按次排列。
href String 超链接地址。假使称呼委任值,录音将显示为超链接花样,点击跳绳到称呼委任的值 URL 地址。

坚持到底: 前往的录音将地基预安装的花样连续的显示在七鱼云客服喊出名字以寻找适应的位上。假使录音是敏感的、高获得处所的需求,必须作为补偿脱敏处置。七鱼云客服零碎弱对录音做额定的处置。

示意图,敬请期待

接到试验的外形

七鱼云客服零碎供给物客服试验访客度的效能。客户维修服务需求认同提问者的度,起点度使发誓勤勉书,行人可以显示预安装的外形。提问者填写后使求助于的组织试验,但物不填写客户维修服务是看。客户维修服务将连续的收购提问度试验树或花草结果。

试验访客度的效能在很多眼镜下独特的电话机联络,譬如:

  • 未知的色遇的经济状况下,地基关头物,认同顾客度;
  • 顾虑财务物、获得处所需求高的账管理眼镜,地基关头物可以被论点一体访客。

度使发誓使联系分为两使分裂:

  • 接到试验的外形的使联系;
  • 和圆形的(也可以兼并为一体)来试验用户的度的使联系。

POST /get_verify_form

接到试验的外形的使联系,用于作伴通知七鱼云客服零碎哪一个物可以用于访客度试验,是什么使联系地址试验。

勤勉书

{
    "appid": "qiyukf",
    "token": "qiyukf_security_token"
}
决定因素 典型 葡萄汁 阐明
appid String 作伴分派给七鱼云客服零碎的 appid。
token String 现行无效的 token。

适应

接合必须前往包括一体客户我们家全部从事的列表。

{
    "rlt":0,
    "forms":[
        {
            "index":0,
            "form_name":"verify_id",
            "caption":请填写以下物,为了持续为您维修服务,
            "data":[
                {
                    "index":0,
                    "key":"id_no",
                    "label":"证件号"
                },
                {
                    "index":1,
                    "key":"bank_acc",
                    "label":"银行信用卡号",
                    "hidden":true
                }
            ],
            "verify_cb":"url",
            "tip":请填写您的对齐的细致的用功使发誓号码时,您的落得和银行信用卡。该物将经过获得衔接播送,无意识或下意识行为试验,不被不顾谁钞票。"
        },
        {
            "index":1,
            "form_name":"verify_mobile",
            "caption":头衔的的外形,
            "data":[
                {
                    "key":"mobile",
                    "label":"电话机听筒号"
                }
            ],
            "verify_cb":"url",
            "tip":填写整齐的的描绘,或对立面命令
        }
    ]
}
实地的 典型 葡萄汁 阐明
rlt Int / String 显示使联系的成。值为0使联系转会成。片刻描绘了口误编码。,见Appendix I节。
forms Array 说的度使发誓维修服务列表的外形可以突出圆形的O。

经过forms一体阻碍,维修服务客户的名单可以启动版本实地的,描绘阻碍射中靶子每个元素的一种外形,每一体表的录音限度局限如次:

实地的 典型 葡萄汁 阐明
form_name String 表格的专门名称,用来区别区别外形。当组织录音使求助于试验,form_name在使求助于录音衔接,为了试验试验录音的窗体接合。尤其当区别的外形verify_cb试验同上的地址,form_name主要地要紧。
data Array 组织包括录音的阻碍。
verify_cb String 试验这种外形的使联系地址
index Int 排序,地基度使发誓外形的客户末期的显示列表index升阶的花费;不要设置index表格将在后排;index同上或不设置外形将鉴于 JSON 在中心的的按次排列。
caption String 宾客作客区内的产权使发誓表格。若不要设置,则用功默许头衔的。
tip String 紧握外形的命令或整齐的来供应,将窗体使固定显示。

经过data现场用功一体阻碍来描绘,试验了录音项,每个录音项的限度局限如次:

实地的 典型 葡萄汁 阐明
key String 该该该该录音项的专门名称。,倾向于区别的录音。
label String 录音的显示专门名称。
index Int 排序,当录音显示外形index升阶的花费;不要设置index排向后面的录音项;index录音项或不鉴于同上的设置 JSON 在中心的的按次排列。
hidden Boolean 指代录音不顾编口令域,true这是口令接,false表现缺乏口令域。当一体录音域口令,用户输出的情节将*·代表。不要设置hidden当录音项过失默许的口令域。

示意图,敬请期待

来试验用户的度

POST [verify_cb]

提问者填写度使发誓表,和使求助于录音,七鱼云客服零碎会将用户填写的情节,使求助于给供给物作伴来试验用户的度使联系停止度试验。

来试验用户的度使联系的地址,由接到试验的外形使联系/get_verify_form前往的verify_cb称呼委任的情节。

勤勉书

{
    "appid":"qiyukf",
    "token":"qiyukf_security_token",
    "form_name":"verify_id",
    "userid":"zhangsan",
    "data":[
        {
            "key":"id_no",
            "value":"330108000000009999"
        },
        {
            "key":"bank_acc",
            "value":"628888888888888"
        }
    ]
}
决定因素 典型 葡萄汁 阐明
appid String 作伴分派给七鱼云客服零碎的 appid。
token String 现行无效的 token。
form_name String 表格的专门名称,来喝彩 /get_verify_form前往使联系form_name实地的,由客户认同顾客的度构成的决定。
userid String 用户的不平常的首数。
data Array 使求助于试验录音表现一体阻碍。

经过data包括使求助于试验录音的阻碍,阻碍射中靶子每个元素代表一体录音项,录音项限度局限如次:

实地的 典型 葡萄汁 阐明
key String 该该该该录音项的专门名称。,倾向于区别的录音。来喝彩/get_verify_form前往使联系组织中录音项的key实地的。
value String 录音的花费,色遇进入情节。作为一体字母行播送。

坚持到底:userid来喝彩用户开端逆命题,相反的事物完毕 SDK 的设定初值编码时去世给七鱼云客服零碎的决定因素中。普通来讲,用户不料登录后在作伴射中靶子用功,才有很userid。就是,用户未登录条款下,客户维修服务突出的访客度使发誓,试验勤勉书能够过失userid这场。试验使联系需求充满思索这种经济状况,决定提问者不顾会试验使发誓人userid的值。但不顾不顾会用到,七鱼云客服零碎总会放量在勤勉书中带上userid物。

适应

接合必须前往的色遇度试验,你也可以前往色遇的更多物。

{
    "rlt":0,
    "verify_rlt":true,
    "userid":"zhangsan",
    "data":[
        {"index":0, "key":"name", "label":"姓名", "value":"有害的幼虫"},
        {"index":1, "key":"real_name_auth", "label":"实名度使发誓", "value":"是"},
        {"index":2, "key":"bank_acc", "label":绑定银行信用卡, "value":"************4174"},
        {"index":3, "key":"cash", "label":"相抵", "value":"¥8*,***.**"}
    ]
}
实地的 典型 葡萄汁 阐明
rlt Int / String 显示使联系的成。值为0使联系转会成。片刻描绘了口误编码。,见Appendix I节。
verify_rlt Boolean 这不顾蠲提问者的物了。,true说的,false表现不经过。这将落得在如今显示的客户维修服务面的情节,提示客户维修服务。
userid String verify_rlttrue时,您可以前往到适应的用户userid。假使前往userid,和作伴供给物了获取用户物/get_user_info使联系、为了获取物/get_order使联系,则七鱼云客服零碎在收到此次适应时会以此userid作为一体勤勉书决定因素,这些使联系,并将获取到的用户物显露在如今问答题向右转舵用户材料区的“更多物”贴标签于页下。
data Array verify_rlttrue时,可以将已确定的物前往给用户,此物将连续的在如今的客户维修侍者。。在一体部署兵力,这些录音包括的物表现。

经过data一体用户物描绘阻碍实地的,阻碍射中靶子每个元素代表一体录音项。录音项的用户物和限度局限/get_user_info前往使联系data一致的限度局限,但不包孕editmap实地的:

实地的 典型 葡萄汁 阐明
key String 该该该该录音项的专门名称。,倾向于区别的录音。
value Mixed 录音显示,花费,不限度局限典型,地基实践需求。
label String 录音的显示专门名称。
index Int 排序,当显示录音,地基录音项index升阶的花费;不要设置index排向后面的录音项;index录音项或不鉴于同上的设置 JSON 在中心的的按次排列。

示意图,敬请期待

与称呼委任桥基榜样比得上

轻量级的桥基与桥基使联系的比得上。眼镜、功绩财政困难、录音使孤立。

区别作伴的提议、合作,区别桥基办法。

轻量级的桥基办法与桥基使联系办法,是客户在维修服务工序中供给物油腻的的旅游业物,为了向前推维修服务质量和任务效率。而是,在两桥基榜样和实施方案是区别的,上面的两桥基办法的比得上。

并联的角度

轻量级的桥基 桥基使联系
录音挖出 开端逆命题,由客户端 SDK 使求助于。 供给物作伴 HTTP 使联系。
转会办法 由客户端 SDK 将录音使求助于给七鱼云客服零碎维修满足需要,客户维修服务站向七鱼云客服维修满足需要起点勤勉书。 客户维修服务站连续的向供给物作伴 HTTP 使联系起点勤勉书。
录音往事 访客录音编口令后生计在七鱼云客服零碎。 客户维修服务站前端连续的起点勤勉书,录音不经七鱼云客服维修满足需要,完整使孤立。
效能 显示自限度局限访客物:√
显示定货单录音:×
跟随作伴录音 CRM 同时在的:×
色遇物试验:×
显示自限度局限访客物:√
显示定货单录音:√
跟随作伴录音 CRM 同时在的:√
色遇物试验:√
显示位 如今问答题和问答题历史用户录音选择权卡。 如今问答题和问答题历史更多物选择权卡。
功绩财政困难 低。
只需客户的相互相干录音有访客。,它可以阐明地基科学实验报告 JSON 使求助于。
中。
需求功绩一套 HTTP 使联系,跟随作伴 CRM 录音库桥基。假使有一体同样的的使联系,桥基易于。
功绩本钱 低。
可聪明的了解。
无特殊需求。
中。
需求必然的人工开展。
The need to support跨域
倾向于现场 合意的人攀登较小
合意的人开展青年
合作攀登较小
技术人工烦乱
作伴 CRM 尚不使完美
访客录音需求普通
不需求定货单、买卖类物。
合意的人攀登中大
合意的人开展渐衰期
合作攀登中大
技术人工有已确定的伴奏
作伴 CRM 较使完美
访客录音需求
需求定货单、买卖类物。

Appendix I 口误码

全部桥基使联系rlt口误编码保存值的限度局限如次:

  • 0: 使联系前往立刻;
  • 1: 用appidappsecret作为一体度使发誓办法,缺乏经过度使发誓;
  • 2: 用appidtoken作为一体度使发誓办法,表现 token 未兑的;

对立面经济状况,地基事情逻辑来等同于本人的口误编码,只显示。

度使发誓榜样的描绘,请使发誓人使联系度使发誓章节。

全部的口误编码,口误编码,包孕保存,可以用给与形态的或字母行。即:

{
    "rlt": 0
}
{
    "rlt": "0"
}

两种办法是相等的的。

当前往使联系rlt实地的值不0时,你可以设置一体在前往的情节msg实地的,供给物用于显示口误物。

发表评论

电子邮件地址不会被公开。 必填项已用*标注