CRM扩展
数据接口
- 开发向导
- 单点登录
- 工单
- 客服
- 客户
- 绑定关系
- 服务记录
- 表单
- 呼叫中心
- 知识库
- 标签
- 账号
- 短信
侧边栏
帮我吧文档:数据接口:绑定关系:与第三方平台的关系绑定
绑定关系
添加绑定关系
调用地址
POST /api/v1/user/relationship/cid.json
请求参数
| 名称 | 类型 | 必需的 | 注释 |
|---|---|---|---|
| cId | int | 是 | 联系人ID |
| openId | string | 是 | 第三方系统用户唯一ID |
| appId | string | 否 | 绑定微信时微信公众号id |
| account_source | string | 是 | 绑定账号来源 dingding/wechat/workWechat/open |
调用者权限
所有客服
调用示例
curl -v -u {account}:{password} https://www.bangwo8.com/api/v1/user/relationship/cid.json \
-H "Content-Type: application/json" -X POST -d '{"cId":"6862715","openId":"564354327","appId":"789","account_source":"wechat"}'
返回值示例 成功时：
{
"data": true,
"msg": "success"
}
当联系人不存在时报错：
{
"state": "403",
"message": "user error"
}
当联系人存在但已经有绑定关系时报错：
{
"state": "403",
"message": "Bind Already exists"
}
查询绑定关系
调用地址
GET /api/v1/user/relationship/cid.json
请求参数
| 名称 | 类型 | 必需的 | 注释 |
|---|---|---|---|
| cId | int | cId与openId至少用一个参数，两个参数都存在时，绑定关系对应才返回相应值 | 联系人ID |
| openId | string | 第三方系统用户唯一ID | |
| account_source | string | 是 | 绑定账号来源 dingding/wechat/open |
调用者权限
所有客服
调用示例
curl https://www.bangwo8.com/api/v1/user/relationship/cid.json?cId=30851821&account_source=dingding&openId=10014850
-v -u {account}:{password}
返回值示例
成功响应：
{
"data": [
{
"aId": "601993",
"cId": "30851821",
"account": "u2_601993_15cdbc98048f7c059b24f6f3f2065bbd",
"remark": "",
"templateId": "0",
"openId": "10014850",
"appId": "",
"account_source": "dingding"
}
],
"msg": "success"
}
失败响应：
{
"state": "403",
"message": "user error"
}
修改绑定关系
调用地址
PUT /api/v1/user/relationship/cid.json
请求参数
| 名称 | 类型 | 必需的 | 注释 |
|---|---|---|---|
| cId | int | 是 | 联系人ID |
| openId | string | 否 | 第三方系统用户唯一ID |
| account_source | string | 是 | 绑定账号来源 dingding/wechat/open |
| appId | string | 否 | 微信公众号id |
调用示例
curl https://www.bangwo8.com/api/v1/user/relationship/cid.json \
-H "Content-Type: application/json" \
-d '{
"cId": "40713895",
"account_source": "wechat",
"openId": "12345",
"appId": "123"
}' \
-v -u {account}:{password} -X PUT
返回值示例
成功响应：
{
"data": true,
"msg": "success"
}
删除绑定关系
调用地址
DELETE /api/v1/user/relationship/cid.json
请求参数
| 名称 | 类型 | 必需的 | 注释 |
|---|---|---|---|
| cId | int | 是 | 联系人ID |
| account_source | string | 是 | 绑定账号来源 dingding/wechat/open |
Content-Type： multipart/form-data
调用示例
curl -v -u {account}:{password} https://www.bangwo8.com/api/v1/user/relationship/cid.json?account_source=wechat&cId=6862715 \
-H "Content-Type: multipart/form-data"
-X DELETE
返回值示例
{
"data": true,
"msg": "success"
}
