Zoho crm Logo

潜在客户转化选项

目的

在将潜在客户转换为交易、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"
            }
        ]
    }
}