conecto. Get started
Website chat

List chat conversations

chat_list_conversations · Reads only · Markdown

The website chat and email conversations, newest activity first, with who it is and the last message.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

An example

Which website chats from today are still open?

Your agent callschat_list_conversationsFree*

The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.

With these arguments
{
  "status": "open",
  "limit": 20
}
What comes back
{
  "conversations": [
    {
      "conversation_id": 4101,
      "status": "open",
      "channel": "web",
      "visitor": {
        "name": "Lisa Moreno",
        "email": "lisa.moreno@example.com"
      },
      "started_at": "2026-10-14T08:00:00+00:00",
      "last_message_at": "2026-10-14T08:00:00+00:00",
      "charge": "charged",
      "last_message": {
        "from": "visitor",
        "text": "Hi! Does the Tabor ship to Seattle, and how long does it take?",
        "at": "2026-10-14T08:00:00+00:00"
      }
    }
  ],
  "count": 1
}

Use it when

To see which conversations are open, waiting or recently active.

  • For new visitor messages as they arrive, use chat_wait.

What it does

Website chat (and email) conversations, newest activity first, with who it is and the last message.

What comes back

Up to 100 conversations, newest activity first, each with its conversation_id, status, channel, visitor, start and last-message times, charge state and last message, and how many were listed. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
statusstringOne of: open,pending,closed,any. Default: any.
limitinteger1 to 100. Default: 20.
beforestring (date-time)Only conversations active before this time, to page back.

The call

Over MCP, call chat_list_conversations on https://api.conecto.chat/mcp/chat. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/chat_list_conversations \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"open","limit":20}'

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
invalid_input400before is not an ISO 8601 time.Send a time like 2026-10-12T09:00:00Z.

More Website chat tools

All 9 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md