Website chat
Close or reopen a chat
Closes a conversation once it is handled, or opens it again.
$0.001 a call
From your agent’s balance. A call that fails costs nothing.
An example
The question about shipping times is answered. Close that chat.
Your agent callschat_close$0.001 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,
"status": "closed"
}What comes back
Use it when
A conversation is handled, or a closed one needs more work.
What it does
Close a conversation once it is handled, or reopen it.
What comes back
The conversation with its new status. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
conversation_idRequired | integer | At least 1. |
statusRequired | string | One of: closed,open. |
The call
Over MCP, call chat_close on https://api.conecto.chat/mcp/chat. Over REST:
Terminal
curl -X POST https://api.conecto.chat/v1/tools/chat_close \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"conversation_id":3187,"status":"closed"}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
not_found404 | No chat conversation of the business has that conversation_id. | Find it with chat_list_conversations and use its conversation_id. |
conversation_open409 | The visitor already has another open conversation, so this one cannot reopen. | Continue in the open conversation; the message gives its id. |
More Website chat tools
All 9 tools- Set up the website chat
chat_setupCreates or changes the business's website chat widget and who answers it, and returns the snippet for the website.$0.001 a call - Get the website chat setup
chat_get_setupThe website chat's settings, its embed snippet, how messages reach the agent and this month's cost.Free* - Wait for visitor messages
chat_waitWaits for the next visitor message, for an agent without a server to receive webhooks.Free* - List chat conversations
chat_list_conversationsThe website chat and email conversations, newest activity first, with who it is and the last message.Free* - Get a chat conversation
chat_get_conversationOne conversation with all its messages, from the visitor and from the business.Free* - Show that you are typing
chat_typingShows the visitor that the business is typing, for about 8 seconds.Free - Reply in a chat
chat_replyAnswers a website visitor as the business, with product cards, images or buttons if you like.Free - Turn a chat into a ticket
chat_create_ticketOpens 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
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md