• 售前顾问:400-007-8125


  • 销售顾问

  • 摩盖SCRM服务号

销售服务热线: 400-007-8125

接口文档

开发平台首页>

getSalesWechatCustomers 接口

  • 更新时间 2020-07-28

概述

该接口用于获取企业账户下所有工作手机上的微信账户实例信息。

请求URL

https://api-hub.mobilegate.net/getSalesWechatCustomers


请求方式

POST


请求参数

参数名 备注
enterpriseId 企业账号ID(详见管理控制台->开发信息)
queryIndicator 查询变量(根据不同查询模式有不同含义)
queryType 查询模式
requestToken 签名(详见 参数签名

查询模式与查询变量

模式AqueryType赋值为0,则通过enterpriseId查询企业账户下所有的工作手机上的微信好友(客户)数据,此时 queryIndicator请赋值为0;

模式BqueryType赋值为1,则queryIndicator意义为工作手机账号(可来源于getSalesPhoneContactAccounts返回的phoneid参数),将查询账号为queryIndicator的工作手机上的微信好友(客户)数据;

模式CqueryType赋值为2,则queryIndicator意义为员工微信账号(可来源于getSalesWechatAccounts接口返回的wxid参数),将查询微信账号为queryIndicator的微信好友(客户)数据;

模式DqueryType赋值为3,则queryIndicator意义为微信关联手机号码(可来源于getSalesWechatAccounts接口返回的mobile参数),将查询微信关联绑定号码为queryIndicator的微信好友(客户)数据;

模式EqueryType赋值为4,则queryIndicator意义为微信好友最近一次更新的Unix时间戳(单位为秒)例如 1600138527 (代表 2020/9/15 10:55:27),给予此参数,代表获取自该时间点起,所有发生过自身账户信息更新行为的微信好友数据。微信好友信息更新时间,代表好友在微信端针对包括自我头像、昵称等任意信息做出修改更新的时间;


返回结果

参数名 备注
saleswxid 员工微信账号
username 好友(客户)微信账号
nickname 好友(客户)微信昵称
conRemark 好友(客户)的名称备注
avatar2 好友(客户)的微信头像地址

返回格式

JSON

返回示例

{"Result":[{"saleswxid":"wxid_142549239712","username":"wxid_5226adg4552a","nickname":"MoJiQo","conRemark":"王经理","avatar2":"http://xxxxxxxxxx"},{"saleswxid":"wxid_142549239712","username":"wxid_jh323kkk0980sdfs","nickname":"MissMei","conRemark":"小美","avatar2":"http://xxxxxxxxxx"}]}

异常返回

无数据返回

{"Result": "0"}

输入参数错误

{"Result": "-1"}

参数含有非法字符

{"Result": "-2"}

enterpriseID未提供

{"Result": "-3"}

参数签名错误

{"Result": "-99"}