如何通过Qlik Sense REST连接器实现Zoho CRM与Qlik Sense的对接？

一、准备Zoho CRM API授权凭证 #

要通过REST API访问Zoho CRM，需先获取OAuth2.0授权信息：

• 登录Zoho开发者控制台，创建服务器端应用（适配Qlik Sense后端访问场景）。
• 应用创建完成后，记录客户端ID和客户端密钥。
• 生成刷新令牌：进入应用详情页的OAuth选项卡，通过授权码流程生成令牌，需勾选Zoho CRM相关权限（如ZohoCRM.modules.ALL、ZohoCRM.settings.ALL，按需选择）。
• 注意：使用Zoho中国区服务时，所有API域名需替换为.cn后缀（如accounts.zoho.com.cn、www.zohoapis.com.cn）。

二、在Qlik Sense中配置REST连接器 #

1. 打开Qlik Sense Hub，创建新应用并进入编辑模式。
2. 打开数据加载编辑器，点击数据加载 > 创建新连接 > REST。
3. 在REST连接器配置页完成以下设置：
   • 基本设置：
     • 输入连接名称（如Zoho_CRM_Connection）。
     • 填写Zoho CRM的API端点（示例：https://www.zohoapis.com/crm/v2/Leads，可替换为Contacts、Accounts等其他模块）。
   • 认证：
     • 选择OAuth2.0作为认证类型。
     • 填入客户端ID、客户端密钥、刷新令牌。
     • 填写令牌URL：国际区用https://accounts.zoho.com/oauth/v2/token，中国区用https://accounts.zoho.com.cn/oauth/v2/token。
     • 勾选自动刷新令牌，避免手动更新过期令牌。
   • 请求设置：
     • 请求方法选GET（如需写入数据可选POST/PUT，集成初期优先做数据加载）。
     • 可添加查询参数（如fields=First_Name,Last_Name,Email）指定返回字段，减少冗余数据。

三、测试连接并加载数据 #

1. 配置完成后点击测试连接，确认能正常获取Zoho CRM的API响应。
2. 测试通过后点击插入脚本，将REST连接脚本导入数据加载编辑器。
3. 解析JSON响应：Zoho CRM返回嵌套JSON结构，需用Qlik Sense脚本函数处理，示例脚本如下：

LIB CONNECT TO 'Zoho_CRM_Connection';

// 获取API响应
RestConnectorMasterTable:
SQL SELECT 
    "data"."First_Name" AS "First_Name",
    "data"."Last_Name" AS "Last_Name",
    "data"."Email" AS "Email",
    "data"."Owner"."name" AS "Owner_Name"
FROM JSON (wrap on) "root"
WITH (
    URL 'https://www.zohoapis.com/crm/v2/Leads',
    HTTPHEADER "Authorization" "Bearer $(AccessToken)"
);

// 清理临时表
Drop Table RestConnectorMasterTable;

4. 点击加载数据，完成Zoho CRM数据到Qlik Sense的导入。

四、常见注意事项 #

• API速率限制：Zoho CRM API有调用频次限制，数据量大时建议分批加载或调整请求间隔。
• 模块端点差异：不同CRM模块的API端点不同，需参考Zoho CRM官方文档确认对应模块URL。
• 令牌失效：若自动刷新仍失败，需重新生成刷新令牌（可能因权限变更或令牌到期）。

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