Zoho crm Logo

将铅的质量转换

目的

在一次API调用中最多可以转换50个线索。您可以通过此API在创建或不创建交易的情况下转换潜在客户。

端点

  • POST /Leads/actions/mass_convert

请求详情

请求 URL

{api-domain}/crm/{version}/Leads/actions/mass_convert

标题

授权: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

scope=ZohoCRM.mass_convert.线索.CREATE

示例请求

Copiedcurl "https://www.zohoapis.com/crm/v8/Leads/actions/mass_convert"
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
-d "@convertlead.json"
-X POST

输入 JSON

  • ids JSON array,必填

    您要转换的线索的记录ID。使用获取记录API来获取记录ID。请注意,此数组中最多可以提供50个记录ID。

  • 交易JSON 对象,当您想要创建交易时是必需的

    必须包含必需的键 "Deal_Name", "Stage", "Closing_Date", 和 "Pipeline"(如果启用),以及为交易模块配置的其他必填字段。请注意,如果存在除标准布局之外的其他布局,自定义定义的必填字段在转换潜在客户时将不会被处理。

  • assign_to JSON object,必填

    要分配已转换潜在客户记录的用户的姓名和ID。使用 获取 Users API 获取这些详细信息。

  • portal_user_type JSON object,optional

    联系人模块的门户名称和ID。

  • related_modules JSON 数组,可选

    模块的 API 名称和 ID,例如任务、会议或电话。如果潜在客户有一个或所有这些相关记录,这些记录的所有者将更改为“assign_to”键中指定的用户。
    使用 模块 API 获取模块的 ID。

  • carry_over_tags JSON 数组,可选

    在转换潜在客户时,您希望将标签关联到的模块的名称和ID。例如,如果您在此数组中提供联系人,潜在客户的标签将被传递到转换后的联系人。使用模块API获取模块的ID。请注意,您可以将标签传递到联系人、交易和Account。

  • move_attachments_to JSON 对象,可选

    在转换后,您希望将潜在客户的附件移动到的模块的名称和ID。使用 模块API 获取模块的ID。请注意,您可以将附件移动到联系人、交易或 Account。

示例输入

Copied{
    "ids": [
        "3652397000009850001",
        "3652397000009851001"
    ],
    "Deals": {
        "Amount": 10000,
        "Deal_Name": "test7000",
        "Closing_Date": "2022-12-20",
        "Pipeline": "Standard(Standard)",
        "Stage": "Needs Analysis"
        
    },
    "carry_over_tags": [
            {
                "id": "3652397000000002179",
                "api_name": "Contacts"
            }
        ],
        "related_modules": [
            {
                "api_name": "Tasks",
                "id": "3652397000000002193"
            },
            {
                "api_name": "Events",
                "id": "3652397000000002195"
            }
        ],
        "assign_to": {
            "id": "3652397000000281001"
        },
        "move_attachments_to": {
            "api_name": "Contacts",
            "id": "3652397000000002179"
        }
    }
}

响应 JSON

  • code

    表示您指定的已安排转换的记录。 可能的值是SCHEDULED。

  • details

    提供批量转换作业的ID。使用此ID在批量转换Status API中。

可能的错误

  • MANDATORY_NOT_FOUNDHTTP 400

    您未指定“交易”中的记录ID或一个或多个必填键,或两者都未指定。
    解决方案:请参阅响应中的“details”键以了解缺失的值。

  • INVALID_DATAHTTP 400

    原因:

    • 记录ID无效。
    • 门户用户类型无效。

    解决方案:

    • 提供要转换的线索的有效ID。请参阅响应中的“details”键以获取错误的详细信息。
  • LIMIT_EXCEEDEDHTTP 400

    您尝试转换超过50个线索。
    解决方案:通过此API,您最多只能转换50个线索。

  • AMBIGUITY_DURING_PROCESSINGHTTP 400

    API 名称和 "related_modules" 键中的 ID 不匹配。
    解决方法:指定正确的相关模块的 API 名称和 ID。

  • INVALID_REQUEST_METHODHTTP 400

    HTTP请求方法类型无效
    解决方案:您指定了一个无效的HTTP方法来访问API URL。请指定一个有效的请求方法。请参阅端点部分。

  • NO_PERMISSIONHTTP 403

    原因:

    • 您没有该模块的权限。
    • 您没有转换线索的权限。

    解决方法: 联系您的系统管理员以获取足够的权限。

  • INTERNAL_ERRORHTTP 500

    内部服务器错误
    解决方法:服务器中出现了意外且未处理的异常。请联系支持团队。

示例响应

Copied{
    "code": "SCHEDULED",
    "details": {
        "job_id": "3652397000009835020"
    },
    "message": "Mass Convert scheduled successfully",
    "status": "success"
}