Transfer chat
Move a chat to another agent or to a group.
MCP tool livechat_write → transfer_chat
write Confirm
Transfers an active chat to one agent, or to a group where it goes to the first free agent by your routing rules. You cannot pick an agent inside another group. An optional private note goes along on Business and Enterprise. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| chat_id string required | string | Chat ID from list_chats or list_archived_chats. |
| agent_id string | string | Agent from list_agents. Use this or group. |
| group string | string | Group from list_agents. Use this or agent_id. |
| note string | string | Private note for the next agent. Business and Enterprise. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "livechat_write",
"arguments": {
"operation": "transfer_chat",
"arguments": {
"chat_id": "chat_8c41d2"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"chat_id": "PJ0MRSHTDG",
"status": "transferred",
"to": {
"group": "Billing"
}
},
"isError": false
}