Contact reasons report
In the app: Reports → Contact reasons
Needs the 'View Reports' permission.
Shows why customers got in touch: this report counts conversations with a recorded contact reason, such as a question about delivery or a return. It can also show what customers mention, and which products and campaigns lead to the most contacts.
When the report is available
The tab is only in the Reports strip for organizations that have Squid Agent switched on. For other organizations the page shows "Available with Squid Agent" with a link back to Reports, and no figures.
Period and view buttons
- "Last 7 days", "Last 30 days", "Last 90 days": the period, ending today. The default is the last 7 days. Days are UTC days. There are no date fields and no store filter on this page.
- "Show the last reason" / "Show the first reason": a conversation can get more than one reason as it goes on. By default the report counts the first one, which is why the customer got in touch. The other view counts the last one, which is what the conversation ended up being about.
- "Show Squid's labels" / "Show the AI categorizer's reasons": switches between two sources. The default is the reason your AI agent's categorizer gave while handling the conversation, on the Squid default list of reasons. "Squid's labels" are given afterwards to closed conversations, on your own version of the list, and add the details under "What customers mention".
- "Show products" and "Show campaigns" open the two tables described below.
- "Show the list of reasons" shows the list the labels come from.
A teammate whose access is limited to certain stores only sees those stores' conversations.
Why customers got in touch
A table with one row per contact reason: "Contact reason", its "Group", "Share" and "Conversations".
- A conversation is counted when it was created in the period and has a contact reason. Deleted and merged tickets, the example ticket and unanswered outbound campaign tickets are left out, as in the other reports.
- "Conversations" is the number of conversations with that reason.
- "Share" is that number as a percentage of the conversations that have a reason. Conversations without a reason are not in the total, so the shares add up to about 100%, allowing for rounding.
- The line under the table, such as "412 of 530 conversations have a contact reason, from the Squid default list of reasons", says how many conversations of the period have one, and from which date reasons have been kept. For the categorizer, the date is the first recorded reason. With "Squid's labels" on, it is the earliest creation day represented in the labelled counts for the current list version. A conversation created earlier can be labelled when it closes later.
"No conversation in this period has a contact reason yet." means nothing was labelled in the period, for example because the AI did not handle any conversation.
With "Squid's labels" on, a line above the table names the version of the list the labels were made on. Counts from two versions of the list are never added together.
What customers mention
Only shown with "Squid's labels" on. For closed conversations selected for labelling, Squid records a few details from a fixed list, such as the carrier and the kind of issue. Below 3,000 eligible conversations a day it selects all of them; from 3,000 it selects half within each store and channel, rounded up. The analysis budget can reduce that sample further, and conversations without customer text are skipped. Each detail has its own small table with the number of conversations per value, that number as a percentage of the conversations Squid labelled in the period, and "Not mentioned" for the labelled conversations where it did not come up. A conversation counts in the period in which it was created, not the one in which it was closed or labelled.
The labels are Squid's reading of the conversation. They are never the customer's own words.
A button next to a value opens "Examples": the newest conversations with that value, with the date, channel, contact reason and details of each, but no customer text. Up to 10 are shown. Seeing examples also needs the permission to view conversations.
Products with the most contacts
Shown after "Show products". One row per product and store, for the chosen period.
- "Contacts": conversations created in the period that are linked to an order containing the product, per 1,000 units of the product sold in the period. The linked order can be older than the period.
- "Refunds": orders containing the product that got a refund in the period, per 1,000 units sold.
- "Store avg" next to each: the same rate for the whole store, over every unit the store sold, to compare against.
- "Status": for a product with a rate it reads, for example, "2.1× the store average": the product's contacts rate divided by its store's contacts rate. It compares contacts only, not refunds, and shows a dash when the store has no contacts to compare with. For a product that sold too little it reads "Under 300 sold".
Test orders are left out of units, contacts and refunds. Cancelled orders are left out of units and refunds, but contacts linked to them still count. A rate is only shown for a product that sold at least 300 units in the period. Products below that are listed under the others with "Not published" in the "Contacts" column, a dash for refunds and "Under 300 sold" as their status, because a rate over a handful of sales says little.
The table lists the 50 products with the highest contacts rate, highest first, and then at most 20 products below 300 units, most sold first. "More products are left out." appears when there are more. The figures are built once a night per UTC day, so today's sales and contacts are not in them yet.
A high rate shows where customers get in touch more per sale. It does not say why; use the contact reasons and examples for that.
Campaigns with the most contacts
Shown after "Show campaigns". One row per store and marketing source and campaign, read from the UTM tags of the orders. "(none)" is the orders without UTM tags.
- "Orders": orders placed in the period whose campaign information was captured within two days of the order and is ready to use. Test and cancelled orders are left out.
- "Contacts": conversations linked to those orders, per 1,000 orders. The menu above the table limits contacts by the categorizer’s first contact reason group; refunds always count every refund. The menu is shown only with the categorizer’s reasons and when there are groups to choose from. Switching to "Squid's labels" hides the menu but keeps an already selected group applied.
- "Refunds": those orders that got a refund, per 1,000 orders.
- "Store avg": the same rate over every order of the store that has a campaign read, "(none)" included.
- "Status": as for products, the campaign's contacts rate divided by its store's, such as "1.4× the store average". A campaign with fewer than 300 orders reads "Not published" in the "Contacts" column and "Under 300 orders" as its status.
Contacts and refunds are counted up to today, not only inside the period, so campaigns with recent orders have had less time to collect them. A rate is only shown from 300 orders. The table lists the 50 campaigns with the highest contacts rate and then at most 20 below 300 orders.
The line above the table says how many of the period's orders have a campaign read. Campaigns are only read for orders placed while UTM capture is on; older orders never get one, and the page says so when capture is switched off.
The list of contact reasons
Shown after "Show the list of reasons". It shows the version of the list in use, its reasons per group, the details Squid records with their possible values, and earlier versions with who saved them.
A new version is used for conversations labelled from then on. Conversations labelled earlier keep the version they were labelled on.
The list cannot be edited on this page. Changes are proposed through Squid Agent and approved by someone with the "General Settings" permission. People who may use Squid Agent see "Propose a change", which opens Squid Agent with the request started for them.