Viewer guide

Reading your reports

The viewer at app.telltale.bot shows who visited your sites: people, AI agents acting for a person, and bots. This page explains what its verdicts and numbers mean.

The three verdicts

🧑 Human: a person using a browser.
🦾 Agentic: an AI agent acting for one person, such as Claude in Chrome, ChatGPT agent or Gemini in Chrome. Someone asked it to visit or to do something on your site.
🤖 Bot: automation that is not acting for a particular person: crawlers, scrapers, testing tools, fake traffic.

Every visitor gets one of the three. There is no "unknown": when nothing points to automation, the verdict is human.

Confidence

The percentage next to a verdict is how sure Telltale Bot is of that verdict. "Bot 97%" is a near-certain bot. "Human 55%" is a visitor that is probably a person but showed some signs of automation. A low-confidence verdict is worth a second look before you act on it. In the dataLayer and the CSV exports the same confidence comes as a band: high (90% or more), medium (70% or more) or low.

Visitors, tabs and pageviews

A pageview is one page loaded in a browser. It is what your plan counts.
A tab is one browser tab's visit: the pages someone opened in it, one after another. Tabs are judged separately.
A visitor is one browser on one internet connection (IP address). The viewer counts visitors, with their pageviews alongside, and lists one row per visitor.

A visitor is not quite a person. The same person on a phone and a laptop, or on home Wi-Fi and then at work, is two visitors. Several people behind one office connection with identical computers can look like one. And an AI agent running inside a person's own browser counts as the same visitor as that person, so its tab and theirs sit in the same row.

How a verdict builds up

The tab is judged, not the single page. Every page in a tab adds to what is known about that tab. A tab's verdict is the one its latest page got, because by then it knows the most.
Each page reports twice: once when it loads, and once when the visitor leaves it or switches away. The second report can change the verdict. The viewer always shows the latest. The Events column in a visitor's pageview list shows which reports arrived: load, exit, or both.
Your page gets the verdict at load, in the dataLayer as telltale.verdict, and again as telltale.verdict-update if the visitor's first click or keypress changes it. What the visitor does after that counts from their next page on, so the viewer can disagree with what your analytics recorded for a page, most often a visitor's last.
A visitor's verdict is the most automated of its tabs: bot, then agentic, then human. One automated tab is enough to mark the visitor.
Mixed means a visitor's tabs got different verdicts. The usual case is a person and their AI agent in the same browser: the person's tab is human, the agent's is agentic, and the visitor shows agentic, marked mixed. Open the row to see each pageview's verdict.

We keep improving how verdicts are reached. When we do, past reports can be judged again with the new rules, so a verdict you saw last week can change. We tell you before we do that.

Who it was

The agents ranking (headed Group ID by: switch it between Agent and Category) names the agent or bot when Telltale Bot recognizes it, with a category such as "AI agents", "Search engines" or "Advertising". "Automated browser" means automation was found, but it did not match anything Telltale Bot can name. Naming is separate from the verdict: an unnamed visitor can still be a certain bot. Each visitor is listed under the names that match its verdict, so Human is exactly your human visitors, and a visitor judged agentic or bot is not listed under Human for pages that looked human before the agent acted.
Countries counts visitors by the country of their IP address. Open a country to see its regions or states, and click a country or region name to list only its visitors. Locations come from IP geolocation, so they are approximate, and a visitor on a VPN shows up where the VPN exits.
ISPs, next to it, counts visitors by the network their IP belongs to (the top 50), with its type (isp, mobile, hosting, business, ...) for most of them; a + means some had another type. Click a name to list only its visitors. Choosing a country narrows the ISPs to that country, and the other way around.
How identified says where a name came from. Verified: the visitor proved who it is with a cryptographic signature. Self-declared: it named itself, for example in its user agent, and nothing checks the claim. Inferred: Telltale Bot worked it out from what the visitor's browser and behavior showed.
The device under each visitor is what its browser claims to be ("Chrome 154 · Windows 10 · desktop"). Bots can claim anything, so it is a claim, not a fact. Hover over it for the full user agent.

The pages

