Docs

BotSay docs

How to set up BotSay, read your numbers and act on them.

Getting started

What BotSay measures

What BotSay reads from AI search answers, the five measures it reports, the five places in the app, and the things it does not do.

Set up your workspace

Go through guided setup after you pay, from the welcome screen to your first questions, and learn how to leave part way, resume and add questions later.

When your first numbers arrive

What This week shows while you wait for your first reading, what to check if it does not start, and how to read the starting figures when it lands.

Reading your numbers

What the This week page shows

A walk down the This week page, from the edition line and headline to the standings, the other four measures, what changed and the work waiting for you.

What the five measures mean

How Mention rate, Share of voice, Average rank, Your pages cited and Sentiment are defined and counted, what moves each one, and a worked example of each.

Compare yourself with rivals on Standing

What each of the five Standing tabs answers, how to read the headline at the top, the Over time band and the notes on By theme and Gained and lost.

What the Evidence page shows

How to read the two Evidence tabs, from the list of answers and a single answer to the sites and pages the engines cited, and what each count means.

Why a number is blank or shows a range

What Not measured, cannot say yet, a likely range, Provisional and a move small enough to be chance each mean on This week and Standing, and what to do next.

Acting on it

Work out what to do next

How Work ranks what to do about topics where a rival beats you, how to start, set aside and publish an item, and how to read the result BotSay shows afterwards.

Find pages to get your brand onto

Which pages appear on Where to get in, how rows are ranked, what each What to do label asks of you, how to narrow the list and why it can be empty.

Setup

Manage your questions and themes

How to add questions one by one or from a CSV file, reword, stop and tidy them, read the Named you counts, and group questions into themes within your limit.

Set your brand, sites and rivals

How to mark your brand, add its other names and sites, track or stop tracking rivals, and decide the names and sites BotSay found in the answers.

Which AI engines BotSay asks

What each of the six engines is, why the two Google ones come back a day later, and what the Setup, Engines page lets an admin see.

When readings happen

What a reading is, what the Setup, Readings table and its state words mean, why a week can still be incomplete and why no reading is booked.

Set a target for each measure

Where an admin types a target for each of the five measures, what a target changes on screen, what the suggested next step means and who can set one.

What admins and members can do

Which actions need an admin, how to invite, resend, revoke and remove people, how to read the change log and what the Your account page shows.

Plans and billing

Plans and prices

How the three plans differ, what each one includes, how your question limit works, and how signing up and paying works from the signup page.

Change plan, cancel and see your bills

How an admin changes plan, updates the card or cancels from Setup, Billing, and where past bills and their PDFs are.

Trust and data

How BotSay measures your numbers

A summary of BotSay's method, covering official engine services, weekly reads, what figures are counted out of, how a change is judged and where to take care.

Export your data as CSV

Where the two CSV buttons are, which columns each file holds, why Evidence totals can add up too high and why a download can stop.

What data BotSay stores

What BotSay keeps about your workspace and your people, what it sends to the AI engines, how Stop asking treats history and where the privacy documents are.