Skip to main content

Ask Kapiche for Viewers

Let the people you share Smart Reports with ask questions about them, with answers drawn only from the report.

Written by David Perkins

Ask Kapiche on the reports you share

Viewers can use Ask Kapiche on the Smart Reports shared with them. A store, region or team manager reading a report can ask a follow-up question in plain words and get an answer drawn only from that report's data.

Ask Kapiche for Viewers stays inside the report. It can't reach other reports, analyses or projects, and a Viewer gets no more data through the chat than they could see by using the report itself.

1. Who It's For & What You Need

Who is it for?

  • Viewers: managers and stakeholders who read reports and want to ask about them.

  • Report authors: Creators who decide what each report's Viewers can change.

  • Site Admins: who turn the feature on for the site.

Prerequisites

  • Ask Kapiche must be on for your site.

  • A site Admin must turn on Ask Kapiche for Viewers. It's off by default, including on existing sites.

  • The Viewer must have access to the report. See Different user types in Kapiche.

2. Turning It On (Site Admins)

  1. Go to Settings › AI › Overview.

  2. Turn on Ask Kapiche for Viewers.

Only site Admins can change this setting. Turning it off removes Ask Kapiche from every Viewer on your site. Explorers and Creators keep it.

If you don't see the setting, ask your Customer Success Manager to switch it on for your subscription.

3. Choosing What Viewers Can Change (Report Authors)

A report's saved filters decide what its Viewers can reach, on the report and in Ask Kapiche.

  1. Open the report and click Edit mode.

  2. Click Manage filters.

  3. Under Filters on this report, set each filter to Locked or Viewers can change.

  4. Under Other fields Viewers can add, tick any other fields Viewers may filter by.

  • Locked: the filter always applies. Viewers see it as a grey pill they can't change, and Ask Kapiche can't answer outside it.

  • Viewers can change: Viewers can change the filter on the report, and Ask Kapiche uses whatever they have set.

In Edit mode, a locked filter carries a Locked for Viewers tag, so you can see what's locked without opening Manage filters. Explorers and Creators can always change every filter.

Themes and theme groups you hide on the report's Configure page are hidden from Ask Kapiche for Viewers too.

Keeping a Viewer to one segment

A per-segment schedule filters the emailed link and the PDF to one segment. A Viewer who opens the report another way can see every segment the report covers, and Ask Kapiche can answer about all of them. To keep a Viewer to one segment, give them a report for that segment with a Locked filter on it. See Smart Reports: Segment Reports & Per-Segment Delivery.

4. Asking a Question (Viewers)

  1. Open a report that has been shared with you.

  2. Click the Ask Kapiche button (the pill with the colored outline) to open the panel.

  3. Type a question, or click one of the suggested questions.

For example:

  • "Why did NPS drop this month?"

  • "What are customers saying about wait times?"

  • "Which themes are driving complaints from phone customers?"

Your chats are kept with the report. Use History to reopen an earlier chat about it, or New chat to start again.

What Ask Kapiche uses to answer

  • The report's locked filters, which always apply.

  • The filters and period you have set on the report. Change a filter and ask again, and the answer changes with it.

  • Only the themes the report shows, and only the response fields the report shows, unless the author has ticked Viewers can see response details on the report's configuration page.

When a question goes beyond the report

If you ask about something the report doesn't cover, such as a region its locked filter leaves out, a hidden theme, or another report or project, Ask Kapiche tells you which part of the report keeps it out. If it's a filter you can change, it points you to it. It also offers a related answer the report does cover.

Requesting access

When an answer says a question reaches beyond the report, Ask Kapiche offers a Request access card. Click it to email your site Admins and the Kapiche team. The email names you, the report and what you asked for. You can send one request an hour, and the card shows Requested once it's sent.

What Viewers can't do with Ask Kapiche

  • Choose other analyses or projects for a chat.

  • Export verbatims or download responses.

  • Create or change reports.

FAQs

Can a Viewer see more data through Ask Kapiche than on the report?

No. Ask Kapiche for Viewers answers only from the data the Viewer could reach by using the report: its locked filters always apply, and only the filters the Viewer can change are open to them.

Does Ask Kapiche work the same way for Explorers on a report?

No. For Explorers and Creators, Ask Kapiche answers across the whole analysis unless the question refers to the report. See How to use Ask Kapiche.

Why can't a Viewer see the Ask Kapiche button?

Check that Ask Kapiche is on for your site and that Ask Kapiche for Viewers is turned on under Settings › AI › Overview. Viewers see Ask Kapiche only on the reports shared with them.

How do I stop Viewers changing a filter?

In the report's Edit mode, click Manage filters and set the filter to Locked. See Choosing What Viewers Can Change.

Questions? 🤔

If you have any questions or feedback about Ask Kapiche for Viewers, get in touch via the blue chat bubble in Kapiche, or email support@kapiche.com.

Did this answer your question?