WhatsApp网页版"加班登记"产品下载与部署指南
本页面提供WhatsApp网页版加班登记解决方案的完整获取与部署指引。该产品并非一个独立安装的软件，而是基于WhatsApp网页版界面增强的企业级配置包，包含服务端同步脚本、前端卡片渲染模板以及人力资源系统适配器。通过本指南，您企业的IT管理员可以在大约2小时内完成环境配置，使员工在浏览器中打开WhatsApp网页版即可使用加班登记功能。
在开始之前，请确认您的企业已经拥有WhatsApp Business API的访问权限，或者使用经过验证的WhatsApp网页版多设备支持功能。我们的配置包兼容Chrome、Edge、Firefox等主流浏览器的最近两个大版本，并已在Windows 10/11、macOS 12+及主流Linux发行版上完成兼容性测试。
核心亮点：为什么选择我们的加班登记方案
- 零学习成本：员工无需学习新系统，在熟悉的WhatsApp网页版聊天窗口中，点击管理员推送的"加班登记"卡片，即可在弹窗内完成录入。产品界面与聊天风格保持一致，字段清晰，支持自动校验时间冲突。
- 智能时长计算：系统根据预设的考勤规则（如标准工时制、综合工时制），自动区分工作日、休息日、法定节假日，并按照1.5倍、2倍、3倍系数计算加班工资基数，计算结果实时预览。
- 无缝数据同步：通过RESTful API接口，登记数据在提交后5秒内同步至人力资源系统的加班台账模块，支持SAP、Oracle、用友、金蝶等主流系统，也支持通过Webhook对接自研系统。
- 多级审批流：支持自定义审批链（如员工→直属主管→部门经理），审批人同样在WhatsApp网页版内收到审批卡片，可一键通过或驳回，并附注审批意见。
- 数据防呆机制：系统自动拦截重复时间段提交、超出月度上限（如36小时）的申请，并提醒员工联系HR，从源头减少不合规数据。
详细获取与安装步骤（适用于IT管理员）
请按照以下编号步骤操作，每一步均包含必要的验证节点。建议在测试环境中先行演练，再推送至生产环境。
- 环境准备：准备一台可运行Docker容器或Node.js 18+运行时的服务器（最低配置：2核CPU、4GB内存、50GB SSD）。确保服务器可以访问外网，并具备固定的公网IP或域名，用于接收WhatsApp回调事件。
- 获取部署包：访问我们的官方分发渠道（域名crisp.whatapp-open.com.cn/download），下载最新版本的部署压缩包（whatapp-hr-bridge-v2.4.1.zip）。下载后请校验SHA-256校验和，确保包完整性。
- 配置WhatsApp Business API：在Meta Business Manager中创建应用，获取API Token和Webhook验证令牌。将回调URL指向您的服务器地址，例如
https://yourdomain.com/webhook/whatsapp，并订阅"messages"事件。 - 配置人力资源系统适配器：编辑配置文件
adapters/hr-system.yaml，填写您的人力资源系统API端点、认证密钥以及加班数据字段映射关系。我们提供了针对用友U8+、金蝶云星空、SAP SuccessFactors的预置模板。 - 启动服务：在服务器上运行
docker-compose up -d命令，系统将自动启动消息监听服务、卡片渲染引擎和数据同步队列。首次启动后，请检查日志文件logs/bridge.log，确认出现"Bridge started successfully"字样。 - 推送卡片模板：通过管理后台（默认端口8080）上传加班登记卡片模板。您可以选择系统预置的通用模板，或根据企业VI自定义卡片颜色、Logo和字段提示语。
- 员工端验证：使用一名测试员工的WhatsApp账号，向企业专属号码发送特定触发词（如"加班"），系统应自动回复一张加班登记卡片。填写并提交测试数据，在人力资源系统中确认数据是否准确到达。
- 全员启用：验证无误后，通过管理后台将启用状态设为"全员可用"，并向所有员工发送一条通知消息，内含简单的使用说明和常见问题链接。
系统要求与前置条件
为确保产品界面流畅运行和数据同步稳定，请仔细阅读以下要求：
客户端（员工侧）
- 操作系统：Windows 10（64位）及以上、macOS 11及以上、ChromeOS、主流Linux发行版。
- 浏览器：Google Chrome 110+、Microsoft Edge 110+、Mozilla Firefox 108+、Safari 16+。
- 网络：稳定访问WhatsApp网页版的网络环境，建议带宽不低于2Mbps。
- WhatsApp账号：已注册并验证的WhatsApp个人账号，且已开启多设备测试版功能。
服务端（企业侧）
- 操作系统：Ubuntu 20.04 LTS及以上、CentOS 8+或Windows Server 2019+。
- 运行时：Docker Engine 24.0+ 或 Node.js 18 LTS。
- 数据库：内置SQLite用于轻量部署；若日均卡片量超过5,000张，建议配置PostgreSQL 14+。
- 安全：服务器需配置防火墙规则，仅开放443端口用于HTTPS通信，并设置IP白名单访问管理后台。
版本功能对比与选型建议
我们提供三个版本以满足不同规模企业的需求。下表详细列出了功能差异，供您决策参考。
| 功能模块 | 标准版（免费） | 专业版（¥99/月） | 企业版（定制报价） |
|---|---|---|---|
| 加班登记卡片 | ✔（基础字段） | ✔（含自动计算） | ✔（全功能+自定义字段） |
| 审批流引擎 | 单级审批 | 多级审批（最多5级） | 无限级+条件分支 |
| HR系统同步 | 手动导出CSV | API自动同步（2个系统） | API自动同步（不限系统） |
| 数据报表 | 基础汇总 | 月度趋势+部门对比 | 自定义BI看板 |
| 技术支持 | 社区支持 | 5×8小时工单 | 7×12小时专属客服+实施服务 |
| 数据保留策略 | 90天 | 2年 | 永久（本地化存储） |
选型建议：50人以下团队且预算有限，标准版即可满足基本记录需求，但需要每月手工处理导出数据。50-500人规模企业，强烈建议选择专业版，其自动同步功能可以彻底释放行政人员每月约10小时的核对工作量。500人以上或对数据合规有严格要求的企业，企业版支持私有化部署，数据不出内网，并支持与现有OA系统深度集成。
使用入门指南：员工视角的快速上手
对于员工而言，整个流程简单直观。以下是标准操作路径：
- 在电脑浏览器中打开WhatsApp网页版，使用手机WhatsApp扫码登录。
- 找到企业HR或管理员创建的"工时管理"对话窗口（或置顶的官方账号）。
- 在输入框中输入"加班登记"或直接点击对话窗口底部的快捷命令按钮。
- 系统将自动推送一张结构化卡片，卡片内包含"开始时间"、"结束时间"、"工作内容简述"、"加班类型"（工作日/休息日/节假日）四个字段。
- 点击各字段进行填写或选择。工作内容简述支持中文输入，建议控制在50字以内，系统会自动过滤敏感词。
- 填写完毕后，点击"提交"按钮。系统会立即显示预计加班时长和计算倍率，确认无误后点击"确认发送"。
- 提交成功后，卡片状态变为"待审批"，审批结果会通过新的消息卡片通知您。若被驳回，您会看到审批人的意见，并可修改后重新提交。
提示：您可以在WhatsApp网页版中置顶该对话窗口，方便随时快速发起登记。所有历史提交记录均以消息形式保留，支持按日期搜索，方便您月底核对个人工时。
常见问题解答（FAQ）
Q1：员工没有智能手机，能否使用WhatsApp网页版进行登记？
可以。WhatsApp网页版首次登录需要手机扫码，但登录后，在浏览器Cookie有效期内（通常为14天），无需再次使用手机。对于长期固定工位的员工，我们建议在办公电脑上保持登录状态。此外，企业版支持通过企业微信或钉钉账号绑定WhatsApp身份，实现无手机扫码登录。
Q2：如果员工在非工作时间忘记登记，第二天可以补录吗？
支持补录。管理员可以在后台设置补录窗口期（默认允许次日上午10点前补录昨天的记录）。补录的卡片会带有"补录"标签，并需要额外填写补录原因。该记录会同步至人力资源系统，但会触发提醒给直属主管进行二次确认。
Q3：系统如何防止员工虚报加班时长？
我们设计了多维度的校验机制。首先，系统会与考勤机的打卡数据进行交叉比对，若加班时间与离岗时间逻辑不符，卡片会标记为"待核实"状态。其次，系统支持设置单日加班上限（如4小时）和月度上限（如36小时），超过阈值需填写详细说明并自动升级至HR审批。最后，所有审批记录和修改痕迹均不可篡改，审计日志保留至少3年。
Q4：数据同步到人力资源系统失败怎么办？
我们的同步模块具备自动重试机制，默认间隔1分钟、5分钟、15分钟重试三次。若三次均失败，系统会向IT管理员发送告警通知，同时卡片状态会显示为"同步异常"。在管理后台的"同步日志"中可查看具体错误原因（如API密钥过期、字段映射错误），修复后点击"手动重放"即可将积压数据重新推送，保证数据最终一致性。
Q5：该产品是否支持多语言界面？
支持。卡片模板和系统通知消息支持中、英、印尼、马来、印地语等9种语言。系统会根据员工WhatsApp账号的界面语言设置自动匹配显示语言。对于跨国团队，员工提交的内容会保留原始语言，但在管理后台可开启自动翻译功能，方便总部HR理解。