将铅的质量转换
目的
在一次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"
}