Zoho CRM自定义Policies模块获取记录返回failure状态求助

在Zoho CRM的Deluge自动化脚本中，调用zoho.crm.getRecordById()获取自定义模块「Policies」的记录时，返回{"status":"failure"}但脚本无报错。调用标准模块Leads、Deals的相同接口可正常返回数据。

已执行的调试步骤 #

• 更换浏览器、重启设备
• 确认模块API名称为「Policies」
• 测试该模块下多条不同记录
• 在其他Zoho CRM实例测试（该实例中Policies模块可正常调用）
• 检查连接权限范围：已配置ZohoCRM.modules.ALL、ZohoCRM.Files.CREATE、ZohoCRM.Files.READ

测试脚本 #

void automation.Test(Int policyid, int dealid, int leadid)
{
    policy = zoho.crm.getRecordById("Policies",policyid);
    info policy;

    deal = zoho.crm.getRecordById("Deals",dealid);
    info deal;

    lead = zoho.crm.getRecordById("Leads", leadid);
    info lead; 
} 

预期与实际结果 #

• 预期：控制台输出三个包含字段及数据的JSON对象
• 实际：仅Policies模块返回{"status":"failure"}，Leads、Deals模块正常返回数据

1. 验证自定义模块的API访问权限
   虽然配置了ZohoCRM.modules.ALL，但需确认CRM后台中该自定义模块是否开启了API访问：

   • 进入Zoho CRM设置 > 自定义模块 > 找到Policies模块 > 编辑模块 > 检查「API访问」选项是否启用

2. 确认记录的可见性权限
   检查当前执行脚本的用户（或关联的集成用户）是否有权限查看目标Policy记录：

   • 登录CRM，手动搜索该Policy记录，确认是否能正常访问
   • 检查用户角色对Policies模块的「查看」权限设置

3. 核对模块API名称的精确性
   自定义模块的API名称可能存在隐性差异，比如：

   • 检查是否有大小写错误（Zoho CRM的模块API名称通常为单数首字母大写，但部分场景可能有复数变体）
   • 在CRM设置 > 自定义模块 > 模块详情中，复制精确的API名称替换脚本中的"Policies"

4. 检查脚本执行上下文的权限
   如果脚本是在特定触发场景（比如工作流、蓝图）中执行，需确认触发上下文的用户是否拥有Policies模块的权限：

   • 切换到拥有管理员权限的用户测试脚本，看是否能正常返回数据

5. 启用API调试日志
   在Zoho CRM设置 > API > API日志中，开启调试日志，查看调用getRecordById时的具体错误信息，这能直接定位失败原因

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