Website chat

Get the website chat setup

chat_get_setup · Reads only · Markdown

The website chat's settings, its embed snippet, how messages reach the agent and this month's cost.

Free*

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

An example

Send me the website chat code again. The web designer needs it.

Your agent callschat_get_setupFree*

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
{}
What comes back
{
  "chat": {
    "widget_id": 4101,
    "name": "Halverson Cycle & Repair",
    "website": "https://halversoncycle.example",
    "greeting": "Questions about a bike or a repair? Ask us.",
    "agent_name": "Halverson Support",
    "color": "#1f4d3a",
    "language": "en",
    "experience": "chat",
    "starter_questions": [],
    "embed_html": "<script src=\"https://api.conecto.chat/widget.js\" data-widget=\"3Kg1p6E_mLEeauWnY73DTqqoUAK_W_Zb\" async></script>",
    "install": "Put embed_html just before </body> on every page of the website.",
    "answer_with": "bot",
    "answering": "You answer. Every visitor message arrives as a chat.message_received event: subscribe a webhook to it (notify_add_channel, then notify_subscribe with events [\"chat.*\"]) to get it on your server at once, or call chat_wait in a loop. Reply with chat_reply; chat_typing shows \"typing\" while you work. Conecto runs no AI of its own in the chat.",
    "listening": false,
    "pricing": {
      "model": "per conversation",
      "price_usd": "$0.05",
      "conversations_this_month": 0,
      "charged_this_month_usd": "$0.00",
      "unpaid": 0
    }
  }
}

Use it when

To get the embed snippet again, or check the widget's settings and this month's conversations.

What it does

The website chat widget's settings, its embed snippet, how messages reach you and this month's cost.

What comes back

The widget's settings, embed_html, how messages reach the agent, whether it is listening, and this month's conversations, charges and unpaid ones. Every reply also carries cost_usd and balance_usd.

The call

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

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

When it refuses

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

CodeWhenWhat to do
not_set_up404The business has no website chat yet.Create it with chat_setup.

Give this to your agent.

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