Konverte Digital icon

Konverte Digital

Interact with Konverte Digital API
Join our community

Actions115

Overview

This node operation fetches a summary report of conversation statistics from the Konverte Digital API for a specified account. It supports filtering the report by type (account, agent, inbox, label, or team), specific object ID, and time range (since and until timestamps). This is useful for users who want to analyze conversation metrics across different scopes within their account, such as overall account performance, individual agents, or specific inboxes.

Use Case Examples

  1. A customer support manager wants to retrieve conversation statistics for the entire account to monitor overall team performance.
  2. A team lead wants to get conversation stats for a specific agent to evaluate their workload and efficiency.
  3. An admin wants to generate a report for a particular inbox to understand customer interaction volume during a specific period.

Properties

Name Meaning
Account Id The numeric ID of the account for which the report is generated.
Type The type of report to generate, such as account-wide, agent-specific, inbox-specific, label-specific, or team-specific.
Id The ID of the specific object (agent, inbox, or label) to filter the report by.
Since The start timestamp from which the report data should be collected.
Until The end timestamp until which the report data should be collected.
Request Options Additional request settings such as batching, SSL certificate validation, proxy configuration, and request timeout.

Output

JSON

  • data
    • report
      * type - The type of report generated (account, agent, inbox, label, or team).
      * since - The start timestamp of the report data range.
      * until - The end timestamp of the report data range.
      * statistics - The summarized conversation statistics for the specified scope.

Dependencies

  • Konverte Digital API
  • An API key credential for authentication

Troubleshooting

  • Ensure the Account Id is correct and the user has access to the specified account.
  • Verify that the 'type' parameter matches one of the allowed values (account, agent, inbox, label, team).
  • If filtering by Id, ensure the Id corresponds to a valid object of the specified type.
  • Check the 'since' and 'until' timestamps are in a valid format and logical order (since <= until).
  • If SSL errors occur, consider enabling the 'Ignore SSL Issues' option or verify the SSL certificate validity.
  • If requests time out, increase the 'Timeout' setting or check network connectivity.
  • When using a proxy, ensure the proxy URL and credentials are correct.

Links

Discussion