要调试 Papo (https://papo.global/) 中无法正常工作的自动化 Flow，请访问该流程的执行历史，查看联系人经过的每个步骤，并找出逻辑中断的位置。可视化编辑器和自动化报告可让你追踪每个用户实际走过的路径，揭示失败节点、配置错误的条件或从未触发的操作。
一个未执行预期操作的 Flow 可能有多种原因：某个条件永远无法满足、某个触发器未触发，甚至流程处于未激活状态。与其从头重建自动化，不如基于执行历史进行有条理的调试，能更快解决问题。
Flow 出现问题的常见症状
| 症状 | 可能原因 | 在哪里检查 |
|---|---|---|
| 没有联系人进入 Flow | Flow 未激活、触发器错误或未完成加入 | Flow 状态和加入规则 |
| 联系人总是停在同一个节点 | 条件无法满足，或预期回复从未到达 | 条件节点和流程问题 |
| 操作未执行（例如：标签未应用） | 操作配置错误，或未映射替代路径 | 节点详情和步骤历史 |
| 完成率非常低 | 旅程过长、问题令人困惑，或缺少转接人工的出口 | 自动化报告和历史记录 |
如何使用执行历史调试 Flow
调试的核心在于跟踪联系人实际走过的旅程。Papo 会记录 Flow 内的每一步，让你无需猜测即可精准诊断。
-
确认 Flow 处于激活状态 在调查逻辑错误之前，请检查 Flow 的状态是否为 激活。只有激活的 Flow 才能接收并处理联系人。未激活的流程对新加入不可见，已加入的联系人也不会继续前进。
-
找到特定联系人或执行记录 进入 Flows / Chatbot 模块，打开你要调试的流程。查找 Flow 的执行历史，在那里可以看到经过该流程的联系人列表。如果你知道哪个具体联系人出了问题，请在 CRM 中打开其个人资料，并查看他处于流程的哪个阶段。
-
逐节点检查走过的路径 打开某次执行的详情后，你会看到 Flow 经过的准确节点顺序。将实际路径与你设计的路径进行对比。例如，如果联系人停在某个条件节点，请检查他给出了什么回复，以及激活了哪个分支（如果有）。这通常会暴露出未覆盖所有可能回复的条件。
-
验证提问节点的输入 如果 Flow 使用了 提问 组件，请查看历史记录中捕获的回复。很多时候，联系人发送的词语与预期不同（例如用“是”而不是“是的”），而分支配置的条件无法识别这种变化，导致流程走向未计划的路径，或直接停止。
-
检查更新和加入操作 如果 添加标签 或 更新联系人 之类的操作似乎没有生效，请在历史记录中查看是否到达并执行了该特定节点。如果节点被跳过，问题出在前面的逻辑。如果已执行但联系人没有变化，请在编辑器中检查该操作节点本身的配置。
根据发现调整逻辑
找出 Flow 中断的位置后，常见修复包括：
- 扩展条件：添加预期回复的变体，或添加默认路径以捕获未预见的输入。
- 简化旅程：移除可能导致流失的不必要步骤。
- 添加逃生路线：始终加入一个提供与人工客服对话选项的节点。
- 查看自动化报告：对比 联系人 与 已完成 指标以及 完成率，验证修复是否对新执行生效。
何时使用 Flow 库重新开始
如果当前流程过于复杂或逻辑难以修复，另一种选择是从可靠的基础重新开始。Flows 模块提供 Flow 库，其中包含预配置的自动化，覆盖欢迎、线索资格筛选和调查等常见场景。从可用的模板开始，可降低逻辑错误概率并加速调试。
常见问题
如何知道我的 Flow 是否激活？
在 Flows / Chatbot 模块中，每个流程都会显示其状态。只有带有 激活 指示的流程才准备好接收并处理联系人。未激活的 Flow 可以编辑，但不会执行任何操作。
为什么我的 Flow 完成率这么低？
完成率 低通常表示存在瓶颈。可能是问题令人困惑、条件未覆盖所有回复，或用户缺少清晰路径。使用执行历史查看联系人究竟停在哪个节点，并修正旅程中的该点。
如何将联系人重新加入已修复的 Flow？
如果你调整了 Flow，并希望已经经过它的联系人再试一次，可以手动将其加入。在 CRM 中打开联系人资料，使用加入激活 Flow 的选项。另一种方式是批量加入：在 CRM 列表中选择多个联系人并应用该操作。
当“添加标签”操作不起作用时该怎么办？
首先，在执行历史中确认是否确实到达了添加标签节点。如果到达了，请在编辑器中检查该节点配置，确保选择了正确的标签。如果节点被跳过，问题出在前一个节点，例如某个未满足的条件，修复应在那里进行。
我可以在向所有联系人激活之前测试 Flow 吗？
可以。最安全的方式是通过 CRM 中的联系人资料手动加入一个测试联系人，并在执行历史中跟踪其进度。这样可以隔离测试，在你确定流程正常工作之前不会影响真实联系人。
在哪里可以找到执行历史？
执行历史主要有两种访问方式：在 Flows / Chatbot 模块中选择所需流程并查看最近执行；或在 CRM 中打开单个联系人资料，在那里可以看到当前状态以及他在每个已加入 Flow 中走过的路径。
另请阅读
- 了解自动化报告：如何衡量 Flow 的效率
- 从零创建你的第一个自动化 Flow
用免费用户试用 Papo，今天就开始调试你的自动化 Flow。