Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.wittify.ai/llms.txt

Use this file to discover all available pages before exploring further.

Speaker Timeline is the page that visualises every call second by second.

Page anatomy

The page is one column. The hero is followed by a 4-way tab bar that swaps the body. Each tab keeps its own URL, so you can deep-link directly to a specific tab.
RegionWhat you see
Tab barFour pill tabs in a 2-up grid on phones, 4-up on tablets and larger: Gender Detection, Sentiment Timeline, Intent Timeline, Silence & Dead Air.
Filter barDate and hour controls, see Overview.
Info bannerA muted strip with one-line copy describing what this tab measures.
KPI stripA row of 3 to 5 cards specific to the active tab.
Distribution chartsOne or two cards with donut, pie, or bar charts summarising the dataset.
Per-call timeline listA paginated list of rows, one per call, with a colored timeline bar showing the per-second pattern.
Pagination footerPrev, Next, page numbers, Showing X to Y of Z, Results per page dropdown.
Loading skeletonWhile a tab is fetching, a pulsing placeholder (info banner, four KPI cards, two chart cards, five row placeholders) takes the space.

Gender Detection tab

The default tab. Info banner reads Speaker Detection: visualize the speaker distribution throughout each call.
SectionContents
KPI stripCalls with speaker data, Total speaker minutes, Male Speaking Time, Female Speaking Time.
Speaker distribution cardDonut chart with two slices, colored male and female. Download pie chart PNG button on the card header.
Calls by dominant speaker cardBar chart with four buckets: Male dominant (>60%), Female dominant (>60%), Balanced, Undetermined (confidence <80%). Download bar chart PNG button on the card header.
Per-call rowsEach row shows the call’s start datetime, duration, and a timeline bar segmented by speaker. Hover any segment for start, end, and duration.

Sentiment Timeline tab

Info banner reads Sentiment Timeline: visualize the emotional tone throughout each call.
SectionContents
KPI stripCalls with sentiment data, Positive time, Neutral time, Negative time.
Sentiment distribution cardDonut chart with three slices in green, slate, and red. Download chart PNG button.
Calls by dominant sentiment cardBar chart with three buckets: Positive dominant, Neutral dominant, Negative dominant. Download chart PNG button.
Per-call rowsSame shape as Gender, but the timeline bar is colored by sentiment per second.

Intent Timeline tab

Info banner introduces the per-call view of the customer’s intent evolving over time.
SectionContents
KPI stripCalls with intent data, Top 10 intents by volume.
Top 10 intents by volume cardHorizontal bar chart with localized intent labels.
Per-call rowsTimeline bars colored by detected intent. Each intent has a deterministic color, so the same intent always looks the same across the chart, the legend, the timeline bars, and the chips below.
LegendInline above the per-call list.

Silence & Dead Air tab

Info banner reads Silence, talk-over, and dead-air events across every call in the selected range.
SectionContents
KPI stripSilence Ratio with subtitle Share of airtime with no speaker; Talk-Over Ratio with subtitle Share of airtime with overlapping speakers; Dead Air Events with subtitle Silences longer than 5 seconds; Calls With Dead Air with subtitle At least one silence over 5 seconds; Total Silence Time with subtitle Summed across every analyzed call.
Talking vs Silence cardPie chart with two slices labelled Talking and Silence.
Silence Distribution cardBar chart breaking down the silence pattern.
Per-call rowsTimeline bars segmented into Speaking, Silence, and Dead air (>5s) with the legend showing the same labels in the same colors.
Note stripA small footer note: Metrics computed from the visible page. Server-side aggregation ships with the next data pass.
The dead-air threshold is fixed at 5 seconds.

The per-call timeline rows

Every tab renders the same row shape.
ElementWhat it shows
Date and timeThe call’s start, formatted YYYY-MM-DD HH:MM:SS.
DurationCall length in MM:SS or HH:MM:SS.
Timeline barA horizontal bar, colored according to the active tab. Hover any segment for start, end, and duration.
PaginationThe Results per page dropdown is restricted to 10, 25, 50, 100.
Card headersEach card carries a CSV export and a PNG export button in its top-end corner.
The bar’s geometry is anchored to the actual segment span, not the call duration, so bars always fill the row edge to edge with no trailing gray tail.

Failure and empty states

StateWhat you see
LoadingThe skeleton placeholder above (info banner shape plus KPI placeholders plus chart placeholders plus five row placeholders), pulsing.
Network errorA red-tinted strip with the localized message Could not load silence metrics. (or the equivalent on the other tabs).
No data in scopeAn empty card with the localized No data available message.

Common questions

Each tab keeps its own URL. If the data really did not change, the filter bar selection covers the same calls in scope. Try switching the date range to confirm.
Check the Calls with X data KPI card. A call shows up in the chart only if it has the kind of data this tab measures (speaker, sentiment, intent, or silence). If the count is zero, the engine has not yet produced that signal for these calls.
They should not. Intent colors are deterministic, the same intent is always the same color across the legend, chart, timeline, and chips. If you see a flicker, refresh the page, the local cache may be stale.
The threshold is fixed at 5 seconds. We chose it because it is the typical attention drop-off in a phone call. If you need a different threshold, configure an alert in Alerts using the Silence Ratio metric.
Yes. Each tab exports the columns relevant to it (gender breakdown for Gender, sentiment per segment for Sentiment, etc.). The PNG export from a chart is the same flat image regardless of tab.
A fully gray bar means we have a call with no detected segments for the active tab. The bar is just the row scaffold. Switch to another tab to see if data exists for it there.

Where to go next

Sentiment Analysis

Volume view of sentiment distribution.

Intent Analysis

Top 10 intents bar with categories.

TimeLens AI

Generate a written narrative from the same range.

Alerts

Alert when Silence Ratio exceeds your threshold.