营销插件开通与连接器入口

概述

营销插件开通与连接器入口的操作说明。

营销通的渠道接入、能力扩展和治理组件都通过插件和连接器两类入口管理。插件决定某个能力是否对当前企业开放并显示在营销通菜单中，连接器则负责与外部平台的账号授权、字段映射和数据流转。管理员按需开通插件、配置连接器，才能让渠道数据真正进入 CRM。

开始之前

• 已购买纷享 CRM 和对应版本的营销通产品。
• 拥有营销通应用管理员或 CRM 系统管理员权限。
• 已确认要接入的渠道、平台账号和所需的外部平台管理员账号。
• 已确认对应插件或连接器是否在已购买范围内，未购买的插件需要先联系客户经理或 CSM 增购。

进入营销插件中心

1. 使用营销通管理员账号登录纷享销客。
2. 进入 营销通 > 系统管理 > 营销插件。
3. 在插件列表中定位需要启用的能力，打开对应开关。
4. 关闭不再使用的插件，避免无关菜单和数据写入。

插件列表中常见的插件包括：

插件	作用
百度广告	绑定百度营销账号、同步投放数据并承接线索
腾讯广告	绑定腾讯广告账号、同步投放数据并承接线索
直播对接	接入保利威、小鹅通、目睹、微信视频号等直播平台
企微营销	连接企业微信，打通客户、员工和侧边栏能力
公众号营销	绑定认证服务号，使用渠道二维码和模板消息
WhatsApp 营销插件	绑定 WhatsApp Business API 或个人号、商户号对接
小红书线索	承接小红书表单和私信线索
广告效果数据回传	将 CRM 线索转化结果回传给广告平台
营销数据隔离	按使用人员限制营销数据、账号和分析范围

不同版本的插件清单和命名可能不同，应以当前环境的实际菜单为准。部分插件需要单独购买订单后才能打开。

开通线索收集连接器

广告平台、落地页和第三方建站工具的线索，多数通过线索收集连接器接入。

1. 进入 营销通 > 系统设置 > 线索收集。
2. 在连接器列表中找到目标连接器，打开开关，完成开通。
3. 点击 前往配置，进入 连接器管理 页面。
4. 也可以从 设置 > ERP 数据同步 > 连接器管理 进入同一页面，再选择要配置的连接器。

连接器管理是后续配置连接对象、字段映射和数据集成流的统一入口。

配置连接对象与数据映射

连接器开通后，还需要完成数据落地配置：

1. 在连接器内新建连接对象，填写对象编码和对象名称。对象编码通常使用外部平台的页面 ID 或表单标识。
2. 按外部平台返回的字段，增加对应的连接对象字段。字段编码应与外部平台字段保持一致。
3. 将连接对象字段映射到 CRM 销售线索字段，映射时注意字段类型和选项值的一致性。
4. 按平台要求配置数据集成流，设置同步方式和执行频率。
5. 在外部平台填写连接器生成的 Webhook 地址或 API 地址，完成数据推送配置。

验证插件与连接状态

1. 在插件中心确认目标插件处于开启状态，营销通菜单中能正常进入对应版块。
2. 在连接器管理中确认连接对象、字段和集成流均已保存。
3. 从外部平台提交一条测试数据，确认能生成 CRM 销售线索并正确写入字段。
4. 检查线索是否关联了预期的广告计划、关键词或来源信息。
5. 需要广告回传的场景，在回传明细中确认回传记录。

插件与连接器的职责区分

• 插件控制能力开关和营销通内的功能入口。
• 连接器和连接对象控制外部平台的数据接入和字段落地。
• 账号授权、平台侧配置需要在对应外部平台完成，营销通只负责保存授权结果和接收数据。

维护建议

• 人员或平台账号变更后，及时检查插件开关、连接器授权状态和数据集成流。
• 外部平台表单字段发生变化时，同步更新连接对象字段和字段映射，否则新增字段无法写入 CRM。
• 关闭插件前确认没有正在使用的渠道和存量数据同步任务。
• 定期清理不再使用的连接器和连接对象，保留必要的配置记录。

