Документация

Все про Чатву: от первого скрипта до API.

Начало работы Установка виджета Подключение каналов Настройка виджета Команда и отделы Уведомления Выгрузка данных REST API OpenAPI

Начало работы

Чатва собирает все диалоги с клиентами в один инбокс: виджет на сайте, мессенджеры и почта. Операторы отвечают из кабинета, а бот закрывает типовые вопросы.

Создайте компанию

Онбординг занимает две минуты: название, тариф, приглашение команды.

Подключите первый канал

Проще всего начать с виджета на сайте или Telegram-бота.

Поставьте виджет на сайт

Один скрипт перед закрывающим тегом body, и вы в эфире.

Открыть демо-кабинет

Установка виджета

Виджет ставится одним скриптом на все страницы перед закрывающим тегом body. Ключ в коде демонстрационный, свой вы найдете в кабинете на вкладке «Установка».

<script src="https://cdn.chatva.app/widget.js" data-project="ch_test_a91f3" defer></script>

Куда вставлять

Платформа	Куда вставлять
Tilda	Настройки сайта, Еще, HTML перед </body>
WordPress	Insert Headers and Footers, Scripts in Footer
1C-Битрикс	Настройки, Шаблоны, footer.php
InSales	Тема, Код, layouts/layout.liquid
Свой сайт	Общий шаблон или index.html

Параметры скрипта

Параметр	Описание
data-project	Ключ проекта из кабинета
data-accent	Акцентный цвет, hex
data-position	Позиция: right или left
data-greeting	Приветствие в шапке
data-lang	Язык интерфейса: ru или en
data-collect	Сбор контактов: name,phone,email

Подключение каналов

Диалоги приходят через вашего бота.

1
Откройте @BotFather и создайте бота командой /newbot.
2
Скопируйте токен вида 123456:ABC-DEF.
3
Вставьте токен в кабинете Чатвы: Каналы, Telegram.

MAX

Подключение по коду из приложения.

1
Откройте MAX и найдите официальный чат Чатвы.
2
Введите код из кабинета, он действует 10 минут.
3
Готово: диалоги появятся в общем инбоксе автоматически.

WhatsApp Business через официального провайдера.

1
Укажите номер WhatsApp Business.
2
Подтвердите номер кодом из SMS.
3
Сообщения клиентов начнут приходить в инбокс.

VK

Сообщения вашего сообщества ВКонтакте.

1
Нажмите «Подключить» и разрешите доступ во всплывающем окне VK.
2
Выберите сообщество, сообщения появятся в инбоксе.
3
Ответы операторов будут уходить от имени сообщества.

Авито

Сообщения с ваших объявлений.

1
Войдите в аккаунт Авито через OAuth.
2
Разрешите доступ к сообщениям.
3
Диалоги по вашим объявлениям появятся в инбоксе.

Почта

Письма поддержки превращаются в диалоги.

1
Настройте пересылку на адрес вида support@yourco.chatva.app.
2
Ответы клиентам уходят с вашего домена.
3
Письма превратятся в диалоги — отвечать можно прямо из инбокса.

Настройка виджета

Оформление

Цвет, позиция, углы, заголовок, приветствие и подпись «Работает на Чатве». Все меняется живьем в превью.

Автоответчик

Быстрые кнопки с собственными ответами, офлайн-сообщение и передача человеку: по словам-триггерам или сразу.

Сбор контактов

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

Галочки

Клиент видит, доставлено ли сообщение и прочитано ли оно менеджером.

Поведение

Автооткрытие через 10 секунд и ночной сбор контактов, когда все офлайн.

Команда и отделы

Роли

Владелец и администратор видят все диалоги и управляют настройками и тарифом. Оператор работает со своими диалогами и отделом.

Возможность	Владелец	Администратор	Оператор
Все диалоги компании	✓	✓	-
Назначение отделов	✓	✓	-
Настройки и каналы	✓	✓	-
Тариф и оплата	✓	✓	-

Отделы

Отделы распределяют диалоги: продажи берут заказы, поддержка решает вопросы. В инбоксе есть фильтр «Мой отдел».

Приглашения

Лимит зависит от тарифа: на «Старте» приглашения недоступны, «Команда» дает пять мест, «Бизнес» не ограничивает.

Уведомления

Каналы доставки

Пуш в браузере, Telegram-бот, MAX-бот и почта. Пуши приходят, даже если вкладка кабинета закрыта.

Правила

Новый диалог, диалог без ответственного пять минут, упоминание в заметке, утренний дайджест и тихие часы с 21:00 до 8:00.

Выгрузка данных

Выгрузка с выбором диалогов: CSV и Excel с одной строкой на сообщение, JSON с полной структурой диалогов.

Структура JSON

{
  "exportedAt": "2026-09-06T12:00:00Z",
  "dialogs": [
    {
      "id": "c1",
      "client": "Кира Мещерякова",
      "channel": "Telegram",
      "messages": [
        {"from": "client", "time": "11:58", "text": "Здравствуйте!"}
      ]
    }
  ]
}

REST API

API отдаёт диалоги, сообщения, контакты и события — всё, что нужно для интеграции со своими системами. Типовые сценарии:

Синхронизация с CRM

Забирайте диалоги и контакты в amoCRM, Bitrix24 или свою учётную систему по расписанию.

Автосообщения клиентам

Отправляйте сообщения в диалог из своей логики: статус заказа, напоминание о записи, ответ вашего бота.

Уведомления в реальном времени

Подпишитесь на вебхуки и получайте новые диалоги и сообщения в Slack, Telegram или трекер задач.

Резервные копии

Регулярно выгружайте переписку и храните у себя — данные принадлежат вам.

Базовый URL

Базовый URL
https://api.chatva.app/v1

Авторизация

Ключ создается в настройках на тарифе «Бизнес» и передается в заголовке.

Authorization: Bearer ch_live_9f3ka2

Методы

Метод	Путь	Описание
GET	/conversations	Список диалогов с фильтрами
GET	/conversations/{id}	Диалог со всеми сообщениями
POST	/messages	Отправить сообщение от оператора
GET	/contacts	Контакты клиентов
POST	/webhooks	Подписка на события диалогов

Пример запроса

curl https://api.chatva.app/v1/conversations?status=new \
  -H "Authorization: Bearer ch_live_9f3ka2"

События вебхуков

При подписке укажите URL — мы будем слать на него POST-запросы с JSON. Ответьте 200 в течение 5 секунд, иначе повторим до трёх раз.

Событие	Когда срабатывает
message:new	Новое сообщение в любом диалоге — от клиента, оператора или бота
conversation:new	Создан новый диалог в любом канале
conversation:update	Изменились статус, ответственный, отдел или оценка диалога

Пример payload

{
  "type": "message:new",
  "payload": {
    "conversation": {
      "id": "cv_018f3a",
      "channel": "telegram",
      "client": "Кира Мещерякова"
    },
    "message": {
      "id": "m_5521",
      "from": "client",
      "text": "Здравствуйте!",
      "createdAt": "2026-09-07T12:00:00Z"
    }
  }
}

Лимиты

120 запросов в минуту на ключ. При превышении ответ 429 и заголовок Retry-After.

Ошибки

{"error": {"code": "rate_limited", "message": "Retry after 30s"}}

OpenAPI

Полная спецификация OpenAPI 3.0. Импортируется в Postman, Insomnia и Swagger UI, по ней можно сгенерировать клиента под любой стек.

Скачать openapi.jsonopenapi: 3.0.3

120 запросов в минуту на ключ. При превышении ответ 429 и заголовок Retry-After.