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.

TimeLens AI is the page that turns the active date range into a streamed, chronological narrative report. Each segment in the report is a roughly 150-call bucket with main topics, flagged issues, and a short summary.

Page anatomy

RegionWhat you see
Filter barBelow the hero, same date-and-hour controls as every other CCQA page.
Prompt cardA textarea for steering the report (optional) plus four suggestion chips.
CTA rowThe action buttons that drive the report.
Report panelEither an empty state or the streaming segment cards, depending on the report status.

The hero card

The hero is bespoke for TimeLens. In addition to the standard eyebrow / title / body, it carries:
ElementWhat it shows
Calls in scope chipTotal calls inside the active filter window.
Date range chipThe active date range, formatted.
Time span chipThe number of days covered.
segments, ~150 calls each chipThe number of segments the slider will produce, computed from calls in scope divided by roughly 150.
Segment count sliderLets you pick how many segments the narrative will cover. Range starts at 1 and goes up to ceil(calls in scope ÷ 150). For a 148,000-call month the maximum climbs to about 990. The default value is the smaller of 10 or the maximum.
Will analyze segments, calls captionUpdates instantly as you move the slider.
The segment count is a quality lever, not a cost-saving knob. More segments produce a longer, more granular narrative; fewer segments produce a tighter executive-style summary. 10 is a good starting point.

The Prompt card

Steers the analysis. Leave it empty for a full default report.
ElementWhat it shows
TitlePrompt Wittify AI.
SubtitleOptional, steer the analysis. Leave empty for a full default report.
Textarea placeholdere.g. Focus on billing complaints and escalation patterns after 6pm. Capped at 500 characters.
Suggestion chipsFour one-click prompts you can drop into the textarea:
Suggestion chipWhat it asks the model to do
Summarize the top 3 emerging complaints and when they peaked.Surface hot issues with timing.
What issues spiked in the last segment compared to earlier?Trend change in the most recent slice.
List the most common resolution themes and quote exemplar turns.Coaching material with verbatim quotes.
Identify escalation risk and flag calls needing review.QA-queue style triage.

The CTA row

The buttons available on the page change based on the current state.
ButtonWhen it showsWhat it does
Generate Timeline ReportIdle (no report yet, or filter has just changed)Starts streaming a new report.
StopStreamingCancels the stream. The report panel keeps whatever segments arrived before you stopped.
RegenerateReadyReplaces the current report with a new one using the same filter and prompt.
Download filtered calls CSVAlwaysDownloads the session-id list for the active filter window as a CSV file.
Generate PDF reportReadyOpens a Blob-URL print window with a strict content security policy so you can save or print the report.
The PDF blob URL is revoked after 60 seconds. If you intend to save the file, do so before it auto-revokes. If your browser blocks the popup, the toast reads Your browser blocked the popup. Allow popups for this site to export the report as PDF. The CSV uses a UTF-8 BOM and CRLF line endings so Excel reads Arabic content correctly. Every cell goes through formula-injection defence (cells starting with =, +, -, @, tab, or carriage return get a leading single quote). The default filename is timelens-filtered-calls.csv.

The Report panel

PhaseWhat you see
Idle (default)Title Ready when you are, body Tune your date filter above, optionally steer the analysis with a prompt, then hit Generate. The AI will stream a chronological narrative of what happened in your calls., plus a hint TIP, PICK HOW MANY CHAPTERS THE NARRATIVE SHOULD COVER.
GeneratingHeader label Generating report… with Streaming from Wittify AI. Segment cards arrive one at a time as the stream lands.
ReadyHeader label Report ready. The Regenerate, Download filtered calls CSV, and Generate PDF report buttons appear in the CTA row.
Empty (no calls in filter)Title No calls in scope, body Your current date and hour filter has no calls to analyze. Widen the range above and try again.

The segment cards

Each segment card carries:
ElementWhat it shows
SEGMENT / badgeThe position in the narrative.
Calls rangeReads {count} call in {date} or {count} calls in {date range}.
Main topics:A bullet list of the dominant topics in this segment.
Identified issues:A bullet list of flagged issues, with the originating session ids linked when applicable.
Notes and summary:A short paragraph that ties the segment together.
The card body always renders sequentially (Segment 1 first, Segment 2 second, etc.) and text streams in word by word.

Common questions

By design. TimeLens reports are filter-bound. Changing the date range, hour range, or prompt invalidates the current report (the data you would be reading no longer matches the model’s input). Click Generate Timeline Report again with the new filter.
Stop appears only while a stream is actively running, Regenerate appears only after the stream finished. If you see Stop change to Regenerate, the report is now in the Ready state.
Allow popups for this site in your browser. The toast tells you exactly what to do. After granting permission, click Generate PDF report again.
Yes, but the stream stops as soon as you navigate away. There is no resume, you have to click Generate Timeline Report again on return.
This should not happen, the export uses a UTF-8 BOM and CRLF line endings. If you still see odd characters, your Excel installation may have a regional default that overrides the BOM, try opening the file with Data > Get Data > From Text and selecting UTF-8 explicitly.
The maximum is calls in scope divided by roughly 150. If you only have a few hundred calls in your filter, the slider tops out at 1 to 5. Widen the date range to see more segments.
Not yet. The textarea is reset whenever you reload the page. If you reuse the same prompt often, copy it into a note.

Where to go next

Sentiment Analysis

See the sentiment shifts behind the narrative.

Speaker Timeline

Per-call breakdown of who spoke when.

Alerts

Catch trouble before it compounds.

Volume Forecasting

Plan staffing for the next 7 to 180 days.