# Flow health and broken flows

> See which flows still replay in real demos, why a flow broke, and how to fix it. A flow that fails at the same step three times is set aside automatically.

Source: https://talkdemo.com/help/product-and-flows/flow-health-and-broken-flows · Updated 2026-11-20

## Key takeaways

- Flow health comes from real demos. Every time the agent replays a flow, TalkDemo records whether it worked and where it stopped.
- Each flow shows its success rate over recent replays and its last replay. The target is above 95 percent.
- When the last three replays fail at the same step, the flow is marked Broken, the agent stops using it, and your team is notified.
- Fix the step, save, and click Mark fixed and active. Its health starts afresh.

Your product changes, and a button that moves can break a recorded flow. Flow health shows which flows still replay and which need attention, so prospects never watch the agent get lost.

**Who can do this:** Admin, Member. Viewers can see health. · **Plans:** live product mode (Growth and up).

## Read flow health

Open **Agents**, choose the agent and open **Flows**. Each flow shows:

| Field | Meaning |
|---|---|
| **Status** | Draft, Active, Broken or Archived |
| **Success rate** | Share of the last 20 replays that finished |
| **Last replay** | When it last played in a demo, and whether it worked |
| Warning line | The step where recent replays failed, and why, such as "the element wasn't found on the page" |

Replays the prospect interrupted, or that ended because the call ended, do not count against a flow. A step a guardrail blocks does count: the flow asks for something the agent may never do.

## When a flow breaks

If the last three counted replays of an active flow failed at the same step, TalkDemo:

1. Marks the flow **Broken**. The agent stops picking it at once and shows other flows, clicks through live or answers from your docs.
2. Sends **A demo flow stopped working** to your team: in the app for everyone, and by email for Admins. Change this in **Settings → Notifications**.

A daily check also recomputes health for every flow that ran since the last check.

## Fix a broken flow

1. Open the flow. The red note names the failing step and the reason.
2. Open your demo tenant and check that step: did the button move, get renamed or change its label?
3. Update the selector, or add a fallback selector. Click **Save steps**.
4. Click **Mark fixed and active**. Replays before this moment no longer count.

## Frequently asked questions

### Does a broken flow stop the agent?
No. The agent keeps running and uses other flows, live clicks and knowledge.

### Can TalkDemo replay flows on a schedule before a demo happens?
Not yet. Automatic re-scans when you deploy, or nightly, are on the roadmap.
