快手线索接入

概述

快手线索接入的操作说明。

开始之前

[!IMPORTANT]
使用有权访问本功能的账号。按下方步骤准备对应的业务数据或配置资料。

操作说明

见 线索收集连接器开通和配置入口。

连接器管理配置

该步骤主要目的是将快手线索 CRM 线索数据同步至平台连接器,连接器需要进行配置并生成用于接收数据的 URL。以下为通用的配置指导,可根据实际情况进行修改。

1 新建连接对象

  1. 进入快手线索 CRM 连接器,选择连接对象 tab,点击新建按钮。

  1. 填写「基本信息」,点击添加中间对象。

  1. 填写中间对象名称,完成后点击保存按钮。

需要单独新建 3 个连接对象,填写信息分别如下:

基本信息 中间对象
ERP 对象名称 ERP 对象编码 拆分类型 对象名称 拆分类型
快手销售线索 kuaishouClue ERP 对象不拆分,就是独立的中间对象 销售线索 主对象
快手市场活动 kuaishou_marketing ERP 对象不拆分,就是独立的中间对象 市场活动 主对象
快手落地页 kuaishou_page ERP 对象不拆分,就是独立的中间对象 落地页 主对象

2 编辑字段

  1. 点击编辑字段按钮。

  1. 进入编辑字段页面,点击添加字段,填写字段信息。

各个对象,需要填写字段信息分别如下:

中间对象 字段名称 字段编码 字段类型 是否必填
销售线索 id id 主键字段 是
姓名 consumer_name 文本 是
电话 phone 手机 是
线索提交时间 create_time 日期时间 是
市场活动 id marketingId 查找关联:市场活动 是
市场活动 id id 主键 是
推广计划名称 campaign_name 文本 是
线索提交时间 createTime 日期时间 是
负责人 principal 人员 是
落地页 id id 主键 是
落地页名称 page_name 文本 是
落地页 url source_url 文本 是
负责人 principal 人员 是

3 插入函数,生成 API 地址

  1. 点击“销售线索”对象生成 API按钮,进入 API 格式页面。

  1. 点击如下位置的添加函数按钮。

  1. 填写描述,点击下一步。

  1. 复制填写以下函数:
log.info("请求参数:"+Fx.json.toJson(syncArg))
String dataStr=syncArg["objectData"]["pushData"];
Map map=Fx.json.parse(dataStr);
List resultList=[];
  //快手市场活动
Map<String,String>kuaishou_marketing=[:];
String campaign_name=map["campaign_name"];
kuaishou_marketing.put("campaign_name",campaign_name);
String create_time=map["create_time"];
kuaishou_marketing.put("create_time",create_time);
String planName=map["campaign_name"];
String marketingId = Fx.crypto.MD5.encode(planName);
kuaishou_marketing.put("id",marketingId);
kuaishou_marketing.put("principal","10000");
resultList.add(["objAPIName":"kuaishou_marketing","masterFieldVal":kuaishou_marketing])


     //营销线索
Map<String,String>kuaishouClue=[:];
String clueId=map["clue_id"];
kuaishouClue.put("id",clueId);
String phone=map["phone"];
kuaishouClue.put("phone",phone);
String consumer_name=map["consumer_name"];
kuaishouClue.put("consumer_name",consumer_name);
kuaishouClue.put("create_time",create_time);
kuaishouClue.put("marketingId",marketingId);
resultList.add(["objAPIName":"kuaishouClue","masterFieldVal":kuaishouClue])


    //落地页
Map<String,String>kuaishou_page=[:];
String sourceUrl=map["source_url"];
kuaishou_page.put("source_url",sourceUrl);
String sourceUrlId = Fx.crypto.MD5.encode(sourceUrl);
kuaishou_page.put("id",sourceUrlId);
String page_name=map["page_name"];
kuaishou_page.put("page_name",page_name);
kuaishou_page.put("principal","10000");
resultList.add(["objAPIName":"kuaishou_page","masterFieldVal":kuaishou_page])

return ["dataList":resultList];//返回数组类型的

  1. 粘贴复制的函数,并设置参数。

  1. 完成后保存函数,最后复制如下生成的线索接收 URL,并前往快手线索 CRM 粘贴绑定(具体见 4.配置线索接收 url 至快手后台)。

连接器数据集成流配置

该步骤主要目的是,将快手同步至连接器的数据,按照集成流规则同步至CRM。以下为预设字段的配置指导,需要同步的字段和字段值需根据实际情况进行配置。

  1. 进入数据集成流页面,点击新建数据集成流添加集成流。

a.添加市场活动集成流

按如下图选择源系统/源对象和目标系统/目标对象。

点击【字段映射】进行同步至CRM的字段映射配置。

b.添加销售线索集成流

c.添加落地页集成流

  1. 添加完成后,分别启用各个集成流,即可进行快手线索收集。

配置线索接收 url 至快手后台

  1. 复制 url 后,需要登录 快手线索CRM后台,输入用户名和密码进入。

  1. 进入”设置中心“,并找到“线索推送规则”,点击页面右上角“新建推送规则”按钮。

  1. 设置规则名称,并将以下字段是否推送设置为开启状态。

若需要推送其他字段,纷享销客连接器中对应连接对象和集成流也需要调整。

  1. 将连接器后台复制的 url 地址填入至推送地址输入框,请求方式选择POST。

Token 设置可不填。

返回状态码 key 设为 errCode,返回状态值 value 设为 s106240000。

筛选条件设置 广告主账号 id 选择 推广账号。

设置完成点击下一步

  1. 推送测试这里编辑一条测试数据推送成功即可完成。

此处需要将 clue_id 修改为没有推送过的任意整数,手机号需要由 string 类型修改为任意 13 位手机号格式。

填写完成后,点击推送测试按钮即可。

  1. 完成推送规则新建后,开启该规则。

预期结果与验证

完成上述操作后,在对应页面检查处理结果,并与本步骤的目标核对。

常见问题与故障排除

无法继续操作时,先核对上文说明的条件和输入信息;遇到权限提示时,请管理员确认访问权限。

2026-10-09
0 0