WhatsApp 滴灌式活动设置指南：编排多步骤相对等待时间、准入条件与客户回复停止规则

概览

滴灌式活动会在数小时、数天或数周内，按顺序自动向联系人发送一系列 WhatsApp 消息。如果说流程是对话式的、会根据联系人回复作出反应，那么滴灌就是一份排期：无论联系人是否回复，它都会逐步执行；按你的配置，在对方回复的那一刻停止。典型用法是定时跟进，例如「现在确认，24 小时后提醒，3 天后再问候」。

每个待执行的步骤都会带着到期时间持久化存储在数据库中，因此部署、重启或崩溃都不会丢失已排队的跟进 — 系统下次运行时会把它们捡起来并投递。迟到可以补救；丢失则无法挽回。

滴灌与流程的区别。当推进节奏由时间驱动、并且希望不依赖回复持续进行时，用滴灌；当下一步取决于联系人说什么时，用流程。

你将获得

• 独立、持久化的跟进序列引擎，与流程分开。
• 多步序列，每步可设置分钟、小时或天级的等待。
• 触发式自动加入（新联系人、添加标签、加入分组、创建 CRM 商机），以及按分组或手动挑选联系人列表加入。
• 停止条件 — 回复即停止，以及目标退出（添加标签、预约成功、完成下单），一旦达成目标就提前结束序列。
• 每个活动可设置免打扰时段（按活动时区），让提醒不会在半夜发出。
• 支持模板步骤，可将联系人字段映射到模板变量。
• 每步的测试发送，走真实的发送链路。
• 每步漏斗分析与实时订阅者列表。

前提条件

• 套餐已启用 Drip Campaigns 功能的工作区。相关路由受 plan:access_drip_campaigns 门控保护，创建活动还受套餐的 drip_campaigns_limit 限制。
• 工作区已连接发送通道（WhatsApp 协议连接）。
• 使用模板步骤时：工作区中至少有一条已保存的模板。模板步骤必须与模板的变量数量一致。

权限按套餐授予。没有单独的管理页面 — 在工作区套餐上授予 access_drip_campaigns，并把 drip_campaigns_limit 设为该工作区可创建滴灌活动的最大数量，即可启用该功能。限制在创建时强制执行。

创建活动

1. 在工作区中打开 Drip Campaigns。
2. 点击 New drip campaign。
3. 填写活动设置：
   • 名称 — 序列的标签。
   • 触发条件 — 联系人如何加入：手动 — 由我挑选联系人、创建联系人时、添加标签时（在触发值中填写标签名）、加入联系人分组时（指定分组），或创建 CRM 商机时。
   • 发送号码 — 可选；留空则使用工作区的默认路由。
   • 时区 — 用于排期与免打扰时段。
   • 免打扰时段 — 可选的开始与结束小时（0–23）。落在该时段内的步骤会被推迟到时段的开始。支持跨越午夜的时段（例如 21 → 9）。
   • 回复即停止 — 联系人一回复就停止跟进。
   • 目标 — 可选，达成目标后提前结束序列：添加了标签、预约成功或完成下单。
4. 点击 Create campaign。活动会以草稿状态创建，并进入编辑页添加步骤。

添加步骤

在活动的编辑页按顺序添加一个或多个步骤。每个步骤包含：

• 本步骤前的等待 — 数值加单位（分钟、小时或天）。0 表示立即发送。第 1 步的等待从加入时算起；后续步骤从前一步算起。
• 消息 — 自由文本，或一条模板。选择一条已保存模板后，会显示与模板位置变量（{{1}}、{{2}}、…）数量完全相同的字段选择器；把每个变量映射到联系人字段（姓名、名字、手机号、邮箱）。支持可选媒体（路径加类型）。
• 自由文本正文可使用合并标签 {{name}}、{{first_name}}、{{mobile}} 与 {{email}}。

保存活动。步骤按顺序存储；既没有正文、也没有属于本工作区的有效模板的步骤会被跳过。

没有步骤的活动无法激活。启用活动前请至少添加一个可投递的步骤。

测试步骤

1. 在编辑页对任意已保存的步骤使用 Test。
2. 输入电话号码。该步骤会通过真实发送链路立即发出 — 与真实联系人收到的是同一个渲染器、同一套模板参数与派发器 — 因此拼写错误、变量错误或内容缺失会在这里暴露，而不是在真实收件人身上。

如果该号码上存在真实联系人，合并标签与模板变量会用其数据渲染。

激活与加入

• 激活 / 暂停。用开关把活动设为激活。已加入的联系人开始接收步骤。暂停会保留待执行步骤的排队；再次激活后继续。
• 自动加入。活动激活后，只要配置的触发条件发生（新联系人、匹配的标签或分组、新商机），联系人就会被自动加入。加入是幂等的 — 同一活动不会重复加入同一位联系人。
• 手动加入。选择联系人分组或指定的一组联系人来加入。活动必须先处于激活状态。

监控

• 索引页显示每个活动的计数：总数、进行中、活跃订阅者与已完成。
• 编辑页显示每步漏斗（多少订阅者到达了每一步）、总计（已加入、活跃、已完成、已停止、失败、已发送消息、发送失败），以及「当前失败 / 重试中」计数作为早期预警。
• 订阅者列表显示每位联系人的状态、当前步骤、下次发送时间、已发送次数与停止原因。

持久化、时序与重试

• 投递。步骤由 drain 投递：打开滴灌页面时机会式运行，也可以通过 drain 端点触发 — 项目刻意避免依赖 cron，让周期性工作搭载在操作者本就会访问的端点之上。因此步骤会在到期时间当时或稍后触发，而非精确到秒。由于等待时间存储在数据库中，重启只会推迟步骤，绝不会丢弃。
• 不会重复发送。投递使用行锁加到期时间校验，因此并发 drain 不会重复发送。步骤在发送前先被认领，只有成功才前进。
• 重试。失败的步骤会按退避重试（1 分钟、5 分钟、30 分钟、2 小时），最多 4 次；之后跳过该步骤，避免一个坏步骤卡住整个序列，同时把辅助服务返回的错误原因记录在该订阅者上。

说明与限制