Issues

An issue is one problem you can fix. It names where the problem happens, what causes it, and what to change, and it carries the calls that show it. Signal groups problems across calls by the change that would fix them, so one issue is one repair. A slow tool is one issue wherever its silence shows up, and questions the agent cannot answer at one step are one gap, even when callers word them differently.

​

Fix and Improve

Signal lists confirmed patterns only: problems it has seen across several different calls and callers. Where a pattern is listed depends on whether Signal established its cause. Outside your agent. When the cause sits outside your agent, the Fix row says so first, for example “Outside your agent: the service behind lookup_vehicle is slow to answer.” Whoever runs that service has the fix; a change in your agent can only soften it. Improve. An Improve item names a change that is yours to make, such as how a question is asked or when the agent hands a call to a person, and the number it moves: “Yours to change: how this question is asked. Moves Got it done.” Not on the board. Some patterns are kept but not listed in the app, the API, the MCP server or the copilot: ones not yet confirmed, ones that are a consequence of a larger issue, and what callers did that no change to your agent would prevent (never spoke, stopped answering, hung up on the greeting). Signal keeps reading them as new calls arrive. Opened by its link, such an issue is tagged Not on the board with one sentence saying why.

​

What an issue contains

Some issues also show their lane, Where under the cause, Lasting harm in place of Ended badly, Checked (the calls on which the cause was confirmed) in place of Confidence, and Outcomes it produced. A cause headed Model’s reading has not been confirmed on the calls: treat it as a lead, like What was seen.

​

Cause not established

When the calls do not show why something happened, Signal does not guess:

• On Issues, the pattern is listed under Cause not established with what was seen and what to check. It can move to Fix once Signal establishes a cause.
• On the issue page, a Cause not established tag, What was seen in place of Cause, and What to check in place of Suggested fix. Treat it as a pointer to the calls, not an explanation.
• On the overview board, when a number changes, a tile names an issue as the reason only when Signal can tie the change to that issue. Otherwise it says Cause not established. This is a common answer.

A plausible reason that turns out wrong sends someone to fix the wrong thing and teaches everyone to stop trusting the board.

​

How the board is ordered

Issues are ordered by impact, so the top of each list is where a fix helps the most callers. Two things you control change the order:

• Your brief. Issues at a part your brief marks High under Matters move up, and issues at a part marked Low move down.
• Your fixes. An issue the live version fixed is listed after every issue still happening.

Use the order as a starting point and read the calls.

​

Status

​

The grace period

The grace period is how long your agent has to take calls without an issue before Signal counts it as resolved: 7 days unless you change it.

• Set it on Issues, next to Show resolved: Resolved after 7 days without a sighting, with 1, 3, 7, 14 or 30 days. It belongs to the agent and applies at once.
• Resolving. An open issue becomes Resolved when the agent’s newest call is at least the grace period past the last call that showed it. The clock is your agent’s calls, not the calendar, so an agent that stopped receiving calls keeps its issues open. The line under the title reads “Resolved by Signal”, with Confirm resolved to make the resolution yours, so a later change to the grace period does not reopen it.
• Marking it yourself starts the same watch: “Resolved Oct 3. Signal watches the next 7 days of calls; one that shows it again sends it back as regressed.”
• Coming back. Only a call that started after the resolution reopens it. Calls from before your fix do not, and an issue you answered No on stays resolved.

A weekly pattern, such as a failure only on Mondays, can look gone after a quiet week, so give those a longer period.

​

Did my fix work

One sentence above the bars in By version answers this for the live version. It compares the share of calls with the issue on the live version against earlier versions, counting calls where the caller spoke, and waits for the grace period so a quiet morning on a new version cannot settle it. On Issues, a fixed issue is tagged Fixed on v12 and moves below every issue still happening; one that rose is tagged Rose on v12. This is a before and after reading, not a controlled experiment: Retell ships a version to all traffic at once, and something else may have changed at the same time. See Fix an issue and Versions.

​

Is this real?

Yes confirms an issue. No asks what was wrong: A rejected issue leaves the board and stays off.

​

Next steps