企业微信号二次开发 & wecomapi.com
个人微信接口产品官网管理后台
个人微信接口产品官网管理后台
  1. 接入指南与说明
  • API文档目录
    • 接入指南与说明
      • 👉 接入须知
      • 🛡️ Webhook调试指南
      • 🔄 消息推送(回调)服务
      • 📖 常见业务与技术 FAQ
      • ⚠️ 开发常见问题
      • ✅ 账号使用注意事项
    • 开放接口
      • 01 登录与设备
        • 配置消息回调地址
          POST
        • ① 创建设备并获取 guid
          POST
        • ② 获取登录二维码
          POST
        • ④ 校验登录验证码(按需)
          POST
        • ③ 查询扫码登录状态
          POST
        • 账号退出登陆
          POST
        • 检查是否在线
          POST
      • 02 联系人管理
        • 外部联系人与好友申请列表
          POST
        • 内部联系人列表
          POST
        • 批量获取联系人详情
          POST
        • 搜索联系人
          POST
        • 通过二维码查询联系人
          POST
        • 添加个微联系人
          POST
        • 添加企微联系人
          POST
        • 停止并释放设备
          POST
        • 添加群成员为好友
          POST
        • 查询账号在线状态
          POST
        • 添加企微名片联系人
          POST
        • 退出当前设备
          POST
        • 重新添加单删联系人
          POST
        • 同意好友申请
          POST
        • 修改外部联系人信息
          POST
        • 修改内部联系人信息
          POST
      • 03 消息收发与会话
        • 发送引用消息
        • 发送文本消息
        • 发送混合文本消息
        • 发送图片消息
        • 发送 GIF 表情
        • 发送视频消息
        • 发送文件消息
        • 发送语音消息
        • 发送链接消息
        • 发送小程序消息
        • 发送名片消息
        • 发送视频号消息
        • 发送位置消息
        • 删除联系人
        • 语音转文字:提交任务
        • OpenID 转 UserID
        • 语音转文字:查询结果
        • 收藏 GIF 表情
        • UserID 转 OpenID
        • 同步个人收藏消息
        • 撤回消息
        • 修改消息状态
        • 查询群消息置顶列表
        • 设置群消息置顶
        • 移除群消息置顶
        • 发起群发消息
        • 查询群发状态
        • 查询群发规则
        • 同步历史消息分页
        • 查询会话列表分页
        • 编辑会话分组
        • 查询会话分组
      • 04 文件上传与下载
        • 企微大文件异步上传
        • 个微文件异步下载
        • 企微文件异步下载
        • 上传缩略图
        • SDK 临时云存储上传
        • 企微文件异步上传
        • 企微大文件异步下载
        • CDN 文件转 URL
        • 个微文件下载
        • 企微文件下载
        • URL 文件上传
        • 本地文件上传
      • 05 外部群与群组管理
        • 查询群组列表分页
        • 批量获取群详情
        • 群成员变动查询
        • 获取群二维码
        • 批量获取群详情(兼容入口)
        • 修改群名称
        • 创建群组
        • 修改群备注
        • 修改群内昵称
        • 修改群公告
        • 开启或关闭群改名权限
        • 禁止群成员修改群名称
        • 邀请或添加群成员
        • 管理员确认群成员邀请
        • 移除群成员
        • 禁止群成员互相添加
        • 添加群管理员
        • 取消群管理员
        • 开启入群确认
        • 通过链接接受入群邀请
        • 退出群组
        • 转让群主
        • 解散群组
        • OpenID 转 RoomID
        • RoomID 转 OpenID
      • 06 账号资料
        • 生成个人二维码
        • 获取账号资料
        • 更新账号资料
        • 查询企业资料
      • 07 客户标签管理
        • 查询标签列表分页
        • 客户标签增删
        • 个人标签增删改
      • 08 朋友圈能力
        • 发布朋友圈
        • 删除朋友圈
        • 朋友圈点赞或取消点赞
        • 朋友圈评论或追评
        • 分页查询朋友圈
        • 批量获取朋友圈详情
        • 删除朋友圈评论
        • 朋友圈素材上传
  1. 接入指南与说明

✅ 账号使用注意事项