营销通扩展与开放能力

概述

基于纷享销客 PaaS、BI、集成、开放平台能力，营销通提供了强大的企业营销业务定制能力，通过可配置化、低代码等方式灵活支撑企业个性化营销业务。如自定义业务流程、字段、对象、布局、权限及个性化代码开发等

可视化配置后台

业务定制平台（PaaS）

登录管理后台后可以个性化配置企业基础信息、角色、权限、对象、字段、布局等。下方仅介绍营销场景下可能使用的相关能力，具体细节可以前往  业务定制平台(PaaS) 了解更多

常用场景 1：权限配置

营销通中的使用成员主要对应的 CRM 管理后台的市场管理者市场人员SDR 人员广告运营管理员企微运营管理员，可以在这里维护这些具体角色对市场活动群发推广企微及广告相关业务对象的查看及操作权限。

相关业务对象的数据权限配置，比如指定哪些角色，人员可以看哪些部门的企微好友数据。

常用场景 2：对象配置

营销通中部分业务数据存储在预设的业务对象中，比如营销通中的活动营销直播营销会议营销目标人群运营广告计划均存在市场活动业务对象，短信、邮件、公众号、企微、Whatsapp 的群发任务全部记录在营销活动业务对象，所有渠道获取的表单提交数据在销售线索对象，企微相关的客户、客户群、员工也在相应对象中。

营销通目前所有存入在 CRM 中的业务对象（可以使用平台的 BI、流程、布局、权限等各种配置能力）：

涉及对象	用途
客户	CRM 中维护的客户信息，一般是企业
销售线索	CRM 中存的各种来源的销售线索信息，包括待清洗和跟进中的，后续可以转化成客户、联系人
联系人	CRM 中维护的联系人信息，一般是企业下的业务联系人
微信用户	同步的微信公众号粉丝及授权过的微信访客
会员	通过导入、或者自己提交表单注册的会员，也可以把没有 CRM 账号的员工伙伴注册到会员，实现全员营销
落地页	同步广告投放中的落地页
落地页访问明细	同步用户提交表单所使用营销通微页面、基木鱼落地页、官网落地页的每日 PV、UV 数据
广告回传明细	记录每条线索回传的数据
营销关键词	同步头条、百度广告平台投放的关键词数据
关键词投放明细	同步广告平台关键词的展点消数据
关键词投放计划	将同步的关键词和投放计划名称拼接起来作为对象
企业微信客户	企业微信外部联系人，同步企微客户数据，一个客户被多个员工加仅存一条记录
企业微信员工	同步企业微信后台安装的营销助手应用可见范围员工
企微好友	同步员工加客户的记录表，一个客户被多个员工加有多条记录
企业微信客户群	同步企微的所有客户群信息
企微客户群成员	同步每个群里的群成员信息，有外部客户、未加好友的群成员、员工
企微客户统计	同步企微接口的员工加客户，聊天客户，删除客户好友数据，用于 BI 统计
企微客户群统计	同步企微接口的群主的群数，聊天群数，建群退群人数
市场活动	直播、广告计划、会议、活动营销、目标人群运营所有的活动存储到此对象
营销活动	营销通发起的群发、推广任务及主动推广的雷达，比如短信群发、朋友圈发送，邮件发送，全员营销，伙伴营销发送记录
活动成员	参与活动的线索客户或联系人的参与记录
市场活动费用	记录活动申请的预设相关数据
市场活动费用明细	记录活动中每一笔花费信息
员工推广明细	用于统计全员营销数据去做报表，每天凌晨同步前一天数据
内容传播明细	用于统计内容传播数据去做报表，每天凌晨同步前一天数据
营销内容库	目前仅存储个人资料库中上传的物料信息
营销内容管理日志	营销通素材增删改查操作日志存储
用户行为记录	用于记录所有用户的全渠道行为记录明细
营销推广来源	记录会员、线索、活动成员、企微客户、微信用户的来源信息，比如推广渠道，推广人等
营销线索同步记录	营销通从不同渠道获取的线索同步至 CRM 的日志记录
短信发送记录	营销通作为平台能力将所有发送记录存储到此对象，用于个业务团队查询
邮件发送明细	营销通所有发送的邮件记录
WhatsApp 发送明细	营销通所有发送的 WhatsApp 记录

