Интеграции — Web-чат и внешние системы¶

Schemix работает не только с мессенджерами напрямую, но и как движок процессов для внешних систем: CRM, helpdesk, сайтов, мобильных приложений.

Web-чат: подключение чата с вашего сайта¶

Web-чат — это канал для интеграции чата на вашем сайте или в приложении с процессами Schemix. Schemix не предоставляет готовый виджет — вы используете свой интерфейс чата, а Schemix обрабатывает диалог через AI Chat, маршрутизацию и задачи операторов.

Как это работает¶

Клиент на сайте → Ваш backend → POST /channels/webchat/{id}/inbound → Schemix
                                                                        ↓
                                                                   AI Chat / User Task
                                                                        ↓
Клиент на сайте ← Ваш backend ← POST webhook_url ← Schemix (ответ)

Настройка¶

Администрирование → Каналы — добавьте канал типа «Web-чат».
Укажите Webhook URL — адрес вашего сервера, куда Schemix будет отправлять ответы (исходящие сообщения).
Опционально: укажите Webhook Secret для HMAC-SHA256 подписи исходящих запросов (заголовок X-Schemix-Signature).

Приём сообщений (inbound)¶

Ваша система отправляет сообщения клиента в Schemix:

POST https://api.schemix.ru/channels/webchat/{config_id}/inbound
X-API-Key: ваш_api_ключ
Content-Type: application/json

{
  "chat_id": "session_abc123",
  "text": "Здравствуйте, у меня вопрос",
  "user_id": "user_456",
  "username": "Иван Петров"
}

Поле	Обязательное	Описание
`chat_id`	Да	Идентификатор сессии чата (уникальный для клиента)
`text`	Да	Текст сообщения
`user_id`	Нет	Идентификатор клиента в вашей системе
`username`	Нет	Имя клиента

Аутентификация: заголовок X-API-Key с API-ключом, у которого есть разрешение conversation.send. Ключ создаётся в разделе Администрирование → API-ключи.

Отправка ответов (outbound)¶

Когда Schemix отвечает клиенту (через AI Chat или оператора), он отправляет HTTP POST на ваш Webhook URL:

{
  "chat_id": "session_abc123",
  "text": "Здравствуйте! Чем могу помочь?",
  "reply_to_message_id": null,
  "timestamp": "2026-04-20T12:00:00Z"
}

Если настроен Webhook Secret, запрос содержит заголовок X-Schemix-Signature: sha256=... — HMAC-SHA256 подпись тела запроса. Проверяйте подпись на своей стороне для защиты от подмены.

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

В Start Event выберите триггер Web-чат и конкретную конфигурацию. Системные переменные: message_text, external_username, external_user_id, channel (всегда webchat).

Интеграция со сторонней CRM (Headless User Task)¶

В разработке

Эта функциональность находится в разработке и будет доступна в ближайших обновлениях.

Сценарий: оператор работает в своей CRM (не в Schemix), а Schemix выступает как движок бизнес-процесса. Когда процесс доходит до User Task, Schemix отправляет задачу в CRM, а оператор возвращает результат через callback.

Как это будет работать¶

Процесс доходит до User Task.
Schemix отправляет webhook в CRM: данные задачи, поля формы, кнопки.
Оператор видит задачу в своей CRM, общается с клиентом через свой чат.
Оператор нажимает кнопку / заполняет форму → CRM отправляет результат обратно в Schemix.
Процесс продолжается.

Типичный кейс¶

CRM с подключённым Wazzup → оператор общается с клиентом через WhatsApp в интерфейсе CRM → Schemix управляет маршрутизацией, SLA, эскалацией и бизнес-логикой → результат обработки возвращается в Schemix для продвижения процесса.

Это позволяет использовать Schemix как «невидимый» BPM-движок: пользователи работают в привычном интерфейсе CRM, а Schemix управляет процессом за кулисами.

Запуск процесса из внешней системы (API / Webhook)¶

Любая внешняя система может запустить процесс в Schemix через API.

Через JSON-RPC¶

POST https://api.schemix.ru/rpc
X-API-Key: ваш_api_ключ
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "method": "process.start",
  "params": {
    "process_id": "A",
    "variables": {
      "order_id": 456,
      "amount": 1000,
      "customer": "Иван"
    }
  },
  "id": 1
}

Подробнее: JSON-RPC API.

Через Webhook¶

Если в Start Event выбран тип «Webhook», процесс получает уникальный URL. Внешняя система вызывает его напрямую — без API-ключа, по секретному URL.

Подробнее: Webhooks.

Когда что использовать¶

Сценарий	Способ
CRM отправляет заявку в обработку	JSON-RPC `process.start`
Платёжная система уведомляет об оплате	Webhook
Сайт отправляет форму обратной связи	JSON-RPC или Webhook
Чат на сайте	Web-чат канал (см. выше)
Мессенджер напрямую	Telegram / Wazzup / MAX в Start Event