# FAQ Поширені запитання про AI-асистентів, канали, білінг, голосові дзвінки та інтеграції на Happ > Full REST + WebSocket API reference: https://api.happ.tools/reference ## Загальне [#загальне] ### Що таке Happ? [#що-таке-happ] Happ — це платформа AI-асистентів, яка автоматизує спілкування з клієнтами через канали обміну повідомленнями (Telegram, Instagram, WhatsApp, Facebook, Viber) та голосові дзвінки. Ваш AI-асистент автоматично відповідає клієнтам, використовуючи знання та інструкції, які ви надаєте. ### Чи потрібні технічні навички для використання Happ? [#чи-потрібні-технічні-навички-для-використання-happ] Ні. Happ розроблений для нетехнічних користувачів. Ви можете налаштувати AI-асистента, підключити канали та керувати розмовами повністю через веб-панель на [my.happ.tools](https://my.happ.tools) — без програмування. API доступний для розробників, які хочуть створити власні інтеграції. ### Які AI-моделі можна використовувати? [#які-ai-моделі-можна-використовувати] Happ підтримує кількох провайдерів та моделі: * **OpenAI** — сімейство GPT-5.x (`gpt-5.1`, `gpt-5-mini`, `gpt-5.4`, `gpt-5.5`), GPT-4.1, GPT-4o, GPT-4o Mini * **Claude (Anthropic)** — Sonnet 4.5 * **Gemini (Google)** — 3.x Flash, Flash Lite, Pro * **Groq** — GPT-OSS 120B / 20B (надшвидка обробка) Див. [Асистенти > Конфігурація AI-моделі](/docs/agents) для повного списку. ### Чи можна використовувати кілька AI-асистентів? [#чи-можна-використовувати-кілька-ai-асистентів] Так. Ви можете створити кілька асистентів, кожен зі своїм промптом, базою знань, інструментами та AI-моделлю. Призначайте різних асистентів різним каналам або випадкам використання. ## Канали [#канали] ### Які месенджери підтримуються? [#які-месенджери-підтримуються] Telegram, Instagram, WhatsApp, Facebook Messenger та Viber. Див. [Огляд каналів](/docs/integrations/messengers) для деталей по кожному. ### Чи може один асистент працювати на кількох каналах? [#чи-може-один-асистент-працювати-на-кількох-каналах] Так. Один асистент може обробляти розмови на всіх підключених каналах одночасно. Кожен канал створює окремі розмови для кожного клієнта. ### Що відбувається при відключенні каналу? [#що-відбувається-при-відключенні-каналу] Активні розмови перестають отримувати відповіді AI. Історичні дані розмов зберігаються. Ви можете повторно підключити канал у будь-який час. ### Чи знають клієнти, що розмовляють з AI? [#чи-знають-клієнти-що-розмовляють-з-ai] Це залежить від вас. Налаштуйте промпт асистента, щоб він представлявся як AI або як звичайний агент підтримки. ## AI та розмови [#ai-та-розмови] ### Як покращити відповіді асистента? [#як-покращити-відповіді-асистента] 1. **Вдосконаліть промпт** — Додайте конкретні інструкції, вказівки щодо тону та приклади 2. **Додайте знання** — Завантажте документи, FAQ та вміст вебсайту до [бази знань](/docs/agents/knowledge) 3. **Візьміть кращу модель** — `gpt-5.5` і `claude-sonnet-4-5` дають відповіді вищої якості 4. **Переглядайте розмови** — Перевіряйте [панель чатів](/docs/workspace/chats), щоб виявити патерни, де асистент має труднощі ### Чи може асистент виконувати дії (не лише чатитись)? [#чи-може-асистент-виконувати-дії-не-лише-чатитись] Так. Налаштуйте [інструменти](/docs/agents/tools), щоб дозволити асистенту викликати зовнішні API — створювати бронювання, оновлювати записи CRM, перевіряти доступність, шукати дані тощо. ### Що відбувається, коли асистент не може відповісти? [#що-відбувається-коли-асистент-не-може-відповісти] Асистент відповідає відповідно до інструкцій промпту (наприклад, "У мене немає цієї інформації, дозвольте з'єднати вас з членом команди"). Ви можете налаштувати [вбудований інструмент](/docs/agents/tools) `turnOffAiMode` для автоматичного вимкнення AI та сповіщення команди через [Telegram Push-сповіщення](/docs/integrations/notifications). ### Чи може менеджер перехопити розмову? [#чи-може-менеджер-перехопити-розмову] Так. Вимкніть AI для будь-якої розмови — вручну з панелі/мобільного додатку, через команду `/bot` у Telegram або автоматично через інструмент `turnOffAiMode`. Коли AI вимкнено, ви можете відповідати вручну. Налаштуйте [Telegram Push-сповіщення](/docs/integrations/notifications) для сповіщення команди при передачі. Див. [Керування AI та передача людині](/docs/workspace/ai-control) для повних деталей. ### Як швидко відповідає AI? [#як-швидко-відповідає-ai] У чатах асистент чекає близько 12 секунд після останнього повідомлення клієнта (щонайбільше 30 секунд) і відповідає на всю пачку одразу — клієнт, що пише кількома короткими повідомленнями, отримує одну цілісну відповідь замість трьох половинчастих. У плейграунді очікування — 3 секунди. ### Що таке контекстне вікно? [#що-таке-контекстне-вікно] Асистент бачить рухоме вікно розмови: хвіст, що вміщається в бюджет контексту моделі, а все до останнього підсумку замінює той підсумок. Старіші повідомлення лишаються в базі й піднімаються вбудованим інструментом `searchPreviousConversations`. Див. [Керування AI](/docs/workspace/ai-control#auto-resume-and-context-window). ### Чи вмикається AI автоматично після передачі? [#чи-вмикається-ai-автоматично-після-передачі] Так, але лише після автоматичної передачі: коли в чаті стає тихо, AI повертається сам через затримку, задану на асистенті (за замовчуванням 30 хвилин). Ручне вимкнення само не відновлюється — вмикає людина. ## Голос [#голос] ### Як працює голосовий асистент? [#як-працює-голосовий-асистент] Голосовий асистент відповідає на телефонні дзвінки за допомогою AI. Він перетворює мовлення в текст (STT), генерує відповідь за допомогою налаштованої AI-моделі та перетворює її назад у мовлення (TTS) — все в реальному часі. Він також може виконувати інструменти під час дзвінків. Див. [Голосовий асистент](/docs/agents/voice). ### Які провайдери телефонії підтримуються? [#які-провайдери-телефонії-підтримуються] Binotel, Ringostat, Phonet та Unitalk. Будь-який SIP-сумісний провайдер потенційно може бути використаний. Див. [Провайдери телефонії](/docs/integrations/telephony). ### Чи можна обрати голос? [#чи-можна-обрати-голос] Так. Обирайте з 30 вбудованих голосів або підключіть [ElevenLabs](/docs/integrations/telephony#elevenlabs-premium-voices) для преміум-голосів з природним звучанням, кількома мовами та акцентами. ## Білінг [#білінг] ### Які плани доступні? [#які-плани-доступні] У Happ одна лінійка тарифів на всю платформу — чат і голос в одній підписці: Start ($49/міс), Business ($199/міс), Scale ($499/міс) та Enterprise (від $1,000/міс). Тариф задає включений обсяг діалогів, кількість одночасних дзвінків і ставки за використання. Див. [Тарифи та оплата](/docs/settings/subscription) для подробиць. ### Як оплачується використання? [#як-оплачується-використання] Понад підписку кожна одиниця списується з балансу компанії: за повідомлення, за хвилину голосу, за розбір розмови й за хвилину розшифровки — за ставками вашого тарифу, плюс вартість самої моделі. Довші розмови, потужніші моделі, пошук у базі знань і виклики інструментів це збільшують. Стежте в розділі **Білінг**. ### Що буде, коли баланс закінчиться? [#що-буде-коли-баланс-закінчиться] Асистенти перестають відповідати, а чат позначається `aiDisableReason: insufficient_balance`. Вони повертаються самі, щойно баланс знову стане додатним. ### Чи можу я змінити тариф? [#чи-можу-я-змінити-тариф] Так. Перехід на дешевший застосовується одразу й нічого не коштує. Перехід на дорожчий — доплата за залишок періоду, застосовується після оплати. Скасування залишає доступ до кінця оплаченого періоду. ## Дані та безпека [#дані-та-безпека] ### Чи безпечні мої дані? [#чи-безпечні-мої-дані] Так. Happ використовує стандартні практики безпеки: * Автентифікація на базі JWT з токенами доступу * HTTPS-шифрування для всіх даних при передачі * Ізоляція даних між компаніями * HMAC-SHA256 підпис запитів вебхуків ### Чи можна видалити свої дані? [#чи-можна-видалити-свої-дані] Так. Ви можете видалити окремі розмови, записи знань або весь робочий простір компанії. Видалення даних є остаточним. ### Де зберігаються дані? [#де-зберігаються-дані] Дані розмов зберігаються в базах даних PostgreSQL. Файли зберігаються у безпечному хмарному сховищі. Векторні вбудовування для бази знань зберігаються в Qdrant. ## Підтримка [#підтримка] ### Як отримати допомогу? [#як-отримати-допомогу] * Перевірте цю документацію для посібників та відповідей * Відвідайте [Довідник API](https://api.happ.tools/reference) для деталей ендпоінтів * Зверніться до підтримки через панель платформи на [my.happ.tools](https://my.happ.tools)