在这里可以配置自定义字段、自定义按钮、自定义的查重规则、自定义的新建、编辑、详情页展示布局、权限等。

除了预设的业务对象外，还可以基于实际业务使用需求，新建自定义的业务对象，比如有一批线下展厅，需要在系统中维护展厅基础信息、预约记录、接待记录、礼品费用等，就可以使用自定义对象搭建后在系统中完成闭环。

营销通的微页面映射字段，可以选到存入自定义对象中。比如做调查问卷，就可以通过营销通表单收集数据到这个对象，然后在 CRM 那个菜单中查看记录

常用场景 3：审批流程配置

营销通中，可以配置活动或者推广需要完成审批后才能正常推广和发送，使用的针对市场活动****营销活动配置个性化审批流程实现。也可以扩展到其他的业务，比如自定义对象搭建的展厅参观也是可以配置审批流程

常用场景 4：工作流配置

基于业务对象的新建、删除、字段更新配置个性化的业务后动作，类似营销通中 SOP 能力，但是完全可以使用 CRM 中业务字段做触发，比如创建订单后发送发货通知等。结合 APL，也可以结合营销通 SOP 使用，具体参考 CRM 流程与营销 SOP 对接指南

常用场景 5：线索池配置

市场部一般会有 SDR 专用的待清洗线索池****线索培育线索池接收多渠道需要清洗验证及培育的线索，然后结合区域或者行业销售的线索池，做线索的自动分配与流转。如果清洗有效的线索进入湖北大区线索池，完成自动分配。

常用场景 6：行为及属性打分规则设置

基于用户的基本字段、相关数据统计、用户行为，给用户打分、打标签或赋值哪个字段，用于精细化运营

常用场景 7：工商信息设置

营销通微页面表单组件上的公司查询遵循此处逻辑，若搜索到很多个人或者注销的企业，可以在此勾选后不查询个人和注销企业信息

常用场景 8：伙伴营销中的伙伴通讯录设置

营销通伙伴营销中的伙伴企业通讯录，都是选的这里的互联企业，默认给企业下的所有互联用户发送推广任务。也可以在这里设置企业分组用于营销推广

常用场景 9：绑定公众号及配置公众号菜单

可以在此绑定新的公众号，绑定完成后在这里设置菜单，模版消息功能已经迁移，可以忽略。

常用场景 10：设置应用菜单

可以维护预制的 CRM 应用的菜单，在 CRM 中使用营销通相关功能，也可以完全基于营销通的菜单独立组装一个新的自定义应用

智能分析平台（BI）

在 CRM 菜单下的数据分析模块，除了系统预制了很多数据报表外，还可以在这里自定义报表及数据驾驶舱。营销通活动、广告、企微、线索、营销动态等业务数据已经默认注册到 BI 中，可以选到相关业务对象做报表。下方仅介绍营销场景下可能使用的相关能力，具体细节可以前往  智能分析平台概述  了解更多

需要对内容的访问情况、官网的页面访问情况做分析，可以选择用户行为记录对象做数据报表

数据集成平台（连接器）

在 CRM 管理后台中，集成平台负责与外部系统的双向同步管理，已经预制了很多第三方系统的链接工具，营销通中的广告线索同步基本都使用了连接器能力，同步广告相关数据，下方仅介绍营销场景下可能使用的相关能力，具体细节可以前往  纷享集成平台概述  了解更多

