# Моночат

> Моночат (monochat.ru) — ИИ-сотрудник поддержки и продаж для SMB: отвечает в MAX, Telegram, VK и на сайте, учится на ваших диалогах. Омниканальный чат и CRM в одном окне. ИИ в квотах тарифа, без оплаты за каждое решение. Серверы в России, 152-ФЗ.

Тарифы — за проект (рабочее пространство), а не за оператора. Операторы и диалоги без лимита на всех тарифах.

- Старт — 0 ₽: все каналы, подпись «Создано в Моночат», 100 ИИ-подсказок в месяц, 30 пробных ИИ-автоответов.
- Бизнес — 1 990 ₽/мес (1 390 ₽/мес при оплате за год): без подписи, 3 000 ИИ-ответов в месяц с автоответом.
- Про — 4 990 ₽/мес (3 490 ₽/мес за год): 15 000 ИИ-ответов, помощь с настройкой ИИ.
- Команда — 9 990 ₽/мес (6 990 ₽/мес за год): 50 000 ИИ-ответов, до 5 проектов, персональный менеджер и SLA.
- Доп. пакет: +5 000 ИИ-ответов за 490 ₽ на текущий месяц.

WhatsApp, Avito и интеграций с amoCRM/Битрикс24 пока нет.

## Ключевые страницы

- [Тарифы](https://monochat.ru/pricing)
- [Возможности](https://monochat.ru/features)
- [ИИ-сотрудник](https://monochat.ru/ii)
- [ИИ-сотрудник — подробно](https://monochat.ru/ii/sotrudnik)
- [ИИ-администратор для салона](https://monochat.ru/dlya/salon-krasoty)
- [Мессенджер MAX для бизнеса](https://monochat.ru/max)
- [Сравнения с конкурентами](https://monochat.ru/vs/)
- [Альтернативы](https://monochat.ru/alternativa)
- [Статистика сервиса](https://monochat.ru/live)
- [О компании](https://monochat.ru/about)
- [Контакты](https://monochat.ru/contact)
- [Условия использования](https://monochat.ru/terms)

## Для разработчиков и ИИ-агентов

Установка — одна строка перед </body>: `<script src="https://monochat.ru/widget/WIDGET_KEY.js" async></script>`. Домен сайта привязан к виджету, localhost разрешён.

ИИ-агент может сам получить ключ: `POST https://monochat.ru/api/agent/v1/signup` с JSON `{"email": "<email владельца>", "site_domain": "<домен>"}` → widget_key, готовые сниппеты и agent_key. Владелец подтверждает email; ссылку на оплату тарифа (разовая, Robokassa, без автосписаний) даёт `POST /api/agent/v1/payment-link`.

- [Документация (каждая страница есть в .md)](https://monochat.ru/docs)
- [Промпт для Cursor/Lovable/Bolt/v0/Replit](https://monochat.ru/docs/ai-prompt.md)
- [Agent API: регистрация и оплата](https://monochat.ru/docs/agent-api.md)
- [React](https://monochat.ru/docs/react.md), [Next.js](https://monochat.ru/docs/nextjs.md), [Vue/Nuxt](https://monochat.ru/docs/vue.md), [HTML](https://monochat.ru/docs/html.md), [Tilda](https://monochat.ru/docs/tilda.md)
- [REST API и вебхуки](https://monochat.ru/docs/api.md)
- [MCP-сервер](https://monochat.ru/docs/mcp.md)
- [Для разработчиков](https://monochat.ru/developers)
- [Полная документация одним файлом](https://monochat.ru/llms-full.txt)

---

<!-- source: https://monochat.ru/docs -->
# Документация Моночата для разработчиков и ИИ-агентов

Моночат (monochat.ru) — ИИ-сотрудник поддержки и продаж для российского SMB: чат-виджет на сайте, Telegram, ВКонтакте, MAX и email в одном окне, ИИ-автоответы по базе знаний и обучение на диалогах пространства. Отдельной платы за решённый диалог нет — ИИ в квотах тарифа. Серверы в России, 152-ФЗ. Тариф «Старт» — 0 ₽.

Для агентов: сначала установите виджет (ниже), затем владелец включает ИИ-сотрудника в кабинете (база знаний + автоответ).

Каждая страница доступна как обычный Markdown: добавьте `.md` к адресу (например, `/docs/react.md`). Вся документация одним файлом — [/llms-full.txt](https://monochat.ru/llms-full.txt).

## Быстрый старт (1 строка)

```html
<script src="https://monochat.ru/widget/ВАШ_WIDGET_KEY.js" async></script>
```

Вставьте перед `</body>`. Ключ виджета — в кабинете «Каналы → Виджет» или через [Agent API](https://monochat.ru/docs/agent-api) без ручной регистрации.

## Страницы

- [Промпт для ИИ-агента (Cursor, Lovable, Bolt, v0, Replit)](https://monochat.ru/docs/ai-prompt)
- [Agent API: регистрация, ключ виджета и оплата из агента](https://monochat.ru/docs/agent-api)
- [Обычный HTML](https://monochat.ru/docs/html)
- [React (Vite, CRA)](https://monochat.ru/docs/react)
- [Next.js](https://monochat.ru/docs/nextjs)
- [Vue / Nuxt](https://monochat.ru/docs/vue)
- [Tilda](https://monochat.ru/docs/tilda)
- [npm-пакет monochat-widget](https://monochat.ru/docs/npm)
- [JavaScript API виджета (window.Monochat)](https://monochat.ru/docs/javascript-api)
- [REST API и вебхуки](https://monochat.ru/docs/api)
- [MCP-сервер](https://monochat.ru/docs/mcp)
- [Демо виджета без регистрации](https://monochat.ru/demo)

## Важно знать

- Виджет привязан к домену. `localhost` разрешён всегда — можно тестировать локально.
- Один скрипт, без зависимостей, ~асинхронная загрузка, не блокирует рендер.
- Тарифы за проект, а не за оператора: Старт 0 ₽, Бизнес 1 990 ₽/мес, Про 4 990 ₽/мес, Команда 9 990 ₽/мес.

---

<!-- source: https://monochat.ru/docs/ai-prompt -->
# Промпт для ИИ-агента: подключить чат Моночат

Скопируйте и вставьте в Cursor, Claude Code, Lovable, Bolt, v0, Replit, Windsurf или GigaCode.

```text
Подключи онлайн-чат поддержки Моночат (monochat.ru) к этому проекту.

1. Если у меня нет ключа виджета, получи его сам:
   POST https://monochat.ru/api/agent/v1/signup
   Content-Type: application/json
   {"email": "<мой email — спроси меня>", "site_domain": "<домен сайта>", "agent": "<название агента>"}
   Из ответа возьми widget_key, сохрани agent_key в .env как MONOCHAT_AGENT_KEY (не коммить).
   Покажи мне поле tell_the_human.
2. Вставь виджет одной строкой в общий layout, чтобы он был на всех страницах:
   <script src="https://monochat.ru/widget/<WIDGET_KEY>.js" async></script>
   - Next.js (app router): next/script в app/layout.tsx, strategy="afterInteractive".
   - React/Vite/Vue: в index.html перед </body>.
   - Nuxt: app.head.script в nuxt.config.
   Не добавляй скрипт дважды и не оборачивай в iframe.
3. Если сайт открывается на другом домене (превью Vercel/Netlify/Lovable), добавь его:
   POST https://monochat.ru/api/agent/v1/widget/domains  {"domain": "<домен>"}
   Authorization: Bearer $MONOCHAT_AGENT_KEY
4. Кнопку «Написать в поддержку» сделай через window.Monochat.open().
Документация: https://monochat.ru/llms-full.txt
```

Если ключ уже есть, достаточно пункта 2.

---

<!-- source: https://monochat.ru/docs/agent-api -->
# Agent API: регистрация и оплата из ИИ-агента

ИИ-агент может сам завести аккаунт для своего человека, сразу получить код виджета, а потом — ссылку на оплату, которую оплачивает человек. База: `https://monochat.ru/api/agent/v1`. JSON, CORS открыт.

## 1. Регистрация

```bash
curl -X POST https://monochat.ru/api/agent/v1/signup \
  -H "Content-Type: application/json" \
  -d '{"email":"owner@company.ru","site_domain":"company.ru","agent":"cursor"}'
```

Ответ `201`: `widget_key`, `install` (готовые сниппеты html/react/nextjs/vue/tilda/npm), `agent_key` (`mc_agent_…`, показывается один раз), `status: "pending_confirmation"`, `tell_the_human`.

Владельцу уходит письмо для подтверждения. Подтвердить можно и входом на monochat.ru/login через Google/Яндекс с тем же email.

До подтверждения: виджет работает сразу (тариф «Старт»), `agent_key` действует только на `/api/agent/v1/*`, не больше 3 доменов. После подтверждения `GET /status` один раз выдаёт полный REST-токен `mc_live_…`.

Ошибки: `400 invalid_email|invalid_domain`, `409 account_exists` (попросите человека войти и взять код в кабинете), `429 rate_limited`.
Защита от спама: лимиты по IP (3/час, 10/сутки), одноразовые email запрещены, один аккаунт на email.

## 2. Статус и полный API-токен

```bash
curl https://monochat.ru/api/agent/v1/status -H "Authorization: Bearer $MONOCHAT_AGENT_KEY"
```

`confirmed`, `plan`, `widget_key`, `allowed_domains`, `install`; после подтверждения — одноразово `api_token`.

## 3. Добавить домен (превью, стейджинг)

```bash
curl -X POST https://monochat.ru/api/agent/v1/widget/domains \
  -H "Authorization: Bearer $MONOCHAT_AGENT_KEY" -H "Content-Type: application/json" \
  -d '{"domain":"my-app.vercel.app"}'
```

## 4. Тарифы и ссылка на оплату

```bash
curl https://monochat.ru/api/agent/v1/plans
curl -X POST https://monochat.ru/api/agent/v1/payment-link \
  -H "Authorization: Bearer $MONOCHAT_AGENT_KEY" -H "Content-Type: application/json" \
  -d '{"plan":"business","period":"month"}'
```

`plan`: `business` (1 990 ₽/мес), `pro` (4 990 ₽/мес), `team` (9 990 ₽/мес); `period`: `month` или `year` (1 390 / 3 490 / 6 990 ₽/мес при оплате за год). Возвращает `payment_url` (Robokassa), который нужно отдать человеку. Платёж разовый, автосписаний нет. Тариф включается сразу после оплаты.

## 5. Повторное письмо

`POST /api/agent/v1/resend-confirmation` — до 3 раз в сутки.

---

<!-- source: https://monochat.ru/docs/html -->
# Установка виджета на обычный HTML-сайт

Вставьте одну строку перед закрывающим `</body>` на всех страницах:

```html
<script src="https://monochat.ru/widget/ВАШ_WIDGET_KEY.js" async></script>
```

- Ключ: кабинет → «Каналы» → «Виджет», или [Agent API](https://monochat.ru/docs/agent-api).
- Домен сайта должен быть указан в настройках виджета; `localhost` разрешён.
- Своя кнопка: `<button onclick="Monochat.open()">Написать нам</button>`.

---

<!-- source: https://monochat.ru/docs/react -->
# Виджет Моночата в React (Vite, Create React App)

Самый простой способ — `index.html` перед `</body>`:

```html
<script src="https://monochat.ru/widget/ВАШ_WIDGET_KEY.js" async></script>
```

Или компонентом (один раз в корне приложения):

```jsx
import { useEffect } from "react";

export function MonochatWidget({ widgetKey }) {
  useEffect(() => {
    const src = `https://monochat.ru/widget/${widgetKey}.js`;
    if (document.querySelector(`script[src="${src}"]`)) return;
    const s = document.createElement("script");
    s.src = src;
    s.async = true;
    document.body.appendChild(s);
  }, [widgetKey]);
  return null;
}

// App.jsx
<MonochatWidget widgetKey={import.meta.env.VITE_MONOCHAT_WIDGET_KEY} />
```

Или npm: `npm i monochat-widget` → `import { MonochatWidget } from "monochat-widget/react"`. См. [npm](https://monochat.ru/docs/npm).

Ключ виджета публичный, его можно держать в клиентском коде.

---

<!-- source: https://monochat.ru/docs/nextjs -->
# Виджет Моночата в Next.js

App Router — `app/layout.tsx`:

```tsx
import Script from "next/script";

export default function RootLayout({ children }: { children: React.ReactNode }) {
  return (
    <html lang="ru">
      <body>
        {children}
        <Script
          src={`https://monochat.ru/widget/${process.env.NEXT_PUBLIC_MONOCHAT_WIDGET_KEY}.js`}
          strategy="afterInteractive"
        />
      </body>
    </html>
  );
}
```

Pages Router — тот же `<Script>` в `pages/_app.tsx`.

`.env.local`: `NEXT_PUBLIC_MONOCHAT_WIDGET_KEY=ваш_ключ`. Для превью-доменов Vercel добавьте домен в настройках виджета или через `POST /api/agent/v1/widget/domains`. Виджет сам отслеживает SPA-переходы.

---

<!-- source: https://monochat.ru/docs/vue -->
# Виджет Моночата во Vue 3 и Nuxt

Vue (Vite) — `index.html` перед `</body>`:

```html
<script src="https://monochat.ru/widget/ВАШ_WIDGET_KEY.js" async></script>
```

Nuxt 3 — `nuxt.config.ts`:

```ts
export default defineNuxtConfig({
  app: {
    head: {
      script: [{ src: "https://monochat.ru/widget/ВАШ_WIDGET_KEY.js", async: true, tagPosition: "bodyClose" }],
    },
  },
});
```

Открыть чат из кода: `window.Monochat?.open()`.

---

<!-- source: https://monochat.ru/docs/tilda -->
# Чат Моночата на Tilda

1. В Моночате: «Каналы» → «Виджет» → укажите домен сайта на Tilda (например `mysite.tilda.ws` или свой домен) → скопируйте код.
2. В Tilda: «Настройки сайта» → «Ещё» → «HTML-код для вставки внутрь HEAD» → вставьте:

```html
<script src="https://monochat.ru/widget/ВАШ_WIDGET_KEY.js" async></script>
```

3. «Сохранить» и «Опубликовать все страницы».

Вариант на одну страницу — блок T123 («Другое → HTML-код»). Заявки с форм Tilda можно принимать в Моночат через [REST API](https://monochat.ru/docs/api) (`POST /api/public/v1/forms/lead`).

---

<!-- source: https://monochat.ru/docs/npm -->
# npm-пакет monochat-widget

```bash
npm i monochat-widget
```

```js
import { loadMonochat } from "monochat-widget";
loadMonochat("ВАШ_WIDGET_KEY"); // идемпотентно, безопасно для SSR (ничего не делает на сервере)
```

React:

```jsx
import { MonochatWidget } from "monochat-widget/react";
<MonochatWidget widgetKey="ВАШ_WIDGET_KEY" />
```

Пакет — тонкая обёртка над одной строкой `<script src="https://monochat.ru/widget/KEY.js">`, без зависимостей. Также экспортирует `openChat()`, `closeChat()`.

---

<!-- source: https://monochat.ru/docs/javascript-api -->
# JavaScript API виджета

После загрузки скрипта доступен `window.Monochat`:

| Метод | Что делает |
|---|---|
| `Monochat.open()` | открыть окно чата |
| `Monochat.close()` | закрыть |
| `Monochat.toggle()` | переключить |
| `Monochat.hide()` | спрятать кнопку виджета |
| `Monochat.show()` | показать снова |

```html
<button onclick="window.Monochat && Monochat.open()">Написать в поддержку</button>
```

Скрипт асинхронный, поэтому проверяйте наличие `window.Monochat` перед вызовом.

---

<!-- source: https://monochat.ru/docs/api -->
# REST API и вебхуки

Публичный REST API работает по токену проекта: `Authorization: Bearer mc_live_…`. Токен создаётся в кабинете «Интеграции» или выдаётся агенту через [Agent API](https://monochat.ru/docs/agent-api) после подтверждения email. База: `https://monochat.ru/api/public/v1`.

| Метод | Путь | Что делает |
|---|---|---|
| GET | `/me` | проект токена |
| GET | `/conversations` | список диалогов |
| GET | `/conversations/{id}` | диалог |
| GET | `/conversations/{id}/messages` | сообщения |
| POST | `/conversations/{id}/status` | сменить статус |
| GET | `/channels` | подключённые каналы (виджеты, email, Telegram, VK, MAX) |
| POST | `/forms/lead` | создать обращение из формы сайта: `{name, email, phone, message, source}` |

```bash
curl https://monochat.ru/api/public/v1/conversations -H "Authorization: Bearer $MONOCHAT_API_TOKEN"
```

Исходящие вебхуки (новый диалог, новое сообщение) настраиваются в кабинете: «Интеграции» → «Вебхук».

---

<!-- source: https://monochat.ru/docs/mcp -->
# MCP-сервер Моночата

MCP-сервер позволяет ИИ-агенту (Claude Code, Cursor, Windsurf) работать с Моночатом инструментами. Он работает поверх [Agent API](https://monochat.ru/docs/agent-api) и [REST API](https://monochat.ru/docs/api).

```json
{
  "mcpServers": {
    "monochat": {
      "command": "npx",
      "args": ["-y", "monochat-mcp"],
      "env": { "MONOCHAT_AGENT_KEY": "mc_agent_…", "MONOCHAT_API_TOKEN": "mc_live_…" }
    }
  }
}
```

## Инструменты

| Инструмент | Что делает | API |
|---|---|---|
| `create_workspace` | регистрирует аккаунт и проект по email и домену, возвращает виджет | `POST /api/agent/v1/signup` |
| `get_widget_code` | сниппеты установки для html/react/nextjs/vue/tilda | `GET /api/agent/v1/status` |
| `add_widget_domain` | разрешить ещё один домен | `POST /api/agent/v1/widget/domains` |
| `list_plans` | тарифы и цены | `GET /api/agent/v1/plans` |
| `get_payment_link` | разовая ссылка на оплату для человека | `POST /api/agent/v1/payment-link` |
| `list_conversations` | последние диалоги | `GET /api/public/v1/conversations` |
| `read_conversation` | сообщения диалога | `GET /api/public/v1/conversations/{id}/messages` |
| `create_lead` | обращение из формы | `POST /api/public/v1/forms/lead` |

Чтение диалогов требует `MONOCHAT_API_TOKEN` (выдаётся после подтверждения email).

---

<!-- source: https://monochat.ru/developers -->
# Моночат для разработчиков и вайб-кодинга

Добавьте чат поддержки с ИИ-автоответами в продукт, который вы делаете в Cursor, Lovable, Bolt, v0, Replit, Windsurf, Claude Code или GigaCode. Одна строка кода, тариф «Старт» 0 ₽, все сообщения из сайта, Telegram, VK, MAX и почты в одном окне.

## Вставьте этот промпт в своего ИИ-агента

```text
Подключи чат поддержки Моночат (monochat.ru) к проекту.
Инструкция для агентов: https://monochat.ru/docs/ai-prompt.md
Если нет ключа виджета, получи его через POST https://monochat.ru/api/agent/v1/signup
с {"email": "<спроси мой email>", "site_domain": "<домен сайта>"}.
Вставь <script src="https://monochat.ru/widget/<WIDGET_KEY>.js" async></script> в общий layout.
```

## Установка вручную

```html
<script src="https://monochat.ru/widget/ВАШ_WIDGET_KEY.js" async></script>
```

[HTML](https://monochat.ru/docs/html) · [React](https://monochat.ru/docs/react) · [Next.js](https://monochat.ru/docs/nextjs) · [Vue/Nuxt](https://monochat.ru/docs/vue) · [Tilda](https://monochat.ru/docs/tilda) · [npm](https://monochat.ru/docs/npm)

## Для агентов и интеграций

- [Agent API](https://monochat.ru/docs/agent-api): регистрация по email, ключ виджета сразу, ссылка на оплату для человека.
- [REST API и вебхуки](https://monochat.ru/docs/api)
- [MCP-сервер](https://monochat.ru/docs/mcp)
- [llms.txt](https://monochat.ru/llms.txt) и [llms-full.txt](https://monochat.ru/llms-full.txt)
- [Демо виджета без регистрации](https://monochat.ru/demo)

---

<!-- source: https://monochat.ru/demo -->
# Демо виджета Моночата без регистрации

Внизу справа на этой странице работает настоящий виджет Моночата — так он будет выглядеть на вашем сайте. Напишите сообщение: ответит команда Моночата (иногда ИИ-ассистент по базе знаний).

Чтобы поставить такой же на свой сайт:

```html
<script src="https://monochat.ru/widget/ВАШ_WIDGET_KEY.js" async></script>
```

Ключ можно получить за 1 запрос без ручной регистрации — [Agent API](https://monochat.ru/docs/agent-api), или войти через Google/Яндекс на [monochat.ru/login](https://monochat.ru/login).

---