Question

企业微信有 企业内部开发 ， 第三方应用开发 和 智慧硬件开发 三种接入场景。 同一个接口根据场景不容，掺入参数的含义可能不一样。开发过程中，请根据实际场景，按照文档传入正确的参数。 部分“微信企业号”文档存在，企业微信 API 文档不存在的接口，名称后面会标注 (旧接口，建议更换) 。建议更换成企业微信提供的新接口。

WeChatClient

class wechatpy.enterprise.client.WeChatClient(*args, **kwargs)[源代码]

class wechatpy.enterprise.client.api.WeChatAgent(client=None)[源代码]

class wechatpy.enterprise.client.api.WeChatAppChat(client=None)[源代码]

class wechatpy.enterprise.client.api.WeChatBatch(client=None)[源代码]

class wechatpy.enterprise.client.api.WeChatChat(client=None)[源代码]

class wechatpy.enterprise.client.api.WeChatDepartment(client=None)[源代码]

class wechatpy.enterprise.client.api.WeChatJSAPI(client=None)[源代码]

class wechatpy.enterprise.client.api.WeChatMaterial(client=None)[源代码]

class wechatpy.enterprise.client.api.WeChatMedia(client=None)[源代码]

class wechatpy.enterprise.client.api.WeChatCalendar(client=None)[源代码]

class wechatpy.enterprise.client.api.WeChatSchedule(client=None)[源代码]

class wechatpy.enterprise.client.api.WeChatMenu(client=None)[源代码]

class wechatpy.enterprise.client.api.WeChatMessage(client=None)[源代码]

class wechatpy.enterprise.client.api.WeChatMisc(client=None)[源代码]

class wechatpy.enterprise.client.api.WeChatOAuth(client=None)[源代码]

class wechatpy.enterprise.client.api.WeChatService(client=None)[源代码]

class wechatpy.enterprise.client.api.WeChatShakeAround(client=None)[源代码]

class wechatpy.enterprise.client.api.WeChatTag(client=None)[源代码]

class wechatpy.enterprise.client.api.WeChatUser(client=None)[源代码]

class wechatpy.enterprise.client.api.WeChatExternalContact(client=None)[源代码]

https://work.weixin.qq.com/api/doc

add_contact_way(type, scene, style=None, remark=None, skip_verify=True, state=None, user=None, party=None)[源代码]

配置客户联系「联系我」方式 https://work.weixin.qq.com/api/doc

参数

• type – 联系方式类型,1-单人, 2-多人

• scene – 场景，1-在小程序中联系，2-通过二维码联系

• style – 在小程序中联系时使用的控件样式，详见附表

• remark – 联系方式的备注信息，用于助记，不超过30个字符

• skip_verify – 外部客户添加时是否无需验证，默认为true

• state – 企业自定义的state参数，用于区分不同的添加渠道，在调用“获取外部联系人详情”时会返回该参数值

• user – 使用该联系方式的用户userID列表，在type为1时为必填，且只能有一个

• party – 使用该联系方式的部门id列表，只在type为2时有效

返回

返回的 JSON 数据包

add_corp_tag(group_id, group_name, order, tags)[源代码]

企业可通过此接口向客户标签库中添加新的标签组和标签。 https://work.weixin.qq.com/api/doc/90000/90135/92117

参数

• group_id – 标签组id

• group_name – 标签组名称，最长为30个字符

• order – 否 标签组次序值。order值大的排序靠前。有效的值范围是[0, 2^32)

:param tags:[

tag.name 是 添加的标签名称，最长为30个字符 tag.order 否 标签次序值。order值大的排序靠前。有效的值范围是[0, 2^32) ]

:return:返回的 JSON 数据包

add_msg_template(template)[源代码]

添加企业群发消息模板 https://work.weixin.qq.com/api/doc

