Контроль AI та передача людині

Кожен чат має перемикач контролю AI, тож команда вашого клієнта може дати асистенту працювати на автопілоті або втрутитися вручну будь-коли.

На скриншоті показано розмову одразу після того, як AI викликав turnOffAiMode: перемикач AI у заголовку чату вимкнено, банер нагадує оператору, що він відповідає вручну, а останнє повідомлення надходить від колеги.

Перемикання режиму AI

1. Відкрийте будь-який чат у Чатах (панель або мобільний додаток) і натисніть перемикач AI — він перемикається миттєво.
2. Або через API: PATCH /api/chats/{chatId} з { "isUnderAiControl": false } (заголовок X-Access-Token: happ_your_token_here).

Коли AI вимкнено, aiDisableReason фіксує причину:

Передача людині

Вбудований інструмент turnOffAiMode завжди доступний. Коли AI вирішує, що не може допомогти, він викликає інструмент, isUnderAiControl встановлюється в false, чат з'являється на панелі як такий, що потребує уваги, а WebSocket-подія CHAT_MODE_CHANGED сповіщає всіх клієнтів. Налаштуйте Telegram Push-сповіщення, щоб група команди отримувала пінг на кожну передачу.

Скеруйте його з промпта асистента:

If the customer asks to speak to a human, or if you cannot resolve
their issue after 2 attempts, use the turnOffAiMode tool to transfer
the conversation to a human operator. Tell the customer that a team
member will respond shortly.

Автовідновлення та контекстне вікно

• Після автоматичної передачі AI повертається сам, щойно в чаті стає тихо. Затримка задається на асистенті (aiAutoReturnDelayMinutes, за замовчуванням 30 хвилин). Ручне вимкнення само не відновлюється — вмикає людина.
• Контекст — рухоме вікно, а не проміжок часу: асистент бачить хвіст розмови, що вміщається в бюджет контексту моделі, а все до останньої позначки підсумку замінює той підсумок. Старіші повідомлення лишаються в базі й доступні через вбудований інструмент searchPreviousConversations.

Передача між асистентами

PATCH /api/chats/{chatId} з { "assistantId": "new-assistant-uuid" }. Новий асистент продовжує з останнього повідомлення; вся історія зберігається.

Дебаунсинг повідомлень

Швидкі серії збираються в пакет: платформа чекає 12 секунд тиші після останнього повідомлення й лише тоді відповідає, а чат, у якому найстаріше неопрацьоване повідомлення старше за 30 секунд, забирає свип, що ходить раз на хвилину. Клієнти регулярно надсилають замовлення частинами, тож відповідь одна — на завершену серію. Поки розпізнається зображення або голосове, вікно продовжується до завершення розпізнавання.

WebSocket-події

{
  "type": "CHAT_MODE_CHANGED",
  "payload": {
    "chatId": "uuid",
    "isUnderAiControl": false,
    "aiDisableReason": "auto"
  }
}

Підключайтесь до wss://api.happ.tools для оновлень у реальному часі.

API: api.happ.tools/reference

Далі

• Інструменти та webhook-дії — як turnOffAiMode поєднується з іншими інструментами
• Канали — де відбуваються передачі через месенджери
• Асистенти — налаштуйте, хто відповідає до передачі