账号接入 · 日常运营 · 客户维护 · 异常处理
适用对象: 账号负责人、运营人员、企业管理员
接入前,先记住这四点
实名齐全: 账号与企业均须完成实名认证。
使用时间: 账号实际使用时间须超过 2 个月。
好友操作: 每个账号每天,主动添加与同意申请合计建议控制在 15–35 个。
掉线处理: 先暂停任务,查看原因推送并核对手机提示,再决定如何处理。
这些条件与数量属于 WecomApi 的接入要求或运营建议,不是腾讯公布的安全额度,也不保证账号不会受限。
接口调用、Token 配置与回调排查,请查阅 📖 开发常见问题。

01 · 账号接入#

满足条件,再开始使用#

资料真实 — 使用本人或企业有权管理的账号,身份及企业资料须真实、可核验。
使用时间符合要求 — 以账号实际使用时间为准,不仅看注册日期;未满足条件的账号暂不接入,不通过购买、租借或批量注册凑齐条件。
手机端状态正常 — 可以正常登录、收发消息,没有待处理的身份验证、功能限制或企业权限异常。
业务权限明确 — 客户联系、群管理、朋友圈等能力,以账号实际权限为准。
有人负责处理异常 — 保留账号本人或企业管理员的联系渠道,确保安全提醒、验证码与成员交接有人处理。
首次接入或更换业务系统后,先小范围验证。 使用少量已获授权的测试对象,确认消息收发与异常通知正常,再启用正式任务。不要立即集中补发历史消息或执行大批量客户操作。

02 · 登录与使用环境#

环境稳定,操作分工清楚#

设备与网络
使用官方企业微信客户端,版本与登录要求以当前平台说明为准。尽量保持常用设备、地区和网络稳定;确需变更时,先暂停业务,确认登录与状态正常后再恢复。
多人或多系统协作
明确同一账号的使用分工,避免同时登录、退出、恢复或执行集中任务。不要在多个登录端之间反复抢占,也不要因一次请求失败就反复扫码、换网络或重建设备。
登录确认与授权
妥善保管手机、验证码及登录确认信息。陌生扫码请求、设备登录或安全提醒,应先核实;只批准本人或企业授权的接入。
服务与名额
定期核对服务有效期和授权数量。到期或额度不足时,由负责人处理续费或授权调整,不要直接将其判断为账号被封。
提醒: 稳定环境有助于减少登录冲突与排查难度,不能替代平台规则,也不构成账号安全保证。

03 · 消息发送与好友操作#

消息发送:对象准确,节奏合理#

有真实沟通需要 — 发送咨询回复、服务通知等相关内容,避免向无关对象无差别群发或反复推送未经请求的营销信息。
发送前核对 — 检查客户私聊或群聊对象、文案、附件、链接及适用范围,尤其避免向外部群误发内部资料。
控制集中任务 — 按正常业务节奏安排,同一账号不要同时承担多个集中发送任务。
自动回复可转人工 — 出现答非所问、连续重复回复或客户要求人工服务时,及时暂停并转交。
结果不明先核实 — 没有看到成功提示,不等于消息没有发出。先查实际会话与任务记录,避免重复发送。
客户明确拒绝营销联系后,应停止相关触达。出现投诉、频率限制、连续失败或安全验证时,暂停相关任务并排查,不靠增加发送次数补回失败量。

好友操作:按账号合并统计#

每日建议 · 每账号两类操作合计
主动添加好友 + 同意好友申请 → 每日合计建议 10–25 个
例如:主动添加 8 个,同意申请 12 个,当天合计 20 个。
10 个不是最低任务量。 没有业务需求时无需操作,不为凑量添加客户。
需要注意正确做法
多人、多系统使用同一账号合并统计,不分别计算一份数量
客户来源与联系目的优先联系主动咨询、明确同意或已有服务关系的客户
对方已拒绝或不希望联系停止反复提交申请和营销触达
操作结果不明确先核实,不反复点击补量
出现验证、限制或投诉立即暂停,即使尚未达到建议数量
每天核对操作记录,避免多人重复安排同一批客户。不要短时间集中提交申请;上述数量及任何固定发送间隔,都不能作为不受限制的保证。

04 · 群管理与朋友圈#

👥 群管理#