{

“external_userid”:[

“woAJ2GCAAAXtWyujaWJHDDGi0mACas1w”, “wmqfasd1e1927831291723123109r712”

], “sender”:”zhangsan”, “text”:{

“content”:”文本消息内容”

}, “image”:{

“media_id”:”MEDIA_ID”

}, “link”:{

“title”:”消息标题”, “picurl”:”https://example.pic.com/path”, “desc”:”消息描述”, “url”:”https://example.link.com/path”

}, “miniprogram”:{

“title”:”消息标题”, “pic_media_id”:”MEDIA_ID”, “appid”:”wx8bd80126147df384”, “page”:”/path/index”

}

} external_userid 否 客户的外部联系人id列表，不可与sender同时为空，最多可传入1万个客户 sender 否 发送企业群发消息的成员userid，不可与external_userid同时为空 text.content 否 消息文本内容 image.media_id 是 图片的media_id link.title 是 图文消息标题 link.picurl 否 图文消息封面的url link.desc 否 图文消息的描述 link.url 是 图文消息的链接 miniprogram.title 是 小程序消息标题 miniprogram.pic_media_id 是 小程序消息封面的mediaid，封面图建议尺寸为520*416 miniprogram.appid 是 小程序appid，必须是关联到企业的小程序应用 miniprogram.page 是 小程序page路径

text、image、link和miniprogram四者不能同时为空； text与另外三者可以同时发送，此时将会以两条消息的形式触达客户 image、link和miniprogram只能有一个，如果三者同时填，则按image、link、miniprogram的优先顺序取参，也就是说，如果image与link同时传值，则只有image生效。 media_id可以通过素材管理接口获得。

参数

template – 见上方说明.

返回

返回的 JSON 数据包

del_contact_way(config_id)[源代码]

删除企业已配置的「联系我」方式 :param config_id: 企业联系方式的配置id :return: 返回的 JSON 数据包

del_corp_tag(tag_id=None, group_id=None)[源代码]

企业可通过此接口删除客户标签库中的标签，或删除整个标签组。 如果一个标签组下所有的标签均被删除，则标签组会被自动删除。 https://work.weixin.qq.com/api/doc/90000/90135/92117

:param tag_id:标签的id列表 tag_id和group_id不可同时为空。 :param group_id:标签组的id列表 tag_id和group_id不可同时为空。 :return:返回的 JSON 数据包

edit_corp_tag(id, name, order)[源代码]

企业可通过此接口编辑客户标签/标签组的名称或次序值。 https://work.weixin.qq.com/api/doc/90000/90135/92117

:param id:标签或标签组的id列表 :param name:新的标签或标签组名称，最长为30个字符 :param order:标签/标签组的次序值。order值大的排序靠前。有效的值范围是[0, 2^32) :return:返回的 JSON 数据包

get(external_userid)[源代码]

获取外部联系人详情 https://work.weixin.qq.com/api/doc :param external_userid: 外部联系人的userid，注意不是企业成员的帐号 :return: 返回的 JSON 数据包

get_contact_way(config_id)[源代码]

获取企业已配置的「联系我」方式 https://work.weixin.qq.com/api/doc :param config_id: 联系方式的配置id, e.g.42b34949e138eb6e027c123cba77fad7 :return: 返回的 JSON 数据包

get_corp_tag_list(tag_ids=None)[源代码]

企业可通过此接口获取企业客户标签详情 https://work.weixin.qq.com/api/doc/90000/90135/92116

:param tag_ids:要查询的标签id，如果不填则获取该企业的所有客户标签，目前暂不支持标签组id ,示例：[“etXXXXXXXXXX”,”etYYYYYYYYYY”] :return: 返回的 JSON 数据包

get_follow_user_list()[源代码]

获取配置了客户联系功能的成员列表 https://work.weixin.qq.com/api/doc :return: 返回的 JSON 数据包

get_group_msg_result(msgid)[源代码]

获取企业群发消息发送结果 企业和第三方可通过该接口获取到添加企业群发消息模板生成消息的群发发送结果。 https://work.weixin.qq.com/api/doc

参数

msgid – 群发消息的id，通过添加企业群发消息模板接口返回

返回

返回的 JSON 数据包

get_unassigned_list(page_id, page_size)[源代码]

获取离职成员的客户列表 企业和第三方可通过此接口，获取所有离职成员的客户列表，并可进一步调用离职成员的外部联系人再分配接口将这些客户重新分配给其他企业成员。 https://work.weixin.qq.com/api/doc

参数

• page_id – 分页查询，要查询页号，从0开始

• page_size – 每次返回的最大记录数，默认为1000，最大值为1000

返回

get_user_behavior_data(userid, start_time, end_time)[源代码]

