企微考勤数据同步配置指南

在行政人事管理的场景中,企业会使用考勤打卡功能,并且需要将考勤打卡的数据导出进行二次处理,用于后续的考勤统计和薪资绩效核算等。

如果企业使用了企业微信考勤打卡,我们可以通过伙伴云的考勤应用,配置后即可将企微打卡数据同步至伙伴云表格中,企业可基于自身的个性化的考勤规则或绩效核算规则,利用伙伴云能力对打卡的数据进行后续的二次处理和呈现。

前置准备事项

准备项 详情 相关费用
企微认证 需要完成企微认证后的企业才能进行后续完整配置 300元/年
独立IP 因企微数据安全相关方面限制,在伙伴中配置通讯录授权(企微客户信息同步)与自建应用(配置考勤同步)过程中需要设置独立IP、独立域名与独立网址,企微才会进行相应的授权 500元/年
域名申请与备案 因国家法规及数据的安全隐私政策的要求,完成域名的备案后的地址才可以在侧边栏访问。
注:域名备案主体必须与企微认证主体一致
域名购买:自主购买,一般在百元内/年
域名服务器:腾讯云服务器68元/年起,自行选择。
域名备案:免费或自行选择付费。

配置教程

1. 企微认证

在企微后台的我的企业中,验证主体信息,企微会进行相应收费,当前为300元/年,以企微实际认证费用为准。

进入"企业微信后台 → 我的企业 → 企业信息"中进行认证。

img

2. 购买独立IP

可前往伙伴云企业后台 → 企业账户 → 独立IP进行开通,费用500元/年。

img

也可以联系您的业务支持伙伴线下支付并开通功能。

3. 域名申请与备案

3.1 注册腾讯云

进入腾讯云网站 https://cloud.tencent.com/,点击左上角进行免费注册

3.2 实名认证

