Actions113
- Accounts Actions
- Account Users Actions
- Agent Bots Actions
- Users Actions
- Inbox API Actions
- Contacts API Actions
- Conversations API Actions
- Messages API Actions
- CSAT Survey Page Actions
- Account Agent Bots Actions
- Agents Actions
- Canned Responses Actions
- Canned Response Actions
- Custom Attributes Actions
- Contacts Actions
- Contact Actions
- Automation Rule Actions
- Help Center Actions
- Conversations Actions
- Conversation Assignment Actions
- Conversation Labels Actions
- Inboxes Actions
- Messages Actions
- Integrations Actions
- Webhooks Actions
- Teams Actions
- Custom Filters Actions
- Reports Actions
Overview
This node operation "List All Conversation Statistics" under the "Reports" resource fetches aggregated conversation metrics from a ChatWoot account. It is designed to retrieve various statistics such as counts of conversations, incoming/outgoing messages, average response times, and resolution counts. This is useful for customer support teams or managers who want to analyze performance data across different scopes like accounts, agents, inboxes, labels, or teams.
Practical examples include:
- Getting the total number of conversations handled by an agent within a specific time frame.
- Measuring average first response time for a team to evaluate responsiveness.
- Tracking resolutions count for a particular inbox to assess effectiveness.
Properties
| Name | Meaning |
|---|---|
| Account Id | The numeric ID of the ChatWoot account for which the report is generated (required). |
| Metric | The type of metric to retrieve. Options: Conversations Count, Incoming Messages Count, Outgoing Messages Count, Avg First Response Time, Avg Resolution Time, Resolutions Count (required). |
| Type | The scope/type of the report. Options: Account, Agent, Inbox, Label, Team (required). |
| Id | The identifier of the specific object when the type is agent, inbox, or label (optional). |
| Since | Timestamp indicating the start date/time for the report data (optional). |
| Until | Timestamp indicating the end date/time for the report data (optional). |
Output
The node outputs JSON data containing the requested conversation statistics based on the selected metric and filters. The structure typically includes fields representing the metric values aggregated over the specified scope and time range.
No binary data output is indicated.
Dependencies
- Requires an API key credential for authenticating with the ChatWoot API.
- Needs the base URL of the ChatWoot instance configured in credentials.
- Relies on the ChatWoot REST API endpoints for fetching reports.
Troubleshooting
- Missing or invalid Account Id: Ensure the account ID is correct and exists in ChatWoot.
- Invalid metric or type selection: Choose valid options from the provided lists.
- API authentication errors: Verify that the API key credential is correctly set up and has sufficient permissions.
- Date format issues: Use proper timestamp formats for 'Since' and 'Until' properties to avoid query failures.
- Empty results: Check if the date range and filters actually contain data; adjust parameters accordingly.