Skip to content
Browse documentation

Dashboard and what the numbers mean

The Dashboard is the first screen in the ChatFlint menu, and the only reporting screen you need to visit regularly. Everything on it is computed from your own database — nothing is sent anywhere to produce it.

The setup checklist

While anything essential is still missing, the Dashboard opens with a checklist instead of charts: an API key, an embedding provider, some knowledge, and the widget switched on. It counts itself down (“3 of 5 complete”) and disappears once you are live. If you would rather it were gone sooner, each item links straight to the setting that satisfies it.

The totals

  • Total conversations — distinct chat sessions, not messages. A visitor who returns the next day and continues is still one conversation only if the session survived; otherwise it is two.
  • Total messages — everything either side said.
  • Average messages per conversation — the honest measure of whether people are getting somewhere. Two is a question answered. Ten is usually a visitor going in circles, and worth reading.
  • Satisfaction rate — positive ratings as a share of all ratings, if ratings are switched on.

Underneath, Daily conversations (last 7 days) plots volume. A flat line at zero on a live site nearly always means the widget is hidden rather than ignored — check Design → Placement & Visibility first.

The ten most-asked questions of the last 90 days, exactly as they were typed. This is the rawest view on the screen: not clustered, not tidied. It is the fastest way to spot a question you should simply add to the knowledge base word for word.

Why a number can look stale

The expensive panels are cached for five minutes so that opening the Dashboard never runs a pile of aggregate queries on a busy site. If you have just been testing the chat yourself and the numbers have not moved, wait five minutes or use Refresh stats.

Deleting a conversation removes it from every number here. Retention does the same on a schedule — if your retention window is 30 days, a 90-day panel can only ever show 30 days of data.

Still stuck? Ask the assistant in the corner of this page — it has read all of this — or send us a message.

Last updated September 18, 2026