注册完之后,进行实名认证(https://console.cloud.tencent.com/developer/auth),需要使用企业认证,认证的企业必须和企微认证的企业是一致的。

img

详细认证配置>>

3.3 信息模板

注册域名前需要先完成信息模板配置。

img

进入创建模板信息填写页

img

建议使用企业验证,提交之后等待审核(1-4个工作日)。

若填写过程中遇到问题可查询服务商官网信息模板管理配置教程>>

3.4 域名注册

进入域名注册(https://console.cloud.tencent.com/domain/all-domain),注册一个合适的域名。

img

注册一个规范的、符合企业的域名。

跳转至注册域名界面,配置选择模板等操作后,提交订单:

img

3.5 购买服务器

可以在腾讯首页的轮播图中购买一个最低配的服务器。

如果企业有已经做了企业验证的服务器,不用购买服务器,生成备案码即可备案授权码操作指引

img

接着下单:

img

3.6 网站备案

需要对域名与服务器进行网站备案

可在官网进行自主备案,也可以委托腾讯云进行备案(600元一个网站)。

img

跳转至备案界面填写相关信息,自助备案经历七个步骤:

①验证备案 → ②主体信息 → ③互联网信息服务 → ④补充材料上传 → ⑤信息预览与提交备案 → ⑥短信核验 → ⑦管局审核

备案前准备指引>>

img

详细操作步骤见服务商官网ICP备案操作流程>>

提交备案申请,会经过腾讯云审核(1-2个工作日),再经过管局审核(7-14个工作日),就可以备案成功了。

img

在腾讯云电话回访时,创建网站需要有正当的目的,比如:为了展示公司的形象,介绍公司相关业务与发展史。

管局审批完成后会收到短信,备案完成即可申请二级域名,然后下载ssl文件。

4. 配置考勤应用

4.1 安装「企微考勤」应用

在工作区管管理菜单界面或者工作区后台中,进入"扩展应用",点击添加应用。

img

在应用市场中选择安装「企微考勤」应用。

img

点击安装后,稍等一小段时间进行应用的安装。安装完成后,「企微考勤」应用会显示在导航栏,应用配置中心点击「安装到企业微信」。

img

如果我们已经在浏览器中登录企业微信管理后台,会自动弹出企业微信第三方应用的安装界面,勾选"已阅读并同意",点击「同意以上授权并添加」

img

这样我们就安装了「考勤分析」这个企业微信应用,这个应用不用做太多设置,在可见范围只保留一个成员即可,也不必关注应用使用时间。

img

回到伙伴云「企微考勤」应用的配置中心,右上角显示已经✅安装到企业微信,点击配置授权,进入配置界面、根据配置授权界面的引导进行设置。

img

img

4.2 创建自建应用

进入"企业微信后台 → 应用管理 → 自建 → 创建应用"(推荐应用名称为"考勤数据同步",推荐应用图标)。

img

上传logo,填写应用名称(推荐为"考勤数据同步"),设置应用的可见范围为全公司。

img

点击应用管理,选择刚刚创建的应用,复制AgentID。

img

点击查看Secret。

img

点击发送Secret后,会发送给企微管理员。

img

在企微中企微管理员会收到通知,点击前往查看,复制Secret

img

img

将复制的AgentID和Secret填写到如下位置。

img

4.3 配置可信域名

点击绑定企业微信专用企业独立域名

img

4.3.1 购买独立IP

未购买独立IP时,显示如下(每年500元,伙伴云收取费用,可自行购买或联系您的业务伙伴付费开通)。

img

购买独立IP后,点击"绑定企业微信工具栏独立域名"会弹出如下页面,然后先复制出"gaxsxv.p.huobanbot.com"(该指向仅为示例,实际配置请复制自己界面显示的cname指向)。

img

4.3.2 添加记录

复制好后,进入腾讯云 → 我的解析,点击解析后添加记录(二级域名)。

快捷跳转链接:腾讯云-我的解析

img

按如下,主机记录填"p",记录类型勾选"CNAME",记录值填"gaxsxv.p.huobanbot.com",其他保持默认无需修改,最后点击确认即可。此时,咱们的二级域名就是p.huobanmb.com。

img

4.3.3 申请免费证书

快捷跳转链接:腾讯云-我的证书

申请用于配置伙伴云工具栏的二级域名证书(p.huobanmb.com),具体步骤如下,提交后等待即可,申请的证书会很快签发下来。

img

img

img

4.3.4 下载免费证书

添加完记录以后,进入我的证书,下载免费证书。

快捷跳转链接:腾讯云-我的证书

img

点击下载后,选择下载Nginx的证书。

img

下载完成后,回到伙伴云企业后台,将独立域名(p.huobanmb.com)和证书(PEM文件、KEY文件)上传上去,最后点击保存即可。

img

保存成功后,是如下状态,点击复制可信域名。

img

接下来就需要进入企微后台,在"考勤数据同步"应用详情页,找到"网页授权及JS-SDK",点击"设置可信域名"。

img

粘贴可信域名后,点击"申请校验域名"。

img

点击下载文件,切记不要点"确定",也不要关闭弹窗。

img

下载的文件如下:

注意: 文件有时效30分钟,超时需要重新下载;文件名字必须得是"WW_verify_aySZtBMxp8GiGyZE"才能验证成功,重新下载时新文件名字会变成"WW_verify_aySZtBMxp8GiGyZE(1)",上传该文件会导致验证失败,所以请务必在重新下载前,先将原来的删掉,确保本地只有一份验证文件。

img

将下载的文件上传至下方位置。

img

上传完成后,回到企微后台点击"确定",若验证成功会在"网页授权及JS-SDK"的原先"设置可信域名"的位置显示"已启用"。

img

点进去能看到"已验证"的状态。

img

注意: 若点击"确定"后提示验证失败,请不要慌,可能是因为腾讯云那边二级域名的校验有延迟,等一段时间就好了,至于等多少时间不确定,可能等一会儿,或者第二天再重新走了一遍配置可信域名环节的企微后台的操作,就验证成功了。

img

4.4 配置可信IP

进入自建应用详情的"开发者接口 → 企业可信IP"中,将下面提供的可信IP填入企业微信

img

img

img

4.5 设置接收信息

进入自建应用详情的"功能 → 接收消息 → 设置API接收"中,将下面提供的URL、Token、EncodingAESKey填入企业微信,在"选择需要接收的消息事件类型"中勾选"审批状态通知事件"后保存。

img

img

img

4.6 设置打卡API

进入"企业微信后台 → 应用管理 → 应用 → 基础 → 打卡 → API",在"可调用接口的应用"中勾选刚创建的自建应用后"确认"。

在应用管理中找到打卡应用

img

点击展开 API,设置可调用接口的应用

img

勾选考勤数据分析应用,并确认保存

img

4.7 设置审批 API

进入"企业微信后台 → 应用管理 → 应用 → 基础 → 审批 → API",在"开启回调通知的模版"中勾选与考勤有关的模板或全选所有模板后"保存",在"可调用接口的应用"中勾选刚创建的自建应用后"确认"。

在应用管理中找到审批应用

img

点击展开 API,分别设置开启回调通知的模板和可调用接口的应用

img

设置开启回调通知的模板时,可以选择单独勾选请假、出差、外出、加班和打卡,也可以选择全部模板

img

设置可调用接口的应用,勾选考勤数据分析应用,并点击确认。

img

4.8 开启日报推送开关

上文内容配置完成后,回到考勤应用配置界面,点击保存,开启日报推送开关。

img

img

注意事项与常见问题

  1. 企微需要认证,域名需要备案,域名备案主体需与企微认证主体一致。
  2. 企业微信自建应用的可见范围必须设置为"全公司"(通讯录根目录),否则成员数据无法同步。
  3. 企微考勤应用中必须开启员工报告日报推送开关。若未开启,即使授权成功也不会同步每日考勤数据。
2025-12-31 更新
1 次查看
0