Konverte Digital icon

Konverte Digital

Interact with Konverte Digital API
Join our community

Actions115

Overview

This node operation lists conversations from the Konverte Digital API based on various filters and pagination options. It is useful for retrieving and managing customer support or communication threads within an account. For example, a user can list all open conversations assigned to them or filter conversations by status, assignee type, or specific inbox or team IDs.

Use Case Examples

  1. List all open conversations assigned to the current user in a specific account.
  2. Retrieve conversations filtered by status (e.g., resolved or pending) for a given team or inbox.
  3. Search conversations containing specific keywords in messages.

Properties

Name Meaning
Account Id The numeric ID of the account to list conversations from.
Assignee Type Filter conversations by assignee type such as 'Me', 'Unassigned', 'All', or 'Assigned'.
Status Filter conversations by their status such as 'Open', 'Resolved', 'Pending', or 'Snoozed'.
Q Search term to filter conversations containing messages with this text.
Inbox Id Filter conversations by a specific inbox ID.
Team Id Filter conversations by a specific team ID.
Labels Filter conversations by labels in JSON format.
Page Page number for paginating through conversations.
Request Options Additional request options such as batching, SSL certificate validation, proxy settings, and timeout configuration.

Output

JSON

  • id - Unique identifier of the conversation.
  • status - Current status of the conversation.
  • assignee_id - ID of the user assigned to the conversation.
  • inbox_id - ID of the inbox the conversation belongs to.
  • team_id - ID of the team associated with the conversation.
  • labels - Labels assigned to the conversation.
  • messages - Messages contained within the conversation.
  • created_at - Timestamp when the conversation was created.
  • updated_at - Timestamp when the conversation was last updated.

Dependencies

  • Konverte Digital API

Troubleshooting

  • Ensure the Account Id is correctly provided and exists in the system to avoid empty or error responses.
  • Verify that the API credentials (API key and URL) are correctly configured to authenticate requests.
  • If filtering by assignee type, status, or other parameters, ensure the values are valid and supported by the API.
  • Timeout errors may occur if the server is slow or unresponsive; adjust the timeout setting accordingly.
  • SSL certificate validation errors can be bypassed by enabling the 'Ignore SSL Issues' option, but this should be used cautiously.

Links

Discussion