Overview

This node operation retrieves metadata about conversations from the Konverte Digital API, specifically listing conversation metadata based on various filters. It is useful for scenarios where users want to fetch summarized information about conversations in an account, such as filtering by status, searching by message content, or filtering by inbox, team, or labels. For example, a user can list all open conversations in a specific inbox or search conversations containing a particular keyword.

Use Case Examples

1. List all open conversations for account ID 12345.
2. Retrieve conversations filtered by status 'resolved' and team ID 678.
3. Search conversations containing the term 'urgent' in messages.

Properties

Output

JSON

• conversations - Array of conversation metadata objects returned from the API.
• meta - Metadata about the list response, such as pagination details.

Dependencies

• Requires an API key credential for authentication with the Konverte Digital API.

Troubleshooting

• Ensure the Account Id is correctly set and corresponds to an existing account; otherwise, the API may return an error or empty results.
• If filtering by status, ensure the value is one of the supported options (open, resolved, pending, snoozed) to avoid invalid query errors.
• When using labels as a JSON array, ensure the JSON is correctly formatted to prevent request failures.
• If SSL certificate validation errors occur, consider enabling the 'Ignore SSL Issues' option, but be aware of security implications.
• Timeout errors may occur if the server is slow to respond; increase the timeout setting if needed.