开发能力集成

纷享系统内后端代码开发（APL）

在纷享销客系统中，直接编写后端业务代码，灵活处理业务逻辑，比如通过营销通表单提交的数据需要查询系统中是否有历史数据再返回具体的页面，下方仅介绍营销场景下可能使用的相关能力，具体细节可以前往  纷享开发者手册  了解更多

函数 1：调用营销通 SOP 执行后动作

使用场景：

如在 CRM 审批流程、工作流、业务流中可以调用营销 SOP 函数，来触发营销 SOP 执行后动作。如客户对象上的流失风险字段值由低变为高时，可以触发运营任务给相关员工，通知员工发送相关物料及话术给客户挽回客户。

函数示例：

具体见：CRM流程与营销SOP对接指南

函数 2：查询上一步 SOP 发送的企微群发消息送达结果

使用场景：

调用 SOP 发送企微消息推送任务后，会给相关企微员工发送任务通知，员工点击发送后，发送给客户，用于查询员工发送及送达状态

参数说明：

send_sop_id   上一步执行 SOP 后返回的执行 ID

函数示例：

String send_sop_id__c=context.data.send_sop_id__c//    发送ID
def(boolean error1, List data1, String message1) = Fx.biz.callAPI("Fx.marketing.sop.send.result", send_sop_id__c)
  if (error1) {
    log.info("message1" + message1)
  } else {
    log.info("message1" + message1)
    log.info("error1" + error1)
    log.info("data1: " + data1)}

函数 3：通过外部的 openid 或 unionid 关联营销用户

使用场景：

历史客户、线索等数据，已知对象和公众号粉丝、企微客户绑定关系的场景下，针对历史数据做营销用户身份绑定操作。如之前部分客户有观看过小鹅通直播，小鹅通有收集客户的微信身份信息，期望做数据绑定，且自动关联到企微侧边栏

参数说明：

参数名	apiName	是否必填	类型	说明
粉丝 openid	openId	与 unionid 不同时为空	String	公众号粉丝 openid
微信用户 unionid	unionId	与 openid 不同时为空	String	绑定同一个开放平台的微信 unionid
对象 Api 名称	apiName	是	String	对象的 apiName，仅能传递营销通默人 6 大对象加营销通系统设置中加的自定义营销用户对象
对象 id	objectId	是	String	具体需要关联的对象的 ID

函数示例：

涉及风险操作，请联系 CSM 同学获取

函数 4：创建专属企微活码

使用场景：

品牌方下游有多个代理商，代理商对终端门店老板进行品牌产品售卖，品牌方提供代理通系统给代理商用，存储了终端门店的客户信息， 品牌方计划对系统内的终端客户做精细化运营，如新品推广等，提升品牌整体业绩，但是通过短信运营，触达率相对较低。在此背景下，通过企微一客一码能力，通过企微触达运营终端门店客户。基于 CRM 中低代码能力，通过 APL 给库中所有终端门店客户生成携带客户唯一标识的企微员工活码。将此活码通过代理通应用共享给到下游负责的代理商。代理商在与门店进行的日常拜访、铺货过程中，提供唯一码给客户添加企微好友。扫码添加品牌方的企微客服后，系统自动关联当前企微好友与系统中的客户数据。后期基于客户上的属性字段，进行精准运营，扩大品牌曝光及助力业绩增长。

参数说明：

String groupId = null;//分组 id 选填 String

qrCodeName = "函数测试二维码";//二维码名称 必填

List<Integer> userIds = [1028];//用户列表 必填且单个

String skipVerify = 0;//是否跳过验证 0:是; 1:否 必填

String welcomeContent = '你好你好';//欢迎语文本 选填

String bindApiName = 'AccountObj';//绑定对象 apiName 必填

String bindObjectId = '65dffc55bada2400013f6f04';//绑定对象 ID 必填

函数示例：

