使用 Integrate 需求加速平台,您可以通过 API 自动将销售线索上传到 Integrate 来源。
通过 API 上传销售线索的说明
要准备在任何系统中配置 API,您首先需要从 Integrate 需求加速平台中的特定来源收集 API 详细信息。
请注意:每个 Integrate 来源都有一个唯一的 API 端点。 |
导航到相应的 Integrate 来源,然后滚动到底部,找到交付部分。
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 |
json 示例: POST https://api.integrate.com/post/52117728-34c7-4ded-bb42-981d086956feHTTP/1.1 内容类型:application/json { |
通过 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 |
请注意:此地址在他们发布的销售线索状态发生变化时随时会被调用,因此在销售线索的整个生命周期中可以多次调用此地址。 |
我们发送的消息正文为 mime 类型“application/json”,如下所示。
POST [callback address provided] HTTP/1.1 内容类型:application/json { |
完整请求示例: POST http://somewhere.com/my/lead/statusHTTP/1.1 内容类型:application/json { |