ChatWoot icon

ChatWoot

Interact with ChatWoot API

Actions117

Conversations → Conversation List Meta

AI-generated

Summary

Retrieve aggregated metadata about conversations for a specified ChatWoot account, filtered by optional criteria such as status, search query, inbox, team, and labels.

Inputs

  • Account Id (required) — The numeric ID of the ChatWoot account from which to retrieve conversation metadata.
  • Status — Filter conversations by their status; options include open, resolved, pending, or snoozed. Defaults to open.
  • Q — Search term to filter conversations by messages containing the specified text.
  • Inbox Id — Filter conversations associated with a specific inbox ID.
  • Team Id — Filter conversations assigned to a particular team ID.
  • Labels — Filter conversations by one or more labels using a JSON array.

Output shape

a single JSON record containing metadata about the conversation list matching the criteria

Results reflect the filtered metadata for conversations; pagination details or complete conversation lists are not returned by this operation.

Discussion