Skip to main content
Sign in

通过 API 自动上传销售线索 (Automated Lead Uploads via API)

nasha.gladney
  • Updated

使用 Integrate 需求加速平台，您可以通过 API 自动将销售线索上传到 Integrate 来源。

 

 

通过 API 上传销售线索的说明

要准备在任何系统中配置 API，您首先需要从 Integrate 需求加速平台中的特定来源收集 API 详细信息。

请注意：每个 Integrate 来源都有一个唯一的 API 端点。

导航到相应的 Integrate 来源，然后滚动到底部，找到交付部分。

mceclip0.png

 

POST API 能够以 urlencoded 或 json 构建，因此每个 Integrate 来源均可使用这二者，其示例值分别如下所示。

在相应的 Integrate 来源中找到您要使用的，然后用它来设置您的 API。

urlencoded 示例：

POST https://api.integrate.com/post/52117728-34c7-4ded-bb42-981d086956feHTTP/1.1

内容类型：application/x-www-form-urlencoded

FName=myValue&LName=myValue&Email1=myValue&Phone1=myValue
&Title=myValue&Address1=myValue&Address2=myValue&City=myValue
&Zip=myValue&State=myValue&Country=myValue

json 示例：

POST https://api.integrate.com/post/52117728-34c7-4ded-bb42-981d086956feHTTP/1.1

内容类型：application/json

{
"FName": "myValue",
"LName": "myValue",
"Email1": "myValue",
"Phone1": "myValue",
"Title": "myValue",
"Address1": "myValue",
"Address2": "myValue",
"City": "myValue",
"Zip": "myValue",
"State": "myValue",
"Country": "myValue"
}

 

通过 API 上传销售线索的视频

媒体合作伙伴最常用的两种 API 构建器是 Zapier 和 Postman。因此，我们制作了教学视频，以帮助指导您在这些系统中进行设置。

有关这些第三方平台的设置或故障排除的其他帮助，请联系其支持团队。

    • 通过 API - Zapier 交付销售线索

  • 通过 API - Postman 交付销售线索

 

API 回调响应

通过 API 将数据发布到 Integrate 来源之后，可以提供 2 个回调响应。

第一个回调响应用于在来源中创建记录。

  • 成功的响应包含由 Integrate 的数据库所创建的 leadID：
{ 

"result": [<UNIQUE_GUID_OF_NEW_LEAD>, ...], 

"error": []

}
  • 错误响应类似于下面的信息，还包含相应的错误代码：
{ 

"result": {},

"error": "An error has occurred!"

}

 

在平台中创建记录后，就可以提供第二个回调响应，以显示销售线索是否已被接受、拒绝或失败。

但是，端点应在 POST URL 中提供，并且应接受 JSON POST 请求。下面是请求格式的示例。

POST https://api.integrate.com/post/52117728-34c7-4ded-bb42-981d086956fe?callback=[address here] HTTP/1.1

内容类型：application/x-www-form-urlencoded

FName=myValue&LName=myValue&Email1=myValue&Phone1=myValue
&Title=myValue&Address1=myValue&Address2=myValue&City=myValue
&Zip=myValue&State=myValue&Country=myValue

 

请注意：此地址在他们发布的销售线索状态发生变化时随时会被调用，因此在销售线索的整个生命周期中可以多次调用此地址。

 

我们发送的消息正文为 mime 类型“application/json”，如下所示。

POST [callback address provided] HTTP/1.1

内容类型：application/json

{

"Id": <ORIGINAL GUID OF LEAD>,

"Status": <ONE OF STRING>"accepted", "rejected", "failed",

"Reason": <ADDITIONAL INFORMATION RELATED TO THE STATUS STRING>,

"Timestamp": <ISO 8601 UTC DATE STRING>,

"Code": <ONE OF DISPOSITION CODES> (ex. "SUCCESS", "POSTOUT_SUCCESS",

"REJECT_INVALID_EMAIL", etc.)

}

完整请求示例：

POST http://somewhere.com/my/lead/statusHTTP/1.1

内容类型：application/json

{

"Id": "6953f82c-292e-47a6-989e-2de5b7d4e9a7",
"Status": "rejected",

"Reason": "Address validation failed",

"Timestamp": "2017-01-16T23:55:32+00:00",

"Code": "SUCCESS"

}

Related articles