小红书广告与线索接入

概述

小红书广告与线索接入的操作说明。

小红书线索通过连接器接入，支持表单线索和私信线索两种类型。两者共用同一个连接器 Token，但推送 Webhook 地址需要使用不同的类型参数，并分别建立连接对象。

开始之前

• 已联系客户经理购买小红书线索连接器订单。
• 已准备小红书聚光平台账号，并确认具备私信 API 对接的操作权限。
• 已准备 CRM 销售线索字段的 apiName 清单，用于集成流字段映射。

开通插件与授权

1. 进入 营销通 > 系统设置 > 插件中心，打开 小红书线索 插件。

2. 进入 系统管理 > 集成平台管理 > 连接器 > 小红书连接器。

3. 登录小红书聚光平台 https://ad.xiaohongshu.com/，进入 工具 > 私信 API 对接，复制 Token。

   [!NOTE]
   私信 API 和表单 API 使用同一个 Token，复制私信 Token 即可同时用于两类线索绑定。

4. 将 Token 填写到 CRM 小红书连接器并保存。

配置表单连接

需要对接小红书表单线索时执行以下步骤，不需要则跳到配置私信连接。

1. 进入小红书聚光投流后台，打开落地页页面。
2. 编辑或新建需要推送的表单，推送地址填写 CRM 的 Webhook URL，并在表单对接 Webhook 后增加参数 type=1。
3. 复制落地页的页面 ID。
4. 返回 CRM 连接器，点击 新建连接对象，新建中间对象。对象编码填写复制的页面 ID；对象名称可以自定义，用于区分不同表单，例如“小红书表单 xxx”。
5. 增加小红书表单字段，字段编码与小红书落地页的标题保持一致。主键固定写一个即可。
6. 保存后继续配置集成流。

配置私信连接

1. 复制连接器的 Webhook URL。
2. 在小红书推送地址中填写 CRM Webhook URL，并在私信对接 Webhook 后增加参数 type=2，形如：

https://xxxxx?type=2

3. 返回 CRM 连接器，点击 新建连接对象。
4. 对象编码固定填写 leads，对象名称可以自定义，例如“小红书私信”。
5. 按页面要求设置对象字段。
6. 保存后继续配置集成流。

配置集成流

1. 进入 集成平台管理 > 数据集成流 > 新建数据集成流。
2. 根据表单或私信字段和 CRM 线索必填字段配置字段映射。
3. 保存并启用集成流。

验证接入结果

1. 在小红书落地页提交一条测试表单线索，确认能生成 CRM 销售线索。
2. 通过小红书私信发送一条测试咨询，确认能生成 CRM 销售线索。
3. 检查两类线索是否分别进入对应连接对象，字段映射是否正确。
4. 检查线索是否关联到对应的广告计划或来源信息。

注意事项

• 表单连接和私信连接的 Webhook 参数不同，type=1 对应表单，type=2 对应私信，配置时不要混用。
• 表单连接对象编码使用小红书落地页页面 ID，私信连接对象编码固定为 leads。
• 表单字段编码必须与小红书落地页标题一致，否则字段无法识别。
• 新增表单或修改落地页字段后，需要同步更新连接对象字段和集成流映射。

常见问题与故障排除

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