conecto. Get started
Website chat

Get a chat conversation

chat_get_conversation · Reads only · Markdown

One conversation with all its messages, from the visitor and from the business.

Free*

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

An example

What did the man asking about e-bike batteries say yesterday? Read me the whole chat.

Your agent callschat_get_conversationFree*

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
{
  "conversation_id": 3187
}
What comes back
{
  "conversation": {
    "conversation_id": 3187,
    "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",
    "messages": [
      {
        "from": "visitor",
        "text": "Hi! Does the Tabor ship to Seattle, and how long does it take?",
        "at": "2026-10-14T08:00:00+00:00",
        "note": false
      }
    ]
  }
}

Use it when

Before answering an older conversation, to read everything that was said.

What it does

One conversation with all its messages (from the visitor or the business).

What comes back

The conversation with its status, channel, visitor, times and charge state, and every message with who wrote it, the text, the time and whether it is a private note. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
conversation_idRequiredintegerAt least 1.

The call

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

Terminal
curl -X POST https://api.conecto.chat/v1/tools/chat_get_conversation \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"conversation_id":3187}'

When it refuses

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

CodeWhenWhat to do
not_found404No chat conversation of the business has that conversation_id.Find it with chat_list_conversations and use its conversation_id.

More Website chat tools

All 9 tools

Give this to your agent.

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