Get a chat

Read one chat: every message, the client details and the chat topic.

GET https://cotlet.dev/api/v1/jivochat/chats/{chat_id}

read

get_chat returns the whole conversation in the order it happened, each message with who wrote it (client, agent or bot), the text and the time. It also returns the client card the app shows next to the chat and the chat topic, if an agent set one. Files and photos come back as links, not as content.

Parameters

Parameters: get_chat
NameTypeDescription
chat_id string required string Chat ID from list_chats.

Request

cURL
curl https://cotlet.dev/api/v1/jivochat/chats/chat_8c41d2 \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("jivochat", "get_chat", {"chat_id":"chat_8c41d2"})
Node.js
const result = await cotlet.call('jivochat', 'get_chat', {"chat_id":"chat_8c41d2"});
CLI
cotlet call jivochat get_chat --data '{"chat_id":"chat_8c41d2"}'

Example response

JSON

{
  "chat_id": "6f1a2b3c",
  "channel": "Live Chat",
  "client": {
    "client_id": "cl_3a91",
    "name": "Dana Whitfield",
    "email": "dana@example.com"
  },
  "topic": null,
  "messages": [
    {
      "from": "client",
      "text": "Is the 12-inch model in stock?",
      "sent_at": "2026-10-19T09:41:00Z"
    },
    {
      "from": "bot",
      "text": "One moment, I am looking for an agent.",
      "sent_at": "2026-10-19T09:41:04Z"
    }
  ]
}

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.