Tag and archive finished LiveChat chats

1. In the Chats section, an agent opens a finished chat in My chats and clicks the Add tag link at the bottom of the page, then picks one or more tags from the list.
2. Tags come from Settings > Tags, where only admins and the owner can add them, up to 70 characters each, optionally limited to one group.
3. The agent then hovers over the customer name and clicks x > Close and archive, or opens the three dots menu and chooses Stop this chat > Stop chat.
4. When an agent archives an untagged chat, LiveChat can show a short reminder to tag it first, so the tag is a manual step on every conversation.
5. Later, Archives filters by Tags with Match all or Match any, which only helps if the tagging was done and done the same way each time.

Go through my open chats in LiveChat that the customer left. Tag each with the topic from the tags we already have, then close and archive it. Leave chats that are still active.

1. 01

   Find chats that are over

   list_chats reads My chats and your agent keeps the chats where the last message is from the customer long ago or the customer said goodbye. Active conversations are never touched.

2. 02

   Learn the tag list first

   list_tags returns the tags your role can see, so the agent only uses names that exist. It never invents a tag, because creating tags is an admin task in Settings > Tags.

3. 03

   Read before tagging

   get_chat returns the transcript, and the agent picks the tags that match what was asked, for example refund or shipping. A chat that fits no tag is listed for you.

4. 04

   Tag, then archive

   tag_chat adds the tags and archive_chat closes the chat. Tags go first, so a stopped run leaves a tagged chat and never an archived chat without a tag. Closing ends the chat for the customer, so it waits for your OK by default.

5. 05

   Report what was left

   Chats with no fitting tag, and chats that had new messages in the meantime, stay open and come back in the summary.

Open chats checked: 14
Tagged and archived 11, e.g. PJ0MRSHTDG tagged refund
Left open because the customer is still writing: 2
Left for you, no fitting tag: 1 ("question about a reseller contract")

curl -X POST https://cotlet.dev/api/v1/livechat/chats/PJ0MRSHTDG/tag \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"add":["refund"]}'

{
  "chat_id": "PJ0MRSHTDG",
  "added": [
    "refund"
  ],
  "removed": [],
  "tags": [
    "refund"
  ]
}

MCP: add https://cotlet.dev/mcp/v1 with the same key; the call is livechat_write → tag_chat. Example data.

• Answer unassigned LiveChat chats from the offline hours
• Build LiveChat canned responses from past chats
• LiveChat (Text) API and MCP server: every tool
• All use cases