本指南适用于一粒云平台运营管理员或服务商技术人员，用于完成企业微信第三方应用与一粒云平台之间的一次性接入。企业客户的租户管理员不需要填写 SuiteSecret、Token 或 EncodingAESKey；租户侧操作请参阅《企业管理员如何授权并同步企业微信通讯录》。
一、在企业微信服务商后台准备第三方应用
先创建并配置企业微信第三方应用，按功能需要申请通讯录基本信息只读、组织架构等权限；涉及成员敏感信息的权限应按最小必要原则申请，并由企业微信管理员审阅。按照企业微信后台要求配置数据回调 URL、指令回调 URL、Token 和 EncodingAESKey，并保持 Ticket 刷新处于开启状态。
回调地址必须是企业微信能够访问的公网 HTTPS 地址。不要使用内网 IP、localhost 或临时测试地址。应用权限和可见范围应按实际功能需要设置。
二、在一粒云 SaaS 运营后台保存平台配置
进入 SaaS 运营管理后台的“第三方集成平台配置”，选择“企业微信”，按字段填写 SuiteID、服务商 CorpID、SuiteSecret、回调 Token、EncodingAESKey，以及平台要求的公网回调基础地址和企业微信回调地址。核对后保存平台配置。
保存后检查页面是否显示 suite_ticket 接收成功。确认平台收到企业微信的接入校验信息后，租户管理员才能继续发起企业授权。
三、交接给租户管理员完成企业授权
平台配置完成后，通知对应企业的租户管理员进入云盘管理后台添加企业微信集成。后续由该企业的企业微信管理员扫码授权，并选择应用可见范围。
凭据保管要求
SuiteSecret、Token 和 EncodingAESKey 属于敏感凭据。仅在受控的管理后台录入，不要放入文章、截图、工单或聊天记录；如凭据已经出现在公开材料中，应按企业微信的安全流程尽快轮换。