Conversations

Tool	REST endpoint	Annotations
`list_conversations`	`GET /v1/conversations`	read-only, idempotent
`get_conversation`	`GET /v1/conversations/{id}`	read-only, idempotent
`update_conversation`	`PATCH /v1/conversations/{id}`	write, non-destructive

`list_conversations`

Lists conversations in the workspace grouped, with pagination and filters by channel, tags, and date range.

Field	Type	Default	Description
`limit`	`1-200`	`50`	Conversations per workspace.
`offset`	`≥ 0`	`0`	For pagination.
`channelId`	`string`	—	Filters by a specific channel.
`sortBy`	`"lastUpdate" \\| "creationDate"`	`lastUpdate`
`sortDirection`	`"asc" \\| "desc"`	`desc`
`tags`	`string[]` (max 10)	—	Filters by tags.
`dateFilter`	object	—	`{ type: "specific"\\|"range", date \\| startDate \\| endDate }`.

`get_conversation`

Fetches a conversation by ID or by the customer's phone number, including the full message history. Searches across every workspace the API Key has access to.

Field	Type	Required	Description
`conversationId`	`string`	yes	Customer ID or phone number.
`channelId`	`string`	no	Restrict to a specific channel.

`update_conversation`

Updates owners (owners) and/or status (status) of a conversation. At least one must be sent.

Field	Type	Required	Description
`conversationId`	`string`	yes	ID or phone number.
`workspace`	`string`	if multi-ws	Workspace ID.
`channelId`	`string`	no	Limit to a specific channel.
`owners`	`string[]` (emails)	one of	New list of owners.
`status`	`"active" \\| "finished" \\| "expired" \\| "spam"`	one of	New status.

Example

{
  "name": "update_conversation",
  "arguments": {
    "conversationId": "+521234567890",
    "status": "finished",
    "owners": ["ana@miempresa.com"]
  }
}

Previous Messages Next Customers