list_conversations
Read-onlyIdempotent
List messaging conversations across WhatsApp, Messenger, Instagram, Threads, SMS, email, and other enabled channels. Threads items are public conversations. Shows unread counts and last message time.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number (default 1) | |
| limit | No | Page size (default 20, max 50) | |
| search | No | Search by contact name, phone, or email | |
| status | No | Filter by conversation status | |
| channel | No | Filter by channel | |
| assignee | No | "mine": conversations assigned to you. "unassigned": no assignee. Cannot be combined with assignedToId. | |
| assignedToId | No | Only conversations assigned to this company member ID (companyMembers.id) |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | Tool result payload — shape varies per tool, see the tool description | |
| summary | Yes | One-line human-readable summary of the action | |
| renderType | Yes | UI rendering hint for the result |