conecto. Get started
Help desk

Read a ticket

ticket_get · Reads only · Markdown

One ticket with its request, every reply, customer message and note, its fields, SLA state and rating.

Free*

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

An example

Read me ticket 87 from start to finish.

Your agent callsticket_getFree*

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
{
  "number": 87
}
What comes back
{
  "ticket": {
    "number": 87,
    "subject": "Scratch on the Tabor's top tube",
    "status": "pending",
    "priority": "high",
    "category": "Damaged delivery",
    "tags": [
      "damage"
    ],
    "requester_email": "paul.hoffmann@example.com",
    "requester_name": "Paul Hoffmann",
    "contact_id": null,
    "company_id": null,
    "source": "api",
    "channel": "api",
    "assigned_to": null,
    "waiting_on": "customer",
    "sla": null,
    "merged_into": null,
    "created_at": "2026-10-14T08:00:00+00:00",
    "last_activity_at": "2026-10-14T08:00:00+00:00",
    "first_reply_at": "2026-10-14T08:00:00+00:00",
    "resolved_at": null,
    "body": "Called on Wednesday: the Tabor gravel bike delivered on Monday has a 3 cm scratch on the top tube. He would like it touched up or the frame swapped.",
    "fields": {
      "order_id": "2231"
    },
    "inbox": "support@halverson-cycle-repair.useconecto.com",
    "email_message_id": null,
    "rating": null,
    "rating_requested_at": null,
    "comments": [
      {
        "kind": "agent_reply",
        "body": "Hello Paul,\n\nwe are sorry about the scratch. We can pick the bike up on Tuesday, touch up the top tube in our workshop and bring it back on Thursday. A photo of the paint match is attached. Does that work for you?\n\nHalverson Support\n\nThis message was written by Halverson Cycle & Repair's AI assistant.",
        "email_status": "sent",
        "at": "2026-10-14T08:00:00+00:00",
        "email_message_id": "e7b53ff6-9cde-4376-ac6a-b16a2567f62c"
      }
    ]
  }
}

Use it when

Before answering a ticket, to read the whole exchange.

What it does

One ticket with its request, every reply, customer message and note (customer emails with their message id: email_get_message has attachments and the full text), tags, custom fields, SLA state and rating. Free.

What comes back

The ticket in full: what ticket_list shows, plus the request, custom fields, support inbox, the opening email's message_id, the rating, and every comment with its kind, body, email status and time. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
numberRequiredintegerThe ticket number, e.g. 42 for ticket #42. At least 1.

The call

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

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

When it refuses

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

CodeWhenWhat to do
not_found404No ticket of the business has that number.Find it with ticket_list and use its number.

More Help desk tools

All 13 tools

Give this to your agent.

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