1. Виджет — поле ввода информации на сайте¶
Клиент открывает виджет на сайте и сразу попадает в диалог с AI. Никаких форм "оставьте заявку". Живой чат в реальном времени.
Что внутри виджета¶
- Текстовое поле для свободного ввода
- Загрузка файлов и фото (серийный номер, скриншот ошибки). Хранение в MinIO
- Индикатор "AI обдумывает..." (задержка 5–10 сек для буферизации быстрых сообщений, как в текущих ботах)
- История диалогов — клиент может вернуться к предыдущему разговору
- Кнопки категорий и обратной связи (подробнее в разделе 11)
- Подсказки статей из KB пока клиент набирает текст — если есть подходящая статья, она показывается до начала диалога с AI. Клиент может решить проблему сам, без LLM-вызова
Каналы входа¶
| Канал | Реализация | Буферизация |
|---|---|---|
| Виджет на сайте | Preact, WebSocket, встраиваемый JS-скрипт | 5 сек |
| Telegram-бот | Telegram Bot API, отдельный микросервис | 10 сек |
Один AI, единая логика, разные точки входа.
Идентификация клиента¶
| Канал | Как определяем | Что знаем |
|---|---|---|
| Виджет | cookie / токен авторизации | B2B или B2C, компания, устройства, адрес |
| Telegram | telegram_id → связка с контактом | То же через привязку |
| Новый клиент | AI спрашивает телефон или email | Создаёт контакт |
Единая таблица contacts (phone, email, telegram_id, whatsapp_id) — один клиент через все каналы. Дубли объединяются (поле merged_into).