Skip to main content

CSV Downloads in the Qvasa App in Zendesk

CSV Downloads in the Qvasa App in Zendesk

Dashboards inside the Qvasa app in Zendesk are read-only, and until now that meant no CSV downloads there either: the Download Metric CSV icon you see on a widget in Qvasa was missing on the same widget in Zendesk. A per-dashboard setting, Allow CSV downloads in the Zendesk app, brings it back for the people who have inspect access on that dashboard.

The downloads it turns on are the ones built in the browser from what is already on the page: a widget's visible data, the rows in an inspect table, and a custom model chart's CSV. The heavier exports that run as a job in Qvasa stay in Qvasa.

Before you start

  • The dashboard is already shown in the Zendesk app. The setting only applies to a dashboard with Show in the Zendesk app ticked. If you are new to the app, start with The Qvasa App in Zendesk: Showing Dashboards and Controlling Access.

  • You can edit the dashboard. Anyone who can edit a dashboard can tick the setting, the same as for Show in the Zendesk app. It is off by default on every dashboard.

  • The agents have inspect access on the dashboard. The downloads go to the same people who get the Inspect Data magnifier on a widget in Qvasa: people who can edit the dashboard, people or groups given inspect access on the dashboard, or everyone, when By default read only users can leverage inspect features is ticked under Dashboard permissions on the dashboard edit page.

1. Tick the setting on the dashboard

Open the dashboard in Qvasa, click Edit, and look in the Access and behaviour card, right under Show in the Zendesk app. Tick Allow CSV downloads in the Zendesk app and click Update dashboard.

  • The setting is per dashboard. Tick it on each dashboard whose data agents should be able to take with them, and leave it off on the rest.

  • A copy of a dashboard starts with it off, exactly like Show in the Zendesk app, so a clone never hands out downloads by accident.

  • Nothing changes in Zendesk itself. The app reads the setting on its next open, so there is nothing to install, update or redeploy.

2. What agents get in Zendesk

Back in Zendesk, open the Qvasa app and the dashboard. Every widget that has data now carries the CSV icon in its top bar, next to the Inspect Data magnifier, for anyone with inspect access.

Download Metric CSV on a widget downloads what the widget is showing: the rows of a table, the bars of a chart, with the dashboard's filters and date range applied. It is the same file the icon gives you in Qvasa.

CSV in the inspect table. Click the magnifier to open the inspect lightbox and its CSV button downloads the rows currently shown in the table, with the columns of the inspect column set in use. See Drill Into the Records Behind a Count in an Inspect Table for what the lightbox can do.

  • Widgets that offer two downloads in Qvasa (the visible rows, or a full export of every row) offer only the first in the Zendesk app, named Download Visible Data.

  • Custom model charts keep their CSV menu in the app; its "every row" option points you to Qvasa.

What stays in Qvasa

Everything the Zendesk app downloads is built in the browser from the data already on the page. Anything that has to be produced by Qvasa as a background job is not offered in the app, whatever the setting says:

  • Full Export (All Data) on a widget, and Bulk Export CSV in the inspect lightbox.

  • Export tickets CSV on a flow chart node.

  • Scheduled exports and dashboard image exports.

Open the dashboard in Qvasa for those (Edit in Qvasa at the top of the app does it in one click, for anyone allowed to sign in).

The setting also never reaches embedded dashboards, external shareable links, image exports or the My QA Scores dashboard, and an account where CSV downloads are blocked for data-protection reasons stays blocked in the app too.

What done looks like

  • On the dashboard edit page, both Show in the Zendesk app and Allow CSV downloads in the Zendesk app are ticked.

  • In Zendesk, an agent with inspect access sees the CSV icon in the top bar of each widget, and a CSV button in the inspect lightbox.

  • Clicking either saves a file straight away. Nothing is queued, and no email arrives.

Troubleshooting

There is no CSV icon on the widgets in Zendesk. Check, in this order: the dashboard has Allow CSV downloads in the Zendesk app ticked; it also has Show in the Zendesk app ticked (the first setting does nothing without the second); the agent has inspect access on the dashboard (if they see no Inspect Data magnifier in Qvasa either, that is the reason). Then reopen the app in Zendesk, which reads the settings fresh.

Some widgets have the icon and some do not. A widget with no data, and display widgets such as titles and dividers, have nothing to download and show no icon, in Qvasa or in Zendesk.

I expected Full Export and only see Download Visible Data. That is by design. Full exports run as a job in Qvasa; open the dashboard there.

The icon is there but nothing downloads. The file is saved by your browser, inside Zendesk's app frame. If your browser blocks it, look for a blocked-download prompt in its address bar and allow downloads from Zendesk, then click again. If that does not help, contact us with the browser you use.

There is no "Allow CSV downloads in the Zendesk app" box on the edit page. It sits with Show in the Zendesk app and is not offered for personal dashboards. If the dashboard is not personal and both boxes are missing, contact us and we will enable the Zendesk app for your account.

Did this answer your question?