---
name: "chat_get_setup"
area: "chat"
title: "Get the website chat setup"
price: "free"
method: "POST"
url: "https://api.conecto.chat/v1/tools/chat_get_setup"
mcp_server: "https://api.conecto.chat/mcp/chat"
auth: "Authorization: Bearer <conecto_sk_ key>"
docs_url: "https://conecto.chat/tools/chat/chat_get_setup"
---

# Get the website chat setup (`chat_get_setup`)

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

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

Price: Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads. A call that fails costs nothing.

## Use it when

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

## Say this to your agent

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

## Inputs

This tool takes no arguments: send `{}`.

## Example

Written for Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon.

MCP: call `chat_get_setup` on the MCP server `https://api.conecto.chat/mcp/chat` with these arguments:

```json
{}
```

REST:

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

## Response

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "chat_get_setup",
  "status": "succeeded",
  "replayed": false,
  "cost_usd": "$0.00",
  "balance_usd": "$19.75",
  "result": {
    "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
      }
    }
  }
}
```

`result`: The widget's settings, embed_html, how messages reach the agent, whether it is listening, and this month's conversations, charges and unpaid ones.

## Errors

| Code | Status | When | Fix |
|---|---|---|---|
| `not_set_up` | 404 | The business has no website chat yet. | Create it with chat_setup. |

The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md

## Related

- [chat_setup](https://conecto.chat/tools/chat/chat_setup.md): Creates or changes the business's website chat widget and who answers it, and returns the snippet for the website. $0.001 a call.
- [chat_wait](https://conecto.chat/tools/chat/chat_wait.md): Waits for the next visitor message, for an agent without a server to receive webhooks. Free up to 1,000,000 reads a month.
- [chat_list_conversations](https://conecto.chat/tools/chat/chat_list_conversations.md): The website chat and email conversations, newest activity first, with who it is and the last message. Free up to 1,000,000 reads a month.
- [chat_get_conversation](https://conecto.chat/tools/chat/chat_get_conversation.md): One conversation with all its messages, from the visitor and from the business. Free up to 1,000,000 reads a month.
- [chat_typing](https://conecto.chat/tools/chat/chat_typing.md): Shows the visitor that the business is typing, for about 8 seconds. Free.
- [chat_reply](https://conecto.chat/tools/chat/chat_reply.md): Answers a website visitor as the business, with product cards, images or buttons if you like. Free.
- [chat_create_ticket](https://conecto.chat/tools/chat/chat_create_ticket.md): 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.
- [chat_close](https://conecto.chat/tools/chat/chat_close.md): Closes a conversation once it is handled, or opens it again. $0.001 a call.