Get conversation

One conversation with its messages, assignee, labels and status.

MCP tool freshchat_read → get_conversation

read

Returns the messages of one conversation in order, who wrote each (customer, agent or bot), the status, the assignee and any label already applied. Use it before you reply, assign or resolve, because the Inbox changes while you read it. Private notes between agents are marked as such. Images and files in messages come back as links, not content.

Parameters

Parameters: get_conversation
NameTypeDescription
conversation_id string required string Conversation ID from list_conversations.

tools/call

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "freshchat_read",
    "arguments": {
      "operation": "get_conversation",
      "arguments": {
        "conversation_id": "conversation_8c41d2"
      }
    }
  }
}

Example response

JSON

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "conversation_id": "b3d9f1a2-6c4e-4a8b-95d7-2e1f0c8a7b64",
    "customer": "Lena Ortiz",
    "status": "assigned",
    "assigned_group": "Support",
    "assigned_agent": "Dana Reed",
    "label": null,
    "messages": [
      {
        "from": "customer",
        "text": "Can you add CSV export to reports?",
        "at": "2026-10-20T09:12:00Z"
      },
      {
        "from": "agent",
        "text": "Thanks, Lena. I passed it to the product team.",
        "at": "2026-10-20T09:20:00Z"
      }
    ]
  },
  "isError": false
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.