ChatWoot icon

ChatWoot

Interact with ChatWoot API

Actions117

Conversations → Conversation List

AI-generated

Summary

Retrieve a paginated list of conversations from a specified ChatWoot account, optionally filtering by assignee type, status, search terms, inbox, team, and labels.

Inputs

  • Account Id (required) — The numeric ID of the ChatWoot account to list conversations from.
  • Assignee Type — Filter conversations by who they are assigned to: 'Me', 'Unassigned', 'Assigned', or 'All' (default).
  • Status — Filter conversations by their status: 'Open' (default), 'Resolved', 'Pending', or 'Snoozed'.
  • Q — Search filter to return conversations containing messages with this search term.
  • Inbox Id — Filter conversations by a specific inbox numeric ID.
  • Team Id — Filter conversations assigned to a specific team by numeric ID.
  • Labels — Filter conversations by labels. Accepts a JSON array.
  • Page — Specify the page number for paginated results, defaults to 1.
  • Request Options — Advanced options including request batching, ignore SSL issues, proxy settings, and request timeout.

Output shape

a list of conversation objects matching the provided filters

Results are paginated with page number input; use Request Options to control batching and request behavior. Requires a ChatWoot API credential with base URL configured.

Discussion