获取员工行为数据

企业可通过此接口获取员工联系客户的行为数据，包括聊天数，发送消息数，消息回复比例和平均首次回复时长等维度。 https://work.weixin.qq.com/api/doc

参数

• userid – userid列表

• start_time – 数据起始时间

• end_time – 数据结束时间

返回

返回的 JSON 数据包

list(userid)[源代码]

获取外部联系人列表 https://work.weixin.qq.com/api/doc :param userid: 企业成员的userid :return: 返回的 JSON 数据包

mark_tag(userid, external_userid, add_tag=None, remove_tag=None)[源代码]

企业可通过此接口为指定成员的客户添加上由企业统一配置的标签。 https://work.weixin.qq.com/api/doc/90000/90135/92118

:param userid:添加外部联系人的userid :param external_userid:外部联系人userid :param add_tag:要标记的标签列表 :param remove_tag:要移除的标签列表 :return:返回的 JSON 数据包

send_welcome_msg(template)[源代码]

发送新客户欢迎语 企业微信在向企业推送添加外部联系人事件时，会额外返回一个welcome_code，企业以此为凭据调用接口，即可通过成员向新添加的客户发送个性化的欢迎语。 为了保证用户体验以及避免滥用，企业仅可在收到相关事件后20秒内调用，且只可调用一次。 如果企业已经在管理端为相关成员配置了可用的欢迎语，则推送添加外部联系人事件时不会返回welcome_code。 https://work.weixin.qq.com/api/doc

{

“welcome_code”:”CALLBACK_CODE”, “text”:{

“content”:”文本消息内容”

}, “image”:{

“media_id”:”MEDIA_ID”

}, “link”:{

“title”:”消息标题”, “picurl”:”https://example.pic.com/path”, “desc”:”消息描述”, “url”:”https://example.link.com/path”

}, “miniprogram”:{

“title”:”消息标题”, “pic_media_id”:”MEDIA_ID”, “appid”:”wx8bd80126147df384”, “page”:”/path/index”

}

} welcome_code 是 通过添加外部联系人事件推送给企业的发送欢迎语的凭证，有效期为20秒 text.content 否 消息文本内容 image.media_id 是 图片的media_id link.title 是 图文消息标题 link.picurl 否 图文消息封面的url link.desc 否 图文消息的描述 link.url 是 图文消息的链接 miniprogram.title 是 小程序消息标题 miniprogram.pic_media_id 是 小程序消息封面的mediaid，封面图建议尺寸为520*416 miniprogram.appid 是 小程序appid，必须是关联到企业的小程序应用 miniprogram.page 是 小程序page路径

text、image、link和miniprogram四者不能同时为空； text与另外三者可以同时发送，此时将会以两条消息的形式触达客户 image、link和miniprogram只能有一个，如果三者同时填，则按image、link、miniprogram的优先顺序取参，也就是说，如果image与link同时传值，则只有image生效。 media_id可以通过素材管理接口获得。 :param template: 见上方说明. :return: 返回的 JSON 数据包

transfer(external_userid, handover_userid, takeover_userid)[源代码]

离职成员的外部联系人再分配 企业可通过此接口，将已离职成员的外部联系人分配给另一个成员接替联系。 https://work.weixin.qq.com/api/doc

参数

• external_userid – 外部联系人的userid，注意不是企业成员的帐号

• handover_userid – 离职成员的userid

• takeover_userid – 接替成员的userid

返回

返回的 JSON 数据包

update_contact_way(config_id, remark, skip_verify=True, style=None, state=None, user=None, party=None)[源代码]

更新企业已配置的「联系我」方式 https://work.weixin.qq.com/api/doc

参数

• config_id – 企业联系方式的配置id

• remark – 联系方式的备注信息，不超过30个字符，将覆盖之前的备注

• skip_verify – 外部客户添加时是否无需验证

• style – 样式，只针对“在小程序中联系”的配置生效

• state – 企业自定义的state参数，用于区分不同的添加渠道，在调用“获取外部联系人详情”时会返回该参数值

• user – 使用该联系方式的用户列表，将覆盖原有用户列表

• party – 使用该联系方式的部门列表，将覆盖原有部门列表，只在配置的type为2时有效

返回

返回的 JSON 数据包