潜在客户转化选项
目的
在将潜在客户转换为交易、Account或联系之前,获取潜在客户的转换选项。此 API 从Account、联系人和交易中获取匹配的记录。这使您能够正确映射数据并在转换潜在客户时避免任何重复。
端点
- GET /Leads/{record_id}/__conversion_options
请求详情
请求 URL
{api-domain}/crm/{version}/Leads/{record_id}/__conversion_options
标题
授权: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
范围
scope=ZohoCRM.modules.ALL
(或)
scope=ZohoCRM.modules.Leads.{operation_type}
可能的操作类型
全部 - 完全访问记录
读取 - 从模块获取记录
示例请求
Copiedcurl "https://www.zohoapis.com/crm/v8/Leads/3652397000007526001/__conversion_options"
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
-X GET响应 JSON 键
- module_preference JSON object
与潜在客户数据最匹配的模块的 API 名称和 ID。
- Contacts JSON Array
表示与潜在客户匹配的联系人的详细信息。
- preference_field_matched_value JSON object
表示与潜在客户匹配的联系人的字段和值等详细信息以及Account。
- modules_with_multiple_layouts JSON array
表示与潜在客户匹配并包含多个布局的模块的 API 名称和 ID。
可能的错误
- NO_CONTENTHTTP 204
未找到匹配的Account或联系人,并且在Account、联系人和交易中没有自定义布局,或者Account、交易或联系人已从“组织模块”中移除。
- INVALID_DATAHTTP 400
给定的ID似乎无效。
解决方案:请指定一个有效的潜在客户ID。 - NOT_APPROVEDHTTP 400
记录未被批准
解决方案:潜在客户记录正在审批过程中,等待批准。 - RECORD_LOCKEDHTTP 400
合并中的记录被锁定
解决方案:记录正在进行合并操作。请等待合并操作完成。
示例响应
Copied{
"__conversion_options": {
"module_preference": {
"api_name": "Accounts",
"id": "3652397000000002177"
},
"Contacts": null,
"preference_field_matched_value": {
"Contacts": null,
"Accounts": [
{
"field": {
"api_name": "Account_Name",
"id": "3652397000000002425"
},
"matched_lead_value": "Zylker"
}
]
},
"Accounts": [
{
"Layout": {
"name": "Standard",
"id": "3652397000000091029"
},
"Phone": "555555555",
"Account_Type": "Analyst",
"Website": null,
"Account_Name": "Zylker",
"$editable": true,
"id": "3652397000000624046"
}
],
"modules_with_multiple_layouts": [
{
"api_name": "Accounts",
"id": "3652397000000002177"
}
]
}
}