将潜在客户列表转换为表单

将一个旧版潜在客户列表迁移为表单 —— Scanova 当前推荐使用的潜在客户捕获构建器。

需要具有 MANAGEMENT_API（或 MANAGEMENT_API_SANDBOX）配额的管理 API 密钥，作为原始 Authorization 标头值发送 —— 参见管理 API 概述。

string

必填

潜在客户列表的 lead_id。无需请求体。

curl --request POST \
  --url 'https://api.scanova.io/lead/L9c2f4a1e/convert/' \
  --header 'Authorization: YOUR_API_KEY'

{
  "id": 512,
  "form_id": "F3b9c1a2",
  "lead_id": "L9c2f4a1e"
}

转换潜在客户列表会：

根据潜在客户列表的字段定义创建一个新表单。
将当前附加到该潜在客户列表的每个 QR 码重新链接到新表单。
将有效的 webhook 迁移到表单的 webhook 机制（潜在客户列表自身的 webhook 会被标记为非活动）。
将为此潜在客户列表配置的任何潜在客户通知迁移为表单通知。
将潜在客户列表标记为 is_converted: true —— 从此刻起，它不再出现在列出潜在客户列表或列出活跃的潜在客户列表中，后续的编辑/条目/导出改为通过表单端点进行。

此操作在幂等性方面并不友好：对已转换的潜在客户列表再次调用转换会返回 404，因为查找会过滤为未转换的列表。没有”撤销”功能 —— 请在重试之前检查 is_converted（通过获取潜在客户列表，转换后该请求将返回 404）。

如果转换后的表单数据意外未通过表单架构验证（一种罕见的形状漂移边缘情况，格式良好的潜在客户列表通常不会触发），则在 data 下返回 400。

相关内容