将同一条测试注册提交两次。结果仍应只有一名订阅者、一次确认请求,以及处理经过的记录。如果第二次传递又启动欢迎消息序列,连接还需要调整。
有效的 Webflow 到 Brevo 集成必须像处理第一次传递一样谨慎处理第二次。本指南提供字段映射、确认边界和简明的验收测试,适用于自动化服务或你自己的后端。
选择最短路径
| 需求 | 建议起点 | 检查事项 |
|---|---|---|
| 新闻简报注册 | 嵌入 Brevo 表单 | 双重确认、必填字段、目标列表 |
| 保留 Webflow 原生提交记录 | 保留 Webflow 表单并连接自动化服务 | 字段映射、确认处理、重放行为 |
| 自定义路由或可控恢复 | 在后端接收 Webflow 事件 | 身份验证、待处理状态、去重、失败记录 |
Brevo 表单构建器支持双重确认。新订阅者必须点击邮件中的链接,才会被加入联系人数据库。如果只需要新闻简报表单,这是一个合适的默认选择。
“我们已经在 Webflow 设计好表单。”如果布局或提交记录很重要,就保留它。Webflow 集成指南介绍自动化和 API 路径。修改自定义表单动作前先核查影响:绕过 Webflow 的处理,也会改变提交数据的存储位置。
明确每个字段的含义
使用独立的新闻简报表单,或在一般咨询表单上提供单独且默认不勾选的营销选项。要求销售人员回复,不应悄悄变成订阅新闻简报。
下表是企业新闻简报的示例映射。要求填写名字和工作邮箱是该表单的规则,不是 Webflow 或 Brevo 的普遍要求。
| 来源字段 | 目标 | 规则 |
|---|---|---|
| 工作邮箱 | 联系人邮箱 | 必填;在服务器验证 |
| 名字 | FIRSTNAME 属性 | 必填;去掉首尾空格 |
| 公司 | COMPANY 属性 | 可选;空提交不得清除已保存的值 |
| 营销选择 | 同意记录 | 只识别明确的值;无法识别就停止 |
| 提交 ID | 处理记录 | 用于识别同一次传递 |
| 提交时间和表单 ID | 处理记录 | 保留足够的信息说明来源 |
发送数据前,应在 Brevo 创建类型正确的对应属性。Brevo 联系人 API接受属性对象,并可通过 updateEnabled 更新现有联系人。这些字段传递数据,却不能授予营销许可。
如果只接受企业邮箱,请在界面和服务器上都执行该规则。企业域名不能证明同意,也不能保证邮箱属于真实客户。
确认之后再进入营销受众
新订阅者应按以下顺序处理:
- 验证表单和明确表达的营销选择。
- 连同来源和提交 ID,将请求保存为待确认。
- 只发起一次双重确认请求。
- 通过选定的确认系统接收确认。
- 将已确认的订阅者加入营销受众。
Brevo 提供专用的双重确认 API 端点 POST /v3/contacts/doubleOptinConfirmation,参数包括模板、目标列表和重定向 URL。普通的 POST /v3/contacts 是不同操作。如果要求先确认再创建联系人,就不要先调用普通接口创建新联系人。
只选择一个系统负责确认。把 Brevo 表单、另一套自动化和自建确认发送器同时接到同一次提交,可能导致重复消息。API 返回成功也不代表用户点击了链接。
关于完整的订阅设计,请阅读双重确认指南。要把已退订地址与新地址分开测试。
在服务器接收事件
不要把 Brevo API 密钥放进 Webflow 页面代码。接收端后端或自动化服务的凭据存储应负责保管。
Webflow 的文档介绍了 form_submission Webhook,包括已提交字段、表单身份和提交时间。按 Webhook 的创建方式验证它。Webflow 指出,通过控制面板创建的 Webhook 不含其签名集成路径所述的签名头。
在确认接收前,应持久记录有效传递。如果目标不可用,就重试已保存的工作。分别跟踪“已接收”“待确认”“已同步”“已跳过”和“失败”,避免把已接受的 Webhook 误当成已完成的同步。
保留较晚的退订决定
重放旧注册不得覆盖较新的退出选择。更新目标前,要比较事件时间以及当前有权决定订阅状态的来源。缺少复选框或无法识别的值,不得被当成新的加入同意。一次新表单提交也不能自动解除阻止或重新订阅已退出的人;Brevo 将阻止发送视为独立的订阅状态。
身份变更也需要谨慎。Brevo 更新文档警告:更改已被阻止的联系人的邮箱,可能解除阻止并使其重新订阅。邮箱地址变更应作为单独审核的操作,而不是普通字段映射。
对于目前仍订阅的联系人,更新匹配记录可以避免产生第二条联系人记录。但还要对事件本身去重:即使只有一条联系人记录,同一个人也可能收到两条消息。
执行六项验收测试
| 测试 | 预期结果 |
|---|---|
| 有效的新注册 | 确认前保持待处理;不发送营销内容 |
| 同一次提交传递两次 | 只有一次处理结果;不重复确认 |
| 营销选择缺失或不明确 | 不推定订阅 |
| 退订后重放旧注册 | 较晚的退订仍有效 |
| Brevo 暂时不可用 | 失败可见且可重试;不显示虚假成功 |
| 后续提交缺少公司 | 除非明确要求清除,否则保留现有公司 |
在独立测试列表中使用你控制的地址运行这些测试。检查两个系统和实际收到的消息。自动化步骤显示绿色并不足以证明成功。
Tajo 的作用
Tajo 目前处于早期开放阶段。评估集成时,带上来源表单、目标列表、字段映射和六项预期结果。启用前确认所选流程能够满足这些要求。
若要比较原生表单、自动化服务和自定义代码,请参阅 Brevo 连接器指南。
如果要连接的是店铺而非网站表单,请看 Shopify 到 Brevo 设置指南;自定义实现可参考 Brevo API 指南。
告诉我们需要连接哪些系统。先让一个表单在重试时也能正确运行。
常见问题
连接 Webflow 和 Brevo 最简单的方法是什么?
如果只是新闻简报注册,可嵌入 Brevo 注册表单并开启双重确认。若需要 Webflow 自身的提交记录或自定义路由,就保留 Webflow 表单,使用自动化服务或服务器端集成。
创建 Brevo 联系人就表示订阅已确认吗?
不是。普通的联系人创建或更新调用不会完成双重确认。应使用确认流程,并仅在确认后将新订阅者纳入营销受众。
如何防止重试产生重复记录?
记录 Webflow 提交 ID 和处理结果。重放同一次提交不应重复产生副作用。对已经确认的联系人,应更新匹配记录,而不是创建第二个身份。