Get conversation

Every message of one live chat conversation, with who wrote each.

MCP tool tidio_read → get_conversation

read

Returns the messages of one conversation from the oldest to the newest. Each message has an author type of operator, contact or bot, the text and the time. It also returns the link that opens the conversation in the Tidio panel.

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": "tidio_read",
    "arguments": {
      "operation": "get_conversation",
      "arguments": {
        "conversation_id": "conversation_8c41d2"
      }
    }
  }
}

Example response

JSON

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "conversation_id": "cv_5a21",
    "url": "https://www.tidio.com/panel/inbox/conversations/cv_5a21",
    "messages": [
      {
        "author_type": "contact",
        "message": "Does the blue one come in size L?",
        "created_at": "2026-10-16T14:02:00Z"
      },
      {
        "author_type": "bot",
        "message": "Let me get a teammate for you.",
        "created_at": "2026-10-16T14:02:05Z"
      },
      {
        "author_type": "operator",
        "message": "Yes, L is in stock.",
        "created_at": "2026-10-16T14:09:40Z"
      }
    ]
  },
  "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.