Conversation Tools

Tools for managing customer conversations across channels.

conversation_list

List conversations with status, channel, and assignee filtering. Parameters:

Parameter	Type	Required	Default	Description
`channelId`	string	No	—	Filter by channel ID
`status`	string	No	—	Filter by status: `open`, `closed`, `assigned`, `pending`
`assignedTo`	string	No	—	Filter by assigned user ID
`page`	number	No	1	Page number
`limit`	number	No	20	Items per page

Example:

{
  "status": "open",
  "channelId": "ch_abc123"
}

conversation_get

Get conversation details with contact info. Parameters:

Parameter	Type	Required	Description
`id`	string	Yes	Conversation ID

conversation_close

Close a conversation. Parameters:

Parameter	Type	Required	Description
`id`	string	Yes	Conversation ID to close

conversation_assign

Assign a conversation to a team member. Parameters:

Parameter	Type	Required	Description
`id`	string	Yes	Conversation ID
`userId`	string	Yes	User ID to assign to

Assigning a conversation automatically sets its status to assigned.

conversation_messages

Get messages for a conversation (paginated, newest first). Parameters:

Parameter	Type	Required	Default	Description
`conversationId`	string	Yes	—	Conversation ID
`page`	number	No	1	Page number
`limit`	number	No	50	Messages per page (max 100)

Response:

{
  "data": [
    {
      "id": "msg_abc123",
      "content": "Hello, how can I help you?",
      "type": "text",
      "direction": "outbound",
      "status": "delivered",
      "senderType": "agent",
      "createdAt": "2026-05-08T10:30:00.000Z"
    }
  ],
  "total": 42,
  "page": 1,
  "limit": 50,
  "totalPages": 1
}

Getting Started

Tools Reference

Resources

Conversation Tools

Conversation Tools

conversation_list

conversation_get

conversation_close

conversation_assign

conversation_messages

​Conversation Tools

​conversation_list

​conversation_get

​conversation_close

​conversation_assign

​conversation_messages

Conversation Tools

conversation_list

conversation_get

conversation_close

conversation_assign

conversation_messages