群消息推送 Webhook
把告警、日报和外部系统通知发送到指定群，可发送文本、Markdown、图片、文件和模板卡片等。
接入要求在允许的企业微信群中创建消息推送并取得 Webhook。官方现称消息推送，原称群机器人；该推送凭证不提供任意读取群聊天的权限。
办公协作 / WeCom Developer Platform
企业微信
提供内部自建应用、第三方应用、消息推送和智能机器人等接入方式，覆盖组织管理、办公协作、客户联系与微信客服。不同主体和应用类型可用的权限差别较大，需先选择接入路线。
01 / CAPABILITIES
开放功能
智能机器人对话与流式回复
通过 API 模式接收用户与机器人的交互消息和事件，回复文本、卡片或流式内容，可用于企业内部问答助手。
接入要求创建智能机器人并开启 API 模式。可配置公网回调 URL 并处理校验、加解密，或使用 Bot ID 与 Secret 建立 WebSocket 长连接；长连接无需固定公网 IP。
内部应用通知与交互
给应用可见范围内的成员发送应用消息，配置菜单，并处理发给应用的消息和相关事件，连接企业后台。
接入要求由管理员在企业内创建应用并授权可见范围，用本应用令牌调用；需要接收事件时配置回调。应用会话消息与普通员工聊天是不同范围。
组织通讯录与成员登录
按授权范围查询或维护部门、成员，使用网页授权或扫码登录识别企业成员，为内部工具提供身份入口。
接入要求可见范围、通讯录权限和敏感字段权限分别确认。用户详细信息需要相应授权；个人主体第三方应用默认仅限当前用户基本信息，不能据此获取整个企业通讯录。
文档与协作内容
按接口开放范围创建文档、读写支持的文档内容、管理协作成员和权限，将业务内容同步到企业微信。
接入要求自建应用需加入文档可调用应用列表，第三方与代开发需文档权限；可操作的文档和内容类型依接口与资源权限确定。编辑前应读取最新版本与位置，不能推断任意文档都可读取。
日历、日程与会议安排
创建和管理应用日历及日程，邀请企业成员参与，用于面试、会议和项目计划同步。
接入要求管理员需配置可调用日程接口的应用；通知成员须在应用可见范围。日历日程不可跨应用操作，第三方与代开发还需开启相应日程权限。
审批流程与业务系统同步
读取审批模板、代员工提交申请、查询申请详情与流程状态，并通过回调跟进单据变化。
接入要求按审批应用的接口要求授权自建应用；审批应用接口与在自建或第三方应用内使用的审批流程引擎不同，不能混用。
客户联系与客户群管理
管理获授权员工的客户资料、标签、联系我入口和客户群数据，对接 CRM 及客户运营流程。
接入要求先配置可使用客户联系的成员，再配置可调用接口的应用。第三方、代开发的数据字段、试用期和活跃范围另有限制；客户群资料不等于群聊天全文。
微信客服会话与消息
管理微信客服账号、接待人员和会话分配，通过 API 收发用户主动咨询的客服消息。
接入要求企业已在企业微信中使用微信客服并开启 API，管理员授权应用和目标客服账号；接待人员需在应用可见范围，发送还受客服会话规则限制。
会话内容存档
在企业开通并指定员工范围后，通过专用接口获取符合条件的工作沟通内容，适用于质检和合规留档。
接入要求这是单独开通的能力，需配置存档范围、调用 IP 和加密公钥。内部员工需告知，外部联系人需同意；不提供个人微信账号的全部历史聊天读取。
02 / REQUIREMENTS
接入条件
- 适用主体
- 企业内部开发者、企业管理员、客户服务系统开发者、第三方软件服务商、受限个人开发者
- 接入方式
- 内部自建应用使用 CorpID 与应用 Secret 换取 access_token / 网页 OAuth 与授权登录用于识别成员，详细信息需相应用户授权 / 第三方应用使用 SuiteID、SuiteSecret、suite_ticket 及企业授权凭证 / 群消息推送使用独立 Webhook；智能机器人 API 使用其回调凭证或 Bot ID 与 Secret
- 申请概况
- 按应用类型和主体开放；企业业务需管理员授权
- 内部自建应用需要企业微信组织，由管理员创建应用、确认数据用途并授权可见范围；普通成员账号不自动拥有这些权限。
- 个人可以走官方个人主体第三方应用通道，但权限和安装范围受限，主要是当前成员基本信息、JS-SDK 与应用消息等；不开放组织架构、企业客户、日程、审批等企业敏感权限。
- 对多个企业提供完整业务能力通常选择服务商第三方应用或经企业授权的代开发模式。服务商上线须完成认证、平台审核，并由客户企业授权安装。
- 自建应用调用接口须按官方开发规则配置企业可信 IP。涉及网页授权、JS-SDK 或登录时，还需配置对应可信域名和授权回调域，完成域名归属等校验；具体备案与主体要求按接入形态和后台指引确认。
- 公网消息或事件回调需提供可访问的 URL，正确响应地址验证，并使用 Token 与 EncodingAESKey 验签、加解密。智能机器人长连接使用独立机制，不能直接套用自建应用凭证。
- 客户联系、微信客服、日程和存档等需额外开启业务功能并指定可调用应用或成员范围；部分功能还需认证或付费开通，以目标企业后台为准。
- 服务商第三方应用与代开发应用需核对接口调用许可的购买、激活和续期；试用环境成功不代表正式许可已满足。
03 / GET STARTED
开通步骤
- 01
先选接入路线
群通知选消息推送，机器人问答选智能机器人，企业数据集成选内部自建应用；跨企业产品再评估第三方或代开发。
- 02
确认主体与管理员
准备企业微信账号，确认管理员、应用负责人和目标业务范围；个人主体开发者应先核对受限权限是否足够。
- 03
创建并完成安全配置
获取对应应用或机器人凭证，配置可见范围、可信 IP；需要网页或回调时完成域名、URL 验证和加密配置。
- 04
逐项开启业务能力
根据用途在日程、客户联系、微信客服等管理页面授权应用，再使用正确令牌测试目标接口和数据范围。
- 05
小范围验证后发布
先以测试成员或测试企业验证消息、权限不足及回调重试；第三方应用另需完成平台审核、企业授权和接口许可。
04 / COSTS & LIMITS
费用、边界与测试方式
费用概况
按接入模式、成员许可与增值能力分别评估，不承诺所有 API 免费。
- 内部自建应用与服务商第三方或代开发应用属于不同接入路线，应分别核对当前后台规则。
- 第三方与代开发应用涉及接口调用许可；基础账号、互通账号对应的能力不同，许可需要按成员激活并在有效期内使用。
- 客户联系、会话内容存档等增值能力、认证和配套产品可能另有开通或服务费用，需在企业或服务商后台确认报价。
- 官方测试企业和应用试用有专门规则，其费用与使用状态不能直接套到正式服务。
- 自行部署的服务器、域名、存储与外部模型服务费用由开发者承担。
使用范围与限制
- 企业微信开放平台不提供任意个人微信账号登录、读取其全部好友或聊天记录的通用接口。客户联系、微信客服、应用会话与内容存档是不同能力。
- 群消息推送、智能机器人和企业应用的凭证、事件及权限模型不同；取得其中一种凭证不能调用其他路线的全部能力。
- 应用可见范围决定能为哪些成员调用接口；通讯录、客户联系、日程等还需额外授权，不能只看 access_token 是否有效。
- 部分客户联系群发接口需要员工确认，并受触达频率等限制；不可把创建群发任务描述为不受限自动私信。
- 第三方客户数据受授权方式、应用使用状态及接口调整影响。当前规则对试用期、低活跃和长期未使用应用分别设置访问限制。
- 个人主体第三方应用的发布、成员授权和安装数量有限制，不能当作与认证企业服务商同等的开放通道。
- 各接口、机器人发送及业务动作均有调用限制，具体配额、字段和错误码以当前官方文档与企业后台为准。
如何进行开发测试
- 内部测试：以小范围可见成员和独立测试应用联调，避免影响真实员工与客户。
- 第三方应用测试：在服务商后台通过安装测试或测试授权验证应用；正式发布后再走客户企业授权。
- 接口许可测试企业：有专门的许可与订单测试规则，和应用普通试用期不同。
- 正式企业环境：使用获授权的应用、业务功能与有效许可；消息或写入操作会作用到真实企业资源。
接入前再确认
- 同一接口在内部自建、第三方和代开发模式下，权限、许可和返回字段可能不同。
- 个人主体第三方通道的可申请状态、具体权限与安装限制，需在自己的后台确认。
- 企业认证资格、实际价格与配额，以及可信域名的备案和主体要求，按目标企业与所选功能核对。
05 / OFFICIAL SOURCES
官方资料
以下资料用于核对本页内容。申请与使用时，请以对应接口的最新规则为准。
- 01简易教程：自建应用与消息交互已核对官方资料 · 2026-10-15
- 02开发前必读：接口流程、频控与可信 IP已核对官方资料 · 2026-10-15
- 03基本概念：企业、应用凭证与可见范围已核对官方资料 · 2026-10-15
- 04获取 access_token已核对官方资料 · 2026-10-15
- 05回调配置：URL 验证、签名与加密已核对官方资料 · 2026-10-15
- 06发送应用消息已核对官方资料 · 2026-10-15
- 07构造网页授权链接：基本与敏感信息授权已核对官方资料 · 2026-10-15
- 08消息推送配置说明，原群机器人已核对官方资料 · 2026-10-15
- 09智能机器人概述：API 与回调已核对官方资料 · 2026-10-15
- 10智能机器人长连接已核对官方资料 · 2026-10-15
- 11开发者注册应用：个人主体权限与安装限制已核对官方资料 · 2026-10-15
- 12服务商注册应用：认证、授权与上线已核对官方资料 · 2026-10-15
- 13客户联系概述与接口调整说明已核对官方资料 · 2026-10-15
- 14创建企业群发：成员确认与触达限制已核对官方资料 · 2026-10-15
- 15微信客服概述与应用授权已核对官方资料 · 2026-10-15
- 16微信客服发送消息已核对官方资料 · 2026-10-15
- 17日程概述与应用权限已核对官方资料 · 2026-10-15
- 18审批应用概述已核对官方资料 · 2026-10-15
- 19新建文档已核对官方资料 · 2026-10-15
- 20编辑文档内容已核对官方资料 · 2026-10-15
- 21会话内容存档概述已核对官方资料 · 2026-10-15
- 22会话内容存档使用前帮助已核对官方资料 · 2026-10-15
- 23接口调用许可概述与测试企业指引已核对官方资料 · 2026-10-15
- 24腾讯统一身份：企业微信应用安全配置已核对官方资料 · 2026-10-15
- 25企业微信管理后台入口官方入口 · 细则待复核 · 2026-10-15
官方文档核对，未进行接口实测
最近核验 2026-10-15 · 查看核验说明
最近核验 2026-10-15 · 查看核验说明