操作前
确认群的性质、目标群、成员范围和账号权限,区分内部群、外部群与客户群。
操作中
邀请或移除成员、修改公告、转让群主、退群或解散群等操作,应由有权限的人员确认,并保留操作人、时间和结果。
操作后
核对实际群状态。批量修改先小范围验证,结果不明确时先检查,不直接重复提交。
群消息应与群用途相关,重要通知尽量整理后再发送,避免短时间连续发送重复内容。

🖼️ 朋友圈#

发布前: 检查文案、图片、链接、素材使用权限及可见范围。
发布时: 根据真实业务需要安排,避免连续发布大量重复或高度相似的推广内容。
发布后: 核对实际展示;失败时先查原因,不反复提交。
不同功能的权限、群规模和发布限制,以对应能力说明为准,不直接套用其他平台或网上流传的额度。

05 · 掉线与异常处理#

先看原因,再做处理
暂停任务 → 查看原因推送 → 核对手机提示 → 按原因处理 → 验证后恢复
掉线后先暂停该账号的发送、加好友等任务。不要直接循环重连、扫码或重建设备。

根据提示选择处理方式#

看到的情况下一步
网络或连接异常检查网络与平台恢复结果,由指定人员统一处理
主动退出或被其他端踢下线核对操作人与设备占用,确认后按正常流程登录
身份验证、验证码或安全提醒由账号本人在官方客户端处理,暂停自动化任务
功能或账号受限保留原因与客户端提示,停止受限业务,通过官方入口处理
原因不明确或未收到推送联系技术人员检查通知与账号状态,不凭“离线”判断封禁

恢复后,先检查再放行#

1.
核对身份: 确认登录的是正确账号。
2.
验证业务: 检查实际消息收发与异常通知是否正常。
3.
审核积压: 取消已失效或已经人工处理的任务。
4.
逐步恢复: 分批放行业务,避免一次性集中补发。

需要协助时,准备这些信息#

发生时间 · 账号识别信息 · 操作场景 · 脱敏后的原因推送 · 手机端提示截图 · 已做过的处理
技术字段与回调排查方法见 📖 开发常见问题。提交材料前注意脱敏,不发送完整凭证或客户隐私数据。

06 · 账号授权与资料保护#

权限按需分配。 账号、客户资料、聊天记录和附件仅向有业务需要的人员开放,操作应能追溯。
敏感信息不公开。 不在普通群聊、截图或公开文档中发送完整 Token、验证码、回调密钥、会话文件及未经脱敏的客户资料。
用途和期限明确。 仅保存业务必要内容,设置访问权限与保存期限,按适用要求处理停止联系、撤回或删除请求。
交接及时处理。 人员离职、账号停用、业务交接或疑似凭证泄露时,检查授权及操作记录,调整或撤销相关权限。
遵守使用边界。 不用于诈骗、骚扰、违法推广、非法采集或侵权;不通过切换账号、设备或网络反复执行已受限制的任务。

07 · 日常检查清单#

开始使用前#

账号及企业已实名,账号实际使用超过 2 个月。
手机端正常,安全提醒已处理,账号负责人可以及时联系。
服务有效期、授权及资料访问权限已核对。

执行任务时#

好友操作已按账号合并统计,没有重复安排客户。
发送对象、内容、附件和群范围已核对。
自动回复有人工接管入口,异常出现时可及时暂停。

异常恢复后#

已查看原因推送,并按实际提示完成处理。
已验证实际收发,审核积压任务,避免集中补发。
提交给技术支持的材料已脱敏。

📚 配套文档与规则入口#

开发常见问题 — 接口接入、登录流程、Webhook 与技术排查。
企业微信软件许可及服务协议 · 用户帐号使用规范 — 现行规则也可从官方客户端查阅。
中华人民共和国个人信息保护法 — 资料保护建议的参考依据。
规则说明: 本文的接入条件、好友数量和掉线处理要求采用 WecomApi 已确认的使用口径。第三方接入服务不等于获得腾讯官方授权;任何固定次数、发送间隔或使用方式,都不能保证账号永久在线、消息绝对送达或账号不受限制。
上一页
⚠️ 开发常见问题
下一页
配置消息回调地址
Built with