巨量引擎/企业号/飞鱼线索接入

若是使用巨量引擎平台自身的表单（橙子建站）或者抖音企业号收集的表单信息，可以通过飞鱼线索CRM将线索数据同步至纷享销客CRM。

前往飞鱼CRM，将使用头条自己的建站工具生成的线索自动同步到CRM销售线索池，并自动关联巨量引擎广告组、广告计划。

支持同步的线索

推送配置入口：设置>API设置>线索推送规则>新建规则。

A.设置标准字段：以下五个为必须设置参数，且映射字段的api名称不允许修改，如果还需要获取其他相关参数也可以选择新增，右侧映射字段填写CRM销售线索里面的对应字段apiName名称。简单一对一的参数可以直接通过此映射插入线索。若有复杂多选或单项配置，需要写函数映射。

原始字段名称	映射字段
线索id（id）	填写固定值“clueId”，此处不需要找CRM线索字段的apiname，固定值即可
姓名（name）	填写CRM中姓名字段的apiname，一般为“name”
电话（telphone）	填写CRM中电话字段的apiname，需注意在CRM中使用的是“mobile”还是“tel”
创建时间（adv_id）	填写固定值“create_time”，此处不需要找CRM线索字段的apiname，固定值即可
计划id（ad_id）	若使用头条广告旧版做投放，则填写固定值“ad_id”，此处不需要找CRM线索字段的apiname，固定值即可
广告id（promotion_id）	若使用头条广告新版做投放，则填写固定值“promotion_id”，此处不需要找CRM线索字段的apiname，固定值即可
广告主id（adv_id）	填写固定值“accountId”，此处不需要找CRM线索字段的apiname，固定值即可

B.表单字段和行业字段可以不设置，有需求可以类似配置。例如在表单中需要客户填写一些信息，比如姓名、电话、职位、行业，则需要填写表单的字段（注意：需要一字不漏，才能识别到表单字段），右边则填写CRM系统中对应线索需要映射的字段的apiname。

用户填写的表单字段，可以通过以下路径查找：

C.自定义字段设置：

字段名	具体值
ea	必填。纷享企业账号，在管理页右上角可以获取
source	销售线索中“来源字段”的具体选项apiName，此处可选头条广告选项的apiName
adSource	必填。固定值字段“巨量引擎”
leads_pool_id	非必填。销售线索中“线索池”的具体选项apiName
funApiName	非必填。映射后台配置的函数名，函数可以支撑多选项相关映射
其他必填字段apiName	非必填。其他必填字段，比如：销售线索中有必填字段公司company，但是飞鱼线索中可能没有这个字段，为了保证线索顺利保存到CRM销售线索，可以设置一下默认值如“未知”
record_type	非必填。该项为“业务类型”，若CRM有较多必填项，但是表单字段较少，可以单独给广告同步的线索设置一个单独业务类型，广告同步的线索仅设置几个表单字段为必填项

字段设置完成后点击下一步。

服务设置：秘钥和token不填

http_post url：

https://www.fxiaoke.com/marketing/adThridCallBack/recvData

筛选条件：看具体需求，没需求可不设置

失败通知：可以设置失败了通知相关责任人

完成后点击下一步。

数据格式不能采用默认格式需要改成带data的格式,其中函数名称、企业账号ID、线索ID、adSource、funApiName （如有）不放到data中，其他需要传递参数均放入data中。如下示例：

{
  "funApiName":"函数名称",
  "ea": "企业账号ID",
  "clueId": "",
  "adSource": "巨量引擎",
  "data": {
    "name": "",
    "mobile": "",
     "create_time": "",
     "source": "naask_kakd",
     "ad_id": "",
     "company":"未知",
     "promotion_id": ""
  }
}

注意：如果标准字段修改过，这里推送格式也要修改。数据格式不懂怎么调整的话，可以联系客户经理协助配置。

返回状态修改成以下两个英文符：

状态码key：errCode

消息key：errMsg

完成后点击下一步。

点击发送测试。

检查线索是否进入CRM中，若没有进入，则前往【营销通】-【系统设置】-【线索设置】-【营销线索同步日志】查看线索是否进入营销通。

如图所示，同步失败的原因是因为线索重复，若线索基于手机号查重，则可尝试修改手机号码或线索ID，重新测试推送。

解决完失败的原因后，再次测试同步，同步成功，即可启用规则开关。

例子1：客户表单中有一个字段“客户爱好”，有四个选项A，排球 B，足球 C，羽毛球 D，乒乓球每个用户提交的线索，表单中的值都不一样，加入用户1选的是A,B,C，那么映射规则的客户爱好字段值是“A,B,C", 但是CRM销售线索的"客户爱好”多选项是不接受"A,B,C"的，需要做选项值的映射；

创建完自定义函数后，需要将自定义函数的apiname在飞鱼映射中做配置（当数据推送到CRM时，识别到有配置函数，则数据进CRM时会执行函数，调整数据格式以便存入CRM），如下：

自定义函数示例：

参考代码：

String companyEmployees__c=Data["companyEmployees__c"];

switch (companyEmployees__c)
    {
        case "200人以下":
            Data.put("companyEmployees__c", "1");
            break;
        case "200-500人":
            Data.put("companyEmployees__c", "2");
            break;
        case "500-1000人":
            Data.put("companyEmployees__c", "3");
            break
        case "1000-5000人":
            Data.put("companyEmployees__c", "4");
            break;
        case "5000人以上":
            Data.put("companyEmployees__c", "5");
            break;
        default:
            Data.put("companyEmployees__c", "other");
    }
return Data

同单选字段一样，创建完自定义函数后，需要将自定义函数的apiname在飞鱼映射中做配置（当数据推送到CRM时，识别到有配置函数，则数据进CRM时会执行函数，调整数据格式以便存入CRM），如下：

参考代码：



String city = Data["aaaa"];

List city_list = ["长沙市"]  //Data["companyEmployees__c"];
city_list.add(city)
List to_crm = []

city_list.each { item -> 
  log.info(item)
  switch (item)
    {
        case "均可":
            to_crm.add("4vrsE2Rka")
            break;
        case "长沙市":
            to_crm.add("UgM1z8f6m")
            break;
        case "株洲市":
            to_crm.add("2mOF48nqO")
            break
        case "湘潭市":
            to_crm.add("k8wwo8s8H")
            break;
        case "娄底市":
            to_crm.add("yY1X1Qi22")
            break;
         case "邵阳市":
            to_crm.add("J2O9za4f5")
            break;
        default:
            break;
    }

} 
log.info(to_crm)
Data.put("field_YwIf8__c",to_crm)

return Data