Виджеты на сайт

Встраивайте AI-чат и форму обратной связи на любой сайт одной строкой кода. Все диалоги логируются и доступны в личном кабинете.

Типы виджетов

Widget Chat

Плавающая кнопка + панель чата. Пользователь отправляет сообщения, получает ответы от AI в реальном времени.

Widget Form

Форма сбора данных (имя, email, телефон, сообщение) — для лидогенерации без AI-ответа.

Создание виджета

Перейдите в Интеграции → Добавить

Выберите группу «Виджеты» и тип «Widget Chat».

Настройте внешний вид

Укажите позицию (bottom-right/left), цвет кнопки, текст триггера и приветственное сообщение.

Сохраните и скопируйте код

На странице деталей интеграции нажмите «Скопировать» в блоке «Код для вставки на сайт».

Код встраивания

HTML<!-- Вставьте перед </body> -->
<script
  src="https://your-domain.com/js/M-TEH-widget.js"
  data-key="nxs_abc123..."
  data-pipeline="5"
  data-pos="bottom-right"
  data-color="#8b5cf6"
  data-label="Помощник"
  data-welcome="Привет! Чем могу помочь?"
  data-api="https://your-domain.com"
></script>

Параметры виджета

Атрибут	Тип	Описание	По умолчанию
`data-key`	string	Обязательно. M-TEH Key вашей Widget-интеграции	—
`data-pipeline`	number	ID пайплайна. Если не указан — используется первый доступный AI	auto
`data-pos`	string	`bottom-right` или `bottom-left`	bottom-right
`data-color`	hex	Цвет кнопки и акцентов (#rrggbb)	#8b5cf6
`data-label`	string	Aria-label кнопки	Chat
`data-welcome`	string	Первое сообщение ассистента	Привет!…
`data-api`	url	Базовый URL M-TEH (если отличается от домена скрипта)	auto

Как работает передача сообщений

Виджет отправляет POST-запрос на /api/chat вашей инсталляции M-TEH:

POST /api/chat{
  "key":         "nxs_abc123...",   // API Key виджета
  "session":     "nx-a1b2c3...",   // уникальный ID сессии (sessionStorage)
  "message":     "Сколько стоит?",
  "pipeline_id": 5                  // опционально
}

Ответ:

Response{
  "reply":   "Наши тарифы начинаются от $9/мес...",
  "session": "nx-a1b2c3...",
  "tokens":  42
}

Сессии и история диалогов

Каждый пользователь получает уникальный session_id, который хранится в sessionStorage браузера. Все сообщения сохраняются в таблице dialog_log. История передаётся AI в контексте — до 20 последних пар сообщений, что даёт непрерывность разговора.

Просматривать диалоги можно в разделе Пайплайны → [Ваш пайплайн] → Диалоги. Там же доступно редактирование системного промта на основе реальных разговоров.