概述
快手线索接入的操作说明。
开始之前
[!IMPORTANT]
使用有权访问本功能的账号。按下方步骤准备对应的业务数据或配置资料。
操作说明
连接器管理配置
该步骤主要目的是将快手线索 CRM 线索数据同步至平台连接器,连接器需要进行配置并生成用于接收数据的 URL。以下为通用的配置指导,可根据实际情况进行修改。
1 新建连接对象
- 进入快手线索 CRM 连接器,选择连接对象 tab,点击新建按钮。
- 填写「基本信息」,点击添加中间对象。
- 填写中间对象名称,完成后点击保存按钮。
需要单独新建 3 个连接对象,填写信息分别如下:
| 基本信息 | 中间对象 | |||
|---|---|---|---|---|
| ERP 对象名称 | ERP 对象编码 | 拆分类型 | 对象名称 | 拆分类型 |
| 快手销售线索 | kuaishouClue | ERP 对象不拆分,就是独立的中间对象 | 销售线索 | 主对象 |
| 快手市场活动 | kuaishou_marketing | ERP 对象不拆分,就是独立的中间对象 | 市场活动 | 主对象 |
| 快手落地页 | kuaishou_page | ERP 对象不拆分,就是独立的中间对象 | 落地页 | 主对象 |
2 编辑字段
- 点击编辑字段按钮。
- 进入编辑字段页面,点击添加字段,填写字段信息。
各个对象,需要填写字段信息分别如下:
| 中间对象 | 字段名称 | 字段编码 | 字段类型 | 是否必填 |
|---|---|---|---|---|
| 销售线索 | 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 地址
- 点击“销售线索”对象生成 API按钮,进入 API 格式页面。
- 点击如下位置的添加函数按钮。
- 填写描述,点击下一步。
- 复制填写以下函数:
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];//返回数组类型的
- 粘贴复制的函数,并设置参数。
- 完成后保存函数,最后复制如下生成的线索接收 URL,并前往快手线索 CRM 粘贴绑定(具体见 4.配置线索接收 url 至快手后台)。
连接器数据集成流配置
该步骤主要目的是,将快手同步至连接器的数据,按照集成流规则同步至CRM。以下为预设字段的配置指导,需要同步的字段和字段值需根据实际情况进行配置。
- 进入数据集成流页面,点击新建数据集成流添加集成流。
a.添加市场活动集成流
b.添加销售线索集成流
c.添加落地页集成流
- 添加完成后,分别启用各个集成流,即可进行快手线索收集。
配置线索接收 url 至快手后台
- 复制 url 后,需要登录 快手线索CRM后台,输入用户名和密码进入。
- 进入”设置中心“,并找到“线索推送规则”,点击页面右上角“新建推送规则”按钮。
- 设置规则名称,并将以下字段是否推送设置为开启状态。
若需要推送其他字段,纷享销客连接器中对应连接对象和集成流也需要调整。
- 将连接器后台复制的 url 地址填入至推送地址输入框,请求方式选择POST。
Token 设置可不填。
返回状态码 key 设为 errCode,返回状态值 value 设为 s106240000。
筛选条件设置 广告主账号 id 选择 推广账号。
设置完成点击下一步
- 推送测试这里编辑一条测试数据推送成功即可完成。
此处需要将 clue_id 修改为没有推送过的任意整数,手机号需要由 string 类型修改为任意 13 位手机号格式。
填写完成后,点击推送测试按钮即可。
- 完成推送规则新建后,开启该规则。
预期结果与验证
完成上述操作后,在对应页面检查处理结果,并与本步骤的目标核对。
常见问题与故障排除
无法继续操作时,先核对上文说明的条件和输入信息;遇到权限提示时,请管理员确认访问权限。