涉及风险操作，请联系 CSM 同学获取

函数 5：查询某个用户的营销动态

使用场景：

查询用户的所有行为轨迹，早期营销动态都在营销通库中，所有单独提供了查询函数接口，目前已经将行为同步到用户行为记录对象，可以直接使用函数查询对象数据也可以。

参数说明：

String objectApiName = "LeadsObj";//营销用户对象的 ApiName

String objectId = "655f0a56dc62af000107158a";//对象的 ID

函数示例：

涉及风险操作，请联系 CSM 同学获取

函数 6：查询营销用户的关联对象信息

使用场景：

营销用户关联的业务对象数据存在营销通库中，比如需要知道线索上关联的微信粉丝和企微客户是谁，可以通过此函数查询

函数示例：

String identifyType = 0;//固定值 0：营销用户ID，1：手机 2：对象ID 3：邮箱
String identifyValue = "0e328d877a3a46078d374615fee036bb";//identifyValue : identifyType对应的值,如果 identifyType=2,格式为：对象apiName:对象id

def(boolean error, String data, String message) = Fx.biz.callAPI("Fx.marketing.queryUserMarketingInfo", identifyType, identifyValue)
if (error) {
  log.info("error: " + message)
} else {
  log.info(data)
}

返回值结构：
    private String userMarketingId;    //营销用户的id
    private String userMarketingName;  //营销用户的名字
    private String phone;              //营销用户手机号
    private String email;              //营销用户的邮箱
    private List<RelateObj> relateObjList;  //营销用户关联的对象信息

    @Data
    public static class RelateObj implements Serializable {

        private String apiName;    //营销用户关联的对象apiname

        private String objectId;   //营销用户关联的对象Id
    }

测试结果：
 {"relateObjList":[{"apiName":"ContactObj","objectId":"<record-id>"},{"apiName":"LeadsObj","objectId":"<record-id>"},{"apiName":"AccountObj","objectId":"<record-id>"}],"phone":"<phone-number>","userMarketingName":"示例用户","userMarketingId":"<record-id>","email":"user@example.com"}
}

函数 7：发送短信

使用场景：

用于在非营销通内的使用场景下发送通知类型的短信

函数示例：

涉及风险操作，请联系 CSM 同学获取

函数 8：通过营销助手给企微员工发送内部通知

使用场景：

没有买 CRM 的客户，可以在企微里面通过自定义通知把线索信息同步给销售。

参数说明：

函数示例：

String touser = "wowx1mDAAAQJ2kIMBVbdNuHIcY_liMmw";//企微员工的ID
String toparty=null;
String totag=null;
String content= "你的快递已到，请携带工卡前往邮件中心领取。\n出发前可查看<a href=\"https://work.weixin.qq.com\">邮件中心视频实况</a>，聪明避开排队。";
def(boolean error, String data, String message) = Fx.biz.callAPI("Fx.marketing.sendQywxApplicationMessage", touser, toparty, totag,content)
if (error) {
  log.info("error: " + message)
} else {
  log.info(data)
}

函数 9：发送营销邮件

使用场景：

满足个性化筛选人群及个性化内容需求

参数说明：

marketingEventId ：市场活动 ID

title :发送标题（生成营销活动的标题）

spreadUserId ：负责人的 ID，需要具备营销活动对象和市场活动对象的权限

sendRange： 是发送范围  2 -通过目标人群发送  9 -通过标签筛选发送  10-直接发送邮箱地址

marketingUserGroupIds ：目标人群 id 列表

toUsers: 要发送的邮箱列表，一次最多 1000 个邮箱。type: 发送类型  1- 立即发送  2：定时发送 fixedTime: 定时发送设置的时间， 时间戳，毫秒值。 该值必须比当前时间大 5 分钟以上 tagNames: 筛选标签，会根据该标签去营销通相关对象查询邮箱，设置如：List<LinkedHashMap> tagNames = [["firstTagName":"客户等级","secondTagName":"一般"]]

tagOperator :标签筛选的操作符号，支持 IN、HASANYOF   IN:满足所有标签  HASANYOF：包含任意一个标签

excludeTagNames ：不包含的标签（需要排除掉的标签）

content ：邮件内容

sendTo ：发送人的邮箱

replyFrom ：回复人的邮箱

filterNDaySentUser ：按照已经发送天数去做过滤，支持：1、3、5、7

函数示例：

涉及风险操作，请联系 CSM 同学获取

函数 10：给单个营销用户打单个标签

使用场景：

基于订单相关数据，把标签打到所有相关的营销用户对象上，包括可以打到企业微信上。

参数说明：

函数示例：

涉及风险操作，请联系 CSM 同学获取

函数 11：删除多个营销用户的多个标签

使用场景：

基于订单相关数据变更，删除原有的标签。

函数示例：

涉及风险操作，请联系 CSM 同学获取

函数 12：插入第三方系统的行为数据展示到营销动态

使用场景：

同步第三方系统的数据到营销动态时间轴中展示出来，洞察客户全渠道行为

参数说明：

actionProportion | 行为深度 | BigDecimal

actionDurationTime | 行为累计时长 | BigDecimal

identifyType | 身份类型: 1:手机 2:邮箱 3:微信 unionId 4:公众号 openid 5:小程序 openid | Integer

identifyValue | 身份对应的值 如：identifyType==1 这个就是手机号 | String

actionType | 行为类型,注意:该行为类型必须让营销通开发提前注册，否则数据会插入失败 | Integer

actionDescription | 行为类型的描述 | String

channel | 渠道 | String

actionTime | 行为时间 毫秒级时间戳 | BigDecimal

spreadChannel | 推广渠道 | String

spreadType | 推广方式 | String

channelAccountPlatform | 渠道平台 | String

channelAccountName | 渠道账号 | String

objectName | 物料名称 | String

marketingEventId | 市场活动 | String

函数示例：

涉及风险操作，请联系 CSM 同学获取

函数 13：查询直播、会议活动下绑定的推广内容信息

使用场景：

可以基于内容拼接预览链接在 CRM 中给销售直接查看，了解活动内容

参数说明：

函数示例：

String marketingEventId = "67bee726f9bfe3000140e394";//市场活动对象ID
def(boolean error, String data, String message) = Fx.biz.callAPI("Fx.marketing.queryMarketEventObjBindMaterials", marketingEventId)
if (error) {
  log.info("error: " + message)
} else {
  log.info(data)
}

函数 14：在企业微信活码及欢迎语中回复微页面中，获取企微员工及企微客户身份

使用场景：

添加企微好友后，给客户发一个信息登记的微页面表单，需要把表单提交的信息更新到企微好友上。在活码和欢迎语中回复的微页面中，可以直接获取到一个身份参数：aggregateKey，通过此参数调用此函数可以查询到企微员工和企微客户的原生 ID，再通过这两个 ID 可以查询到具体的企微好友数据，就可以再次进行更新操作。可以参考： 如何通过企微活码或者欢迎语中自动推送的表单更新或自动关联客户信息？

参数说明：

函数示例：

Map aaa = Data['functionAdditionalMsg'] as Map;
String aggregateKey = aaa['aggregateKey'];
def(boolean error, Map<String,String>  data, String message)= Fx.biz.callAPI("Fx.marketing.queryRelationInfo", aggregateKey);
log.info(data)

开放平台（Open Api）

纷享销客提供对外开放 API，用于第三方服务调用 ，以上营销通注册到 CRM 对象的业务数据，均可以通过 API 进行查询、处理，可以前往  纷享开放平台 了解更多。

营销插件使用说明

自定义群发通道

结合纷享销客 APL 能力，支持对接任意群发通道，如在营销通圈选人群后，通过自有 APP 下发应用通知

常见问题与故障排除

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