Get conversation

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

GET https://cotlet.dev/api/v1/tidio/conversations/{conversation_id}

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.

Request

cURL
curl https://cotlet.dev/api/v1/tidio/conversations/conversation_8c41d2 \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("tidio", "get_conversation", {"conversation_id":"conversation_8c41d2"})
Node.js
const result = await cotlet.call('tidio', 'get_conversation', {"conversation_id":"conversation_8c41d2"});
CLI
cotlet call tidio get_conversation --data '{"conversation_id":"conversation_8c41d2"}'

Example response

JSON

{
  "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"
    }
  ]
}

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.