Sites is the overview: every site you can see, its visitors and pageviews, and the share of each verdict. Star a site to keep it on top. If your login covers all of your account's sites, it also shows your plan's use this month.
All traffic has the totals, the visitors-over-time chart (by hour for a day; for two to seven days, switch between by day and by hour), which agents and bots were seen, and the list of visitors, most recently seen first. Open a row to see that visitor's pageviews. Hosts are shown without https://; a red crossed-out padlock after a host means those pages were served over plain http://, not encrypted.
Paid clicks lists the visits that arrived from ads or tagged links (UTM parameters or ad click IDs such as gclid), by ad platform, and by source / medium with each pair's campaigns under it. Each landing is judged by its visitor's verdict over the whole range, so a bot that looked human on the page it landed on still counts as a bot click. The Automated (Agentic + Bot) share turns orange from 25% and red from 50%, on rows of 10 or more visitors. It also lists visitors who arrived with several click IDs, and click IDs that brought in more than one visitor. Facebook adds a click ID to every outbound link, so organic posts show up here too. Paid clicks is an add-on: if you don't see it, turn it on under Account settings › Add-ons.
Member accounts is for sites whose tag sends the signed-in member's ID (see the install guide). One row per member: pageviews, how many were automated (agentic or bot), devices, networks, countries, and at once, the most devices on separate networks within 3 hours. A member is flagged automation at 20 or more automated pageviews and sharing at 3 or more devices at once. A device is one browser, whatever network it is on. Open a row for the member's devices. Member accounts is an add-on: if you don't see it, turn it on under Account settings › Add-ons.
Site settings (the gear on a site's card) has the install tag, a Custom domain (the script and reports on a hostname of your own: a DNS-only CNAME, see the install guide), the data layer fields (what the dataLayer and the page events carry), Delete, where you can erase a visitor's reports when they ask (and, if your login sees every site, clear a site's reports or delete it), and Email reports: a traffic overview (visitors and pageviews against the period before, visitors by verdict, the agents they were identified as and their countries) and, if your account has Member accounts, the flagged member accounts with the CSV attached, each over a period you pick (the previous day, 7, 14 or 30 days), emailed daily or weekly on the day and at the hour you choose, to the logins or email addresses you choose (people without a login get a link to unsubscribe).
Account settings, under your name, has your color theme and time zone, your password, two-factor sign-in and sign-in email, and, depending on your login, billing, pageview usage by month, the add-ons (Paid clicks and Member accounts), your team, the agreement and closing the account.
Team, under your name, is who can sign in to your reports. Invite a colleague by email, choose whether each login sees every site or one site (an agency's client), and remove logins. Logins that see every site can do this; a one-site login doesn't see the page.

Filters, search and exports

Click a verdict (its share at the top, a slice of the donut, a chart legend, a heading) to see only those visitors, with all their pageviews.
Search finds an IP address or network (203.0.113.0/24), a host, a user ID, a member ID, an agent's name or a page. A page is its path, such as /products/ (or the full URL), and finds every page whose path starts with it; the query string after ? is not stored, so it is not searched. Separate terms with spaces; every term must match. Narrow a term with ip:, host:, user:, account:, agent: or path: (path:search finds paths containing "search"). Press Enter to search.
Export pageviews (CSV) gives the latest 1,000 pageviews behind the current filters, each with its visitor's verdict. Paid clicks has its own export of landings, and Member accounts of members.

When a verdict looks wrong

Open the visitor and use Wrong verdict? to pick what it should have been. That sends us a copy of the visitor's stored reports, so we can find out why and improve detection. The visitor shows "should be …" until we have reviewed it. You can change your answer while it is open. It marks the whole visitor, not one pageview, and asks for no explanation. The copy is deleted 30 days after you last send it (see Privacy).

The viewer does not show the individual signals behind a verdict. Questions about a verdict: support@telltale.bot.

Dates, times and how long data is kept

Times are shown in your time zone (Account settings › Preferences). Today and Yesterday are your calendar days. Longer ranges are whole days in UTC, and say so.
Reports are kept for 30 days, then deleted. Your plan's pageview counts per month are kept as numbers.
Your plan counts pageviews per calendar month in UTC, over all your sites, bots included. Going over it never stops reporting.