All MCP tools
MCP tools · Chat inbox
list_conversations
Lists the organization's chat conversations (WhatsApp, SMS, email, web chat and more), newest first. Filter by status, channel or a search over contact name, phone, email and message text.
- Scope needed
- chat:read or chat:write
- Changes data
- No, read only
- Held for approval
- No
- Available to
- Switched on per organization (MCP task tools)
Inputs
| Name | Type | Description |
|---|---|---|
| org_id | string | Organization id. Leave out when the user belongs to one organization; otherwise the error lists theirs. |
| status | enum: open | pending | snoozed | resolved | all | Conversation status. Default: open. |
| channel | enum: whatsapp | sms | email | messenger | instagram | webchat | Only this channel. |
| q | string | Search text: a name, phone, email or words from a message. |
| cursor | string | next_cursor from the previous page. |