ZOHO timesheet webhook未触发问题咨询，求运行逻辑及正确配置方法

ZOHO Timesheet Webhook 运行逻辑 #

• ZOHO 全系列产品的Webhook属于执行动作组件，本身不具备自动监听事件的能力，必须和对应业务的工作流规则绑定后，才会在符合规则的事件发生时触发推送。
• 不同ZOHO产品的工时对应触发实体不同：
  • ZOHO Projects 工时提交对应 Timelogs 实体的状态变更事件
  • ZOHO People 考勤工时表提交对应 Timesheet 实体的提交动作事件
• 推送成功的前置要求：接收URL必须为公网可访问地址、无额外的跨域/身份拦截（或已在Webhook配置中提前传入合法的身份校验参数）、接收后返回200/201类成功状态码，否则ZOHO会判定推送失败，连续失败多次后会暂时停止向该地址推送。

必选遗漏配置步骤 #

你目前只完成了Webhook动作的创建，缺少和工作流绑定的核心配置，完整配置流程如下：

1. 进入路径 Zoho->Setting->Automation->Workflow Rules 新建工作流规则
   • 若使用ZOHO Projects：规则关联实体选择 Timelogs，触发条件选择「当记录创建或编辑时」，额外添加过滤条件 Status = Submitted 即可仅在用户提交工时时触发
   • 若使用ZOHO People：规则关联实体选择 Timesheet，触发条件选择「记录动作->提交」
2. 工作流规则的执行动作选择你之前已经创建好的对应Webhook，保存规则后务必开启「启用」开关
3. 调整工作流的生效范围，覆盖所有需要触发工时推送的用户/部门，避免权限不足导致规则不触发
4. 检查Webhook的请求配置：请求方法选择POST，按照你数据库接收端的要求配置请求头、参数格式，不要直接使用默认FormData格式除非你的接收端明确支持。

快速排查方案 #

• 进入Webhook的执行日志页，若没有任何推送记录，说明工作流规则未触发，优先检查规则的启用状态、触发条件、生效范围
• 若存在报错日志：4xx类错误对应接收端参数/身份校验失败，5xx类错误对应接收端服务不可用，超时错误对应接收端响应超过ZOHO的15秒上限，对应排查即可
• 可先用Postman模拟ZOHO的请求参数发往你的接收URL，确认接收端运行正常后，再在ZOHO侧做测试提交。

内容的提问来源于stack exchange，提问作者user12277274