TABLE OF CONTENTS

What is the Historical Reports app?

Generate reports over the past 30 days to use the data and streamline further operations.

The reports are generated in a ZIP file and sent to an email address of your choice within 15 minutes.


Historical Reports is available as an app in the Freshchat Apps store (Marketplace).


Types of reports that you can get with Historical Reports

  1. Interaction Report: The complete raw report that lists the details of all conversations and metrics on how each interaction was handled. Includes first response time, response time, resolution time, groups/agents who handled the chats, csat, label, etc.
    Maximum time range allowed for this day is 1 day.

  2. Agent Performance Report: This report tracks overall agent performance in terms of  availability, response times, chats handled, concurrency, etc.
    Maximum time range allowed for this report is 1 day.

  3. First Response Time Report: This raw report tracks the time agents and groups take to send the first response to a customer message. 

  4. Response Time Report: This raw report tracks the time agents and groups take to reply to a message in a conversation. 

  5. Message Sent Report: These raw reports list the details of all messages sent within a time frame. This helps track the volume of agent activity.

  6. Resolution Time Report: This raw report tracks the time agents and groups take to resolve a conversation assigned to the agent or group.

  7. Conversation-Created Report: This raw report lists the details of all conversations created within a time frame. This helps track the volume of incoming conversations.

  8. Conversation Resolved Report: These raw reports list the details of all conversations resolved within a time frame. This helps track the volume of resolved conversations.

  9. Conversation Agent Assigned Report: This report tracks the time taken to assign a conversation to an agent.

  10. Conversation Group Assigned Report: This report tracks the time taken to assign a conversation to a group.

  11. Conversation Resolution Label Report: This raw report lists the details of all resolution labels attached to a conversation when the conversation is resolved. This helps track the trend in conversation volumes by aggregating the percentage of conversations belonging to a specific category and sub-category of resolution.

  12. CSAT Score Report: This raw report lists all customer satisfaction ratings received agent-wise, within a specific time frame. This helps monitor customer satisfaction levels and generate useful, actionable metrics such as the number of unsatisfactory conversations.

  13. Agent Activity Report: This report tracks agent activity in the Freshchat dashboard.

  14. Agent IntelliAssign Activity Report: This report tracks agent activity when a conversation is auto-assigned through IntelliAssign.

  15. Chat-Transcript Report: This report lists all chat transcripts (conversations and the corresponding messages) created within a time frame of 24 hours. For this report, the end value should not exceed 24 hours from the start value.


How to install Historical Reports:


To install, go to Apps > Bots & Workflows > Historical Reports > Install.





Once Installed, go to Installed Apps, click on the gear icon in the right and select Settings




You will see a screen like this. Now click on the gear icon to set up the app




Choose your timezone



Fill in the email address to which the reports are to be delivered and the domain of your Freshchat account in the specified format



Before you can start using Historical Reports, you need to add the API Token.


How to get API Token

To get the API Token, go to Admin > API Tokens > Generate Token. Once the token is generated, click copy



Then paste it into the App settings. Once you’ve added the API Token, click Save. You can now start generating reports for any given timeline.

 

Your app is now set up.

Generating Reports

  1. Go to Settings and choose the type of report from the drop-down menu.


  1. Pick a time range for the selected report


  1. Click “Generate Report”.


      

     4. The report will be delivered to your designated email ID within the next 15 minutes depending on the time range of the report.

 


Note: You can generate reports for only 1 day for Interaction and Agent performance reports because of the large size of these reports.


You can also view logs for the usage of the app. Go to Logs, and select the option by choosing from the drop-down menu.


You can refer to the report glossary here.