Turn a chat into a ticket

chat_create_ticket · Changes data · Markdown

Opens a help desk ticket from a chat that needs follow-up by email, with the chat so far as the request.

$0.01 a call

From your agent’s balance. A call that fails costs nothing.

Lisa wants to know whether the Tabor ships to Seattle. Make that a ticket so the team writes back to her by email.

Your agent callschat_create_ticket$0.01 a call

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,
  "subject": "Tabor shipping to Seattle"
}

What comes back

{
  "ticket": {
    "number": 1,
    "subject": "Tabor shipping to Seattle",
    "status": "open",
    "priority": "normal",
    "category": null,
    "tags": [],
    "requester_email": "lisa.moreno@example.com",
    "requester_name": "Lisa Moreno",
    "contact_id": null,
    "company_id": null,
    "source": "api",
    "channel": "api",
    "assigned_to": null,
    "waiting_on": "us",
    "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": null,
    "resolved_at": null
  },
  "created": true
}

Use it when

A visitor's question can't be answered in the chat now: it needs checking, a person or days.

For a ticket that does not start in a chat, use ticket_create.

What it does

Open a help desk ticket from a chat that needs follow-up: the chat so far becomes the request, the visitor its requester (their email from the chat, or email), linked to the chat and their CRM contact, so the rest goes by email under the help desk's targets. A chat that already has an open ticket returns that one. $0.01.

What comes back

ticket: the ticket with its number, subject, status, requester and the chat as its first message; created: false when the chat already had an open ticket, which comes back instead. Every reply also carries cost_usd and balance_usd.

Inputs

Name	Type	What it is
`conversation_id`Required	integer	At least 1.
`email`	string	When the visitor gave none in the chat. Up to 254 characters.
`subject`	string	Up to 200 characters.
`priority`	string	One of: low,normal,high,urgent. Default: normal.
`category`	string	Up to 80 characters.

The call

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

Terminal

curl -X POST https://api.conecto.chat/v1/tools/chat_create_ticket \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"conversation_id":3187,"subject":"Tabor shipping to Seattle"}'

When it refuses

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

Code	When	What to do
`not_found`404	No chat conversation of the business has that conversation_id.	Find it with chat_list_conversations and use its conversation_id.
`no_email`409	The visitor gave no email in the chat.	Ask for it in the chat, then pass email.
`invalid_input`400	email is not an email address.	Pass the address the visitor typed.

More Website chat tools

All 9 tools

Give this to your agent.

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

Turn a chat into a ticket

An example

Use it when

What it does

What comes back

Inputs

The call

When it refuses

More Website chat tools

Give this to your agent.