Начало Telegram TG Bot WhatsApp WABA VK Instagram MAX Inbox Контакты Шаблоны Рассылки Автоответчики Каскады Flow-builder Webhooks CRM Команда
Геттинг Started

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

WonderChat — единый inbox для команды. Все сообщения из Telegram, WhatsApp, VK, Instagram и других каналов падают в одну панель.

Регистрация

1

Откройте панель

Перейдите на panel.wonderchat.ru и нажмите űЗарегистрироватьƇ.

2

Введите данные

Email, пароль, название компании. Эти данные нужны для входа.

3

Раздел űКаналыƇ

Добавьте первый канал — инструкции в соответствующем разделе.

4

Закройте панель

Можно прислать коллег — они получат доступ к своим диалогам.

Структура интерфейса

Левое меню содержит разделы: Inbox (все диалоги), Контакты, Шаблоны, Каналы, Вебхуки и Настройки.

Юарняя область — список диалогов с фильтрами. Правая — текущий чат.

✅

Интерфейс отображает онлайн состояние каналов и новые сообщения появляются в реальном времени через WebSocket.

TG
Канал

Telegram (личный аккаунт)

Подключает личный аккаунт Telegram через GramJS MTProto API. Юери пишут вам — вы видите и отвечаете из интерфейса WonderChat.

1. Получите API ID и API Hash

  1. Откройте my.telegram.org и войдите с номером телефона
  2. Перейдите в űAPI Development ToolsƇ
  3. Заполните форму: название приложения, URL (http://localhost) — полностью произвольно
  4. Нажмите űCreate applicationƇ — получите api_id (мультичисло) и api_hash (32 символа)
⚠️

Не делитесь api_hash — это критический секрет. Один api_id/api_hash в панели — один аккаунт Telegram.

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

  1. Раздел Каналы → űНовый каналƇ → тип Telegram
  2. Введите Название, API ID, API Hash, Юмер телефона
  3. Нажмите Подключить
  4. Появится модальное окно — введите код из SMS / Telegram
  5. Если защищён двухфакторной аутентификацией — введите пароль в следующем окне
  6. Канал переходит в статус online
ℹ️

Сессия сохраняется в зашифрованном виде. Повторное подключение не требует кода.

🤖
Канал

Telegram Bot

Подключает бот через официальный Telegram Bot API. Соаобщения получаются по Webhook в реальном времени.

Получение токена

  1. Напишите @BotFather в Telegram
  2. Отправьте /newbot — введите название и усернейм
  3. Скопируйте токен вида 1234567890:AAFxxxxx...

Подключение

  1. Раздел Каналы → Новый → тип Telegram Bot
  2. Вставьте токен в поле Bot Token
  3. Нажмите Подключить — Webhook прописывается автоматически.
Канал

WhatsApp

Подключение личного аккаунта WhatsApp через QR-код (библиотека Baileys). Экзампляр телефона должен быть доступен через WhatsApp.

Подключение

  1. Раздел Каналы → Новый → тип WhatsApp
  2. Нажмите Получить QR — появится QR-код
  3. Откройте WhatsApp → ☰ → Связанные устройства → Привязать устройство
  4. Наведите камеру на QR-код в панели
  5. Канал переходит в статус online
⚠️

Экзампляр WhatsApp должен быть полностью заряжен и подключён к интернету. Одновременно использовать WhatsApp на другом устройстве нельзя.

WB
Канал

WhatsApp Business API (WABA)

Официальный Meta Cloud API. Требует наличия верифицированного бизнес-аккаунта.

Получение креденциалов

  1. Откройте Meta for Developers
  2. Создайте приложение → добавьте продукт WhatsApp
  3. Скопируйте Phone Number ID и временный Access Token
  4. Для продакшного: создайте System User → создайте постоянный токен с правами whatsapp_business_messaging

Подключение

  1. Раздел Каналы → Новый → тип WhatsApp Business API
  2. Введите Phone Number ID и Access Token
  3. В настройках Meta Webhook укажите URL: https://panel.wonderchat.ru/api/v1/hooks/waba
  4. Верифицируйте Webhook в кабинете Meta
VK
Канал

ВКонтакте

Сообщения сообщества ВКонтакте через Callback API. Group ID определяется автоматически по токену, а настройка вебхука делается через мастер в WonderChat.

1. Получите ключ доступа

  1. Откройте страницу сообщества → «Управление → Работа с API»
  2. Создайте ключ доступа (тип: ключ сообщества, разрешения: сообщения)
  3. Скопируйте токен

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

  1. Раздел Каналы → Новый → тип ВКонтакте
  2. Введите Ключ доступа (Group ID определится автоматически)
  3. Нажмите Подключить — откроется мастер с URL вебхука и полями для кода подтверждения/секретного ключа

3. Настройка Callback API в ВК

  1. В управлении сообщества → «Работа с API» → Callback API → «Добавить сервер»
  2. Вставьте URL из мастера WonderChat:
URL вебхука VK
https://panel.wonderchat.ru/api/v1/hooks/vk/<channelId>
  1. VK отправит проверочный запрос {"type":"confirmation","group_id":...} и покажет строку подтверждения
  2. Введите эту строку в WonderChat: ⚙️ настройки канала → VK Callback API → Код подтверждения → Сохранить
  3. Нажмите «Подтвердить» в VK повторно
  4. Включите событие Сообщение из диалога
  5. Опционально: в Callback API задайте Секретный ключ для верификации запросов
✅

WonderChat автоматически определяет Group ID по токену. Вводить Group ID вручную не нужно.

Обновление настроек

Если нужно изменить ключ доступа, код подтверждения или секретный ключ — откройте ⚙️ настройки канала в списке Каналы. В блоке VK Callback API можно обновить данные в любой момент; адаптер перезапускается автоматически после сохранения.

IG
Канал

Instagram

Прямые сообщения Instagram Direct через Meta Graph API.

Требования

  • Профессиональный аккаунт Instagram
  • Привязка к Facebook Странице
  • Приложение Meta с правом instagram_manage_messages

Настройка

  1. Из Meta for Developers скопируйте Page Access Token и Instagram Account ID
  2. В настройках Webhooks укажите URL: https://panel.wonderchat.ru/api/v1/hooks/instagram
  3. Подпишитесь на событие messages и messaging_postbacks

Подключение

  1. Раздел Каналы → Новый → тип Instagram
  2. Введите Page Access Token и Account ID
  3. Нажмите Подключить
MX
Канал

MAX

Новый мессенджер от VK с каналом для бизнеса. Подключается аналогично Telegram Bot.

Получение токена

  1. Откройте max.ru → раздел От Ботов
  2. Создайте бот → скопируйте аксесс-токен

Подключение

  1. Раздел Каналы → Новый → тип MAX
  2. Введите токен
  3. Нажмите Подключить
MX👤
Канал

MAX (личный аккаунт)

Подключает личный аккаунт MAX через QR-код — аналогично WhatsApp. Позволяет общаться от имени личного профиля MAX.

Подключение

  1. Раздел Каналы → Новый → тип MAX (личный)
  2. Нажмите Подключить (QR) — появится QR-код
  3. Откройте MAX → Настройки → Связанные устройства → Привязать устройство
  4. Наведите камеру на QR-код в панели
  5. Канал переходит в статус online
⚠️

Экземпляр MAX должен быть полностью заряжен и подключён к интернету. Одновременно использовать MAX на другом устройстве нельзя.

Работа

Inbox / Диалоги

Основная рабочая область. Здесь собираются все входящие сообщения со всех каналов.

Фильтры

  • Канал — показать диалоги одного канала
  • Статус — открытые / закрытые
  • Непрочитанные — только с непрочитанными сообщениями
  • Поиск — по названию контакта, номеру телефона, тексту сообщения

Отправка сообщений

  • Юекст — обычное текстовое сообщение
  • Медиа — фото, видео, документ. Drag & drop или кнопка ű📎Ƈ
  • Шаблоны — начните вводить / — появится список шаблонов
  • Emoji — Юокнуть кнопку ű😊Ƈ — 400+ эмоджи
  • Цитирование — наведите на сообщение и нажмите űОтветитьƇ

Статусы диалога

  • open — активный, требует ответа
  • closed — закрыт, архивирован
Работа

Контакты

Единая база клиентов. Контакт автоматически создаётся при первом обращении.

Поля контакта

ПолеОписание
nameИмя и фамилия
phoneЮелефон в романском формате
emailEmail адрес
tagsЮеги для фильтрации
notesЗаметки
externalIdID во внешней системе (CRM)

Управление тегами

Кликните на контакт в таблице — откроется карточка с деталями. В разделе тегов можно:

  • Добавить тег — начните печатать название и выберите из автоподсказок (или создайте новый)
  • Удалить тег — нажмите «×» рядом с тегом

Теги используются для фильтрации контактов и выбора получателей рассылок.

Объединение дублей

Если один клиент нашёл вас из нескольких мессенджеров, можно объединить разные записи в одну через Контакты → Объединить или через API POST /api/v1/contacts/merge.

Работа

Шаблоны (Быстрые ответы)

Шаблоны позволяют быстро отвечать на часто задаваемые вопросы.

Создание

  1. Раздел Шаблоны → űНовый шаблонƇ
  2. Введите название (используется в поиске) и текст
  3. Сохранить

Синтаксис

  • {{name}} — имя контакта
  • {{phone}} — телефон контакта
  • Любая другая плейсхолдер-замена

Использование

В поле ввода сообщения начните печатать / — появится выпадающий список шаблонов. Также можно нажать кнопку ⚡ рядом с полем ввода. Переменные подставляются автоматически.

Автоматизация

Рассылки

Массовая отправка сообщений контактам через выбранный канал. Рассылки поддерживают текст, медиа-вложения, выбор аудитории и автоматическое присвоение тегов.

Создание рассылки

1

Название и канал

Раздел Рассылки → «Новая рассылка». Укажите название и выберите канал отправки.

2

Сообщение

Введите текст (до 4096 символов). Можно прикрепить изображение, видео или документ.

3

Получатели

Выберите режим: Все контакты, По тегам (один или несколько) или Список контактов.

4

Настройки

Throttle — задержка между отправками (200 мс – 60 сек). Тег при отправке — автоматически присваивает тег каждому контакту.

Управление

  • Отправить — запускает рассылку (асинхронно)
  • Отменить — останавливает текущую отправку
  • Статистика — в реальном времени: всего / отправлено / доставлено / ошибки
ℹ️

Рассылку можно редактировать и удалять только в статусе draft. После отправки доступна только отмена и просмотр статистики.

Автоматизация

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

Правила автоматической обработки входящих сообщений. При совпадении триггера выполняются заданные действия.

Триггеры

ТипОписание
keywordТочное совпадение слова
containsТекст содержит подстроку
regexСовпадение по регулярному выражению
anyЛюбое входящее сообщение

Действия

ТипОписание
replyАвтоматический ответ текстом
assignНазначить диалог на оператора
tagПрисвоить тег контакту
closeЗакрыть диалог

Порядок срабатывания

Если входящее сообщение подходит под несколько правил, сработает только одно — с наибольшим числом приоритета. Например: правило с приоритетом 10 сработает раньше, чем с 5.

ℹ️

Опция «Один раз на контакт» — правило сработает для каждого контакта не более одного раза (удобно для приветственных сообщений). Можно ограничить правило конкретным каналом.

Автоматизация

Каскады

Мультиканальная доставка с автоматическим переключением. Если сообщение не доставлено через первый канал в течение таймаута — отправка идёт через следующий.

Настройка

1

Создайте каскад

Раздел Каскады → «Новый каскад». Укажите название.

2

Добавьте шаги

Минимум 2 шага. Каждый шаг: канал + таймаут (5 сек – 24 часа).

3

Отправьте

Укажите контакт и сообщение — каскад начнёт доставку по цепочке.

Логика доставки

  • Шаг 1: отправка через первый канал
  • Если не доставлено за таймаут → переход на шаг 2
  • На каждом шаге ожидается статус delivered
  • При доставке на любом шаге — каскад завершается успешно
Автоматизация

Flow-builder

Визуальный конструктор сценариев. Перетаскивайте блоки на canvas, соединяйте их — и постройте автоматический сценарий обработки.

Типы блоков

БлокОписание
ТриггерТочка входа: новое сообщение, ключевое слово
УсловиеВетвление по тегу, каналу или содержимому
ДействиеОтправить ответ, присвоить тег, назначить оператора, закрыть
ЗадержкаПауза перед следующим блоком

Работа с canvas

  • Перетащите блок из панели на canvas
  • Нажмите Режим соединения — кликните на блок-источник, затем на блок-цель
  • Двойной клик по блоку — редактирование параметров
  • Включите flow тумблером — он начнёт обработку входящих сообщений
⚠️

Flow-builder сохраняет граф (блоки + связи), но визуальное исполнение пока на стороне интерфейса. Runtime-движок находится в разработке.

Коннекторы

Вебхуки

WonderChat отправляет HTTP POST-запросы на ваш URL при новых событиях.

Создание

  1. Раздел Вебхуки → űНовый вебхукƇ
  2. Укажите URL вашего сервера
  3. Выберите типысобытий
  4. Нажмите űТестƇ для проверки

Пайлоад

Пример — новое входящее сообщение
{ "event": "new_message", "data": { "id": "msg_abc123", "conversationId": "conv_xyz", "channel": "telegram", "from": { "id": "123456", "name": "Иван" }, "type": "text", "text": "Здравствуйте!", "createdAt": "2026-04-11T10:00:00Z" } }

Типы событий

СобытиеКогда
new_messageНовое входящее сообщение
message_statusИзменение статуса сообщения (sent/delivered/read)
channel_statusКанал подключился / отключился
contact_createdСоздан новый контакт
ℹ️

WonderChat ожидает HTTP 200 в течение 5 секунд. При ошибке — 3 повторных попытки с exponential backoff.

Управление

Команда

Добавьте коллег — они мгновенно получат доступ к диалогам.

Добавление пользователя

  1. Настройки → űПользователиƇ → űПригласитьƇ
  2. Введите email нового работника
  3. Пользователь получает письмо и входит в ЛИЧНЫЙ аккаунт

API: создание пользователя

POST /api/v1/account/users
{ "email": "ivan@company.ru", "name": "Иван Петров", "password": "Secret123!" }

Роли

РольВозможности
adminПолный доступ: каналы, пользователи, рассылки, настройки
operatorДиалоги, контакты, шаблоны
Интеграции

CRM-интеграции

WonderChat поддерживает интеграции с amoCRM, Bitrix24, YCLIENTS и comka.ru (SotkaCRM). Контакты и диалоги синхронизируются при входящих сообщениях; для YCLIENTS доступны маркетплейс-подключение и уведомления по записям.

amoCRM

1

Подключение

Раздел Интеграции → amoCRM → введите домен (company.amocrm.ru), Client ID, Client Secret, Authorization Code.

2

Автосинхронизация

При новом сообщении — контакт создаётся/обновляется в amoCRM. Сделка создаётся в первом pipeline.

3

Поля контакта

Телефон, email, имя — заполняются автоматически из данных контакта.

ℹ️

Токены amoCRM обновляются автоматически через refresh token. Учётные данные хранятся в зашифрованном виде.

Bitrix24

1

Webhook или OAuth

Введите URL входящего вебхука Bitrix24 (https://company.bitrix24.ru/rest/1/xxx/) или OAuth-креденшиалы.

2

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

Контакты создаются через crm.contact.add, сделки через crm.deal.add с привязкой к контакту.

3

Дубли

Поиск по телефону — если контакт существует, новый не создаётся.

YCLIENTS

1

Подключение (Marketplace)

Подключение выполняется через YCLIENTS Marketplace: установка приложения автоматически создаёт интеграцию и активирует callback_with_settings.

2

Уведомления и fallback

Входящие сообщения отправляются в YCLIENTS. Если публичный endpoint new_message недоступен (404), WonderChat обновляет поле comment в карточке клиента.

3

Мульти-филиал

Роутинг идёт по contact.crmData.yclientsMap → integrationId → fallback на все активные интеграции. В шаблонах используйте {филиал}.

⚠️

Публичный endpoint YCLIENTS POST /marketplace/application/new_message возвращает 404, поэтому в качестве fallback обновляется комментарий клиента. Отдельный native popup/push в интерфейсе YCLIENTS этим методом не создаётся.

API: управление CRM-интеграциями

POST /api/v1/crm
{ "type": "amocrm", // amocrm | bitrix24 | yclients | comkacrm "credentials": { "domain": "company.amocrm.ru", "clientId": "xxx", "clientSecret": "yyy", "authCode": "zzz" } }

Подробнее см. в API Reference → CRM.