Zoho crm Logo

转换潜在客户

目的

要将潜在客户转化为联系人或账户,请使用潜在客户转化选项API在转化之前识别出在联系人、账户和交易中与潜在客户数据匹配的现有记录。

这有助于防止重复记录,因为它允许您将潜在客户与现有记录关联,而不是使用相同的数据创建新的记录。

端点

  • POST /Leads/{record_id}/actions/convert

{record_id} : 您想转换的潜在客户记录的唯一ID。

Request 详情

Request URL

{api-domain}/crm/{version}/Leads/{record_id}/actions/convert

标题

授权:Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

scope=ZohoCRM.modules.ALL
(或者)
scope=ZohoCRM.modules.leads.CREATE

样本请求

在请求中,“@convertlead.json”包含了样本输入。

与联系人和账户映射的优先顺序

  • 线索模块中没有唯一字段
    • 线索的电子邮件ID将与联系人模块中的电子邮件ID进行比对。
    • 线索的公司将与账户模块中的账户名称进行比对。
    • 线索的姓名将与联系人模块中的姓名进行比对。
  • 唯一字段的存在
    • 优先顺序是首先是联系人模块,然后是账户模块,基于字段映射和布局映射。
    • 如果在联系人模块中没有唯一字段,但在账户模块中存在唯一字段,那么优先顺序将是首先是账户,然后是联系人。
  • 映射标准
    • 联系人:唯一字段1,唯一字段2,或电子邮件(如果电子邮件是唯一的)。
    • 账户:唯一字段1或唯一字段2。

输入 JSON 键

  • overwrite布尔值,可选

    确定在转换潜在客户时是否覆盖联系人中的账户名称。
    例如,如果一个联系人已经与一个账户关联,但是潜在客户的公司名称不同,启用此选项将更新联系人的账户以匹配潜在客户的公司。

    可能的值:

    • false (默认): 保持联系人中现有的账户名称不变。
    • true: 如果联系人关联的账户名称与潜在客户中的公司名称不同,则更新联系人的账户名称。
  • notify_lead_owner布尔值,可选

    指定在转换潜在客户时,是否应向潜在客户所有者发送电子邮件通知。
    可能的值:

    • false (默认): 不发送电子邮件通知。
    • true: 在转换时向潜在客户所有者发送电子邮件通知。
  • move_attachments_toJSON 对象,可选

    指定模块(联系人,交易或账户)的API名称,在转换时应将潜在客户的附件移动到该模块。这确保了在转换后,潜在客户的重要文件和文档被转移到适当的模块。

    可能的值:

    • 联系人:将附件移动到关联的联系人。
    • 交易:将附件移动到关联的交易。
    • 账户:将附件移动到关联的账户。
  • 账户JSON 对象,可选

    它将潜在客户关联到现有账户,而不是在转换过程中创建新账户。通过将潜在客户关联到现有账户,而不是创建重复账户,有助于维护数据一致性。使用 GET - 记录 API 来检索唯一的账户 ID。

  • 联系人JSON 对象,可选

    在转换过程中,将潜在客户与现有联系人关联,而不是创建新的联系人。通过将潜在客户链接到现有联系人,可以避免创建重复的联系人,从而帮助维护数据的一致性。使用 GET - 记录 API 来检索唯一的联系人 ID。

  • assign_toJSON 对象,可选

    为新的联系人和账户分配记录所有者在潜在客户转化后。它确保转化的潜在客户被分配给Zoho CRM中的特定用户。使用GET - 用户API来检索有效的用户ID。

  • 交易JSON 对象,可选

    使用此键来为新创建的账户在潜在客户转化期间创建交易。

    创建新转化记录的交易所需的必填字段:

    • 交易名称:交易的API名称。
    • 预计关闭日期:交易的预期关闭日期。
    • 销售管道:交易所属的销售管道。
    • 阶段:交易在管道中的当前阶段。

    "联系人角色"键让您为在转化时关联的联系人分配角色。发起GET 联系人角色 API调用并传递唯一的联系人角色ID。

  • carry_over_tagsJSON 对象,可选

    在潜在客户转化过程中,使用此键将标签从潜在客户转移到新创建的联系人、账户和交易中。

注意

  • 使用潜在客户转化选项API获取与您想要转化的潜在客户在联系人、账户和交易中有匹配数据的记录。这使您能够转化潜在客户并将其与相关记录关联,而不是使用相同的数据创建新的记录。
  • 在输入中,assign_to的值只能是用户ID。
  • 如果潜在客户未转化为交易,它仍会与您在输入中指定的联系人和账户关联。
  • 如果账户ID和覆盖值都为真,那么账户名称将被公司名称替换,同时将其与现有账户关联。然而,该账户的数据将保持不变。
  • 如果overwrite值设置为false,则只会发生关联。然而,如果你在没有账户ID的情况下设置overwrite值,这个方法的工作方式将保持不变。
  • 您只能在输入中使用字段API名称。您可以从
    • 字段元数据API(每个字段的“api_name”键的值)获取字段API名称,或者转到设置 > 开发者中心 > API和SDK > API名称 > {{模块}}。从“按照”下拉菜单中选择“字段”。

样本输入

可能的错误

  • DUPLICATE_DATAHTTP 400

    重复的数据
    解决方案:在潜在客户中已经存在具有唯一字段详细信息的联系人。确保为唯一字段(系统和用户定义的)指定唯一值。要知道哪些字段是唯一的,请参考字段元数据API。

  • ID_ALREADY_CONVERTEDHTTP 400

    id已经转换
    解决方案:您试图转换的潜在客户已经被转换。请指定一个有效的潜在客户ID。参考获取记录API以获取有效的潜在客户ID。

  • INVALID_URL_PATTERNHTTP 404

    请检查尝试访问的URL是否正确
    解决方案:指定的请求URL不正确。请指定一个有效的请求URL。请参考上述请求URL部分。

  • OAUTH_SCOPE_MISMATCHHTTP 401

    未经授权
    解决方案:您没有正确的范围来访问此API。请在"范围"部分提到的有效范围内创建新的客户端。

  • NO_PERMISSIONHTTP 403

    拒绝创建权限
    解决方案:用户没有创建记录的权限。请联系您的系统管理员。

  • INTERNAL_ERRORHTTP 500

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

  • INVALID_REQUEST_METHODHTTP 400

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

  • AUTHORIZATION_FAILEDHTTP 400

    用户没有足够的权限来创建记录
    解决方案:用户没有创建记录的权限。请联系您的系统管理员。

  • INVALID_DATAHTTP 400

    无效数据
    解决方案:指定的输入不正确。请指定有效的输入。

  • RECORD_LOCKEDHTTP 400

    无法转换尚未获批的记录
    解决方案:请等待Zia图像或合并重复过程完成后再试。

  • RECORD_LOCKEDHTTP 400

    您无法执行此操作,因为记录已被锁定。
    解决方案:请等待记录解锁。

  • NOT_APPROVEDHTTP 400

    无法转换尚未获得批准的记录
    解决方案:

    • 情况1: 如果记录由于Zia图像验证而处于被拒绝状态,可以上传新图像(或)删除失败的图像,然后将记录重新提交给Zia图像验证。
    • 情冁2: 如果记录在Zia记录审批中,系统将不允许您更新记录的图像,除非审查者批准或拒绝记录。

样本回应