企业微信通过向服务商开放接口,实现企业微信与服务商产品之间的相互调用,一起满足企业在各应用场景下的使用需求。为了确保服务商正确与规范的使用接口,企业微信向服务商颁发接口调用许可。
很多时候用户购买的企微接口与实际需要使用的人数不符合,需要通过函数做下二次开发,集成平台提供以下能力,供实施使用
/**
* @author
* @codeName 企微更改接口
* @description 企微更改接口
* @createTime 2025-07-24
* @bindingObjectLabel --
* @bindingObjectApiName NONE
* @函数需求编号
*/
Map pullOrderData = ["orderId":"xxxxxxxx"]
Map header = [:]
Map body = ["type":"pullActiveCode","pullOrderData":pullOrderData]
log.info("pullOrderData :" + pullOrderData)
//根据企微接口许可订单,拉取激活码对象全量更新到CRM
def(Boolean error,HttpResult result,String errorMessage) = Fx.proxy.callAPI("erpdss.oaconnector.qywxExecute",
[:],
header,
body,
)
//根据激活码指定激活企微员工,注意这里的userId需要是企微的userId,不是crm的员工编号,可以从CRM对象:企业微信员工WechatEmployeeObj中获取
Map triggerActiveCode = ["activeCode":"XXXXXX","userId":"XXXXXX"]
Map triggerActiveCodeBody = ["type":"triggerActiveCodeToUserId","qywxActviceCodeArg":triggerActiveCode]
def(Boolean error,HttpResult result,String errorMessage) = Fx.proxy.callAPI("erpdss.oaconnector.qywxExecute",
[:],
header,
triggerActiveCodeBody,
)
//企微接口账号继承 转移成员的userid:handoverUserid 接收成员的userid:takeoverUserid
Map transferUserIds = [
"handoverUserid": "xxxxxxxxx",
"takeoverUserid": "xxxxxxxxx"
]
// 创建转移用户列表
List transferUserIdsList = [transferUserIds] // 支持一次性传递多个成员
// 创建 QywxTransferUserIdArg 对象
Map qywxTransferUserIdArg = [
"transferList": transferUserIdsList
]
// 创建最终的请求体
Map transferUserIdsBody = [
"type": "transferUserIds",
"qywxTransferUserIdArg": qywxTransferUserIdArg // 注意这里是对象,不是数组
]
def(Boolean error,HttpResult result,String errorMessage) = Fx.proxy.callAPI("erpdss.oaconnector.qywxExecute",
[:],
header,
transferUserIdsBody,
)
使用说明
- 需要购买以下产品:平台才会下发对应的接口对象WechatInterfaceLicenseObj
企业微信接口许可-基础接口 wechat_interface_permission_base_app
SCRM 销售账号 scrm_sales_account_industry
营销通-全员营销账号-企微版 marketing_strategy_wechat_account_wechat_edition_app

2.需要根据从企微购买的订单号,调用对应的函数:pullOrderData
3:需要进行指定激活码,激活企微员工调用对应的函数 :triggerActiveCodeToUserId,需要参考对应[企业微信员工] WechatEmployeeObj 对象拿到对应企微员工密文id
4.在企业员工离职或者工作范围的有变更时,允许将其许可账号继承给其他员工,调用对应的函数:transferUserIds