# FAQ Частые вопросы об AI-агентах, каналах, биллинге, голосовых звонках и интеграциях в Happ > Full REST + WebSocket API reference: https://api.happ.tools/reference ## Общее [#general] ### Что такое Happ? [#what-is-happ] Happ — платформа AI-агентов, которая автоматизирует общение с клиентами в мессенджерах (Telegram, Instagram, WhatsApp, Facebook, Viber) и голосовых звонках. Ваш AI-агент автоматически отвечает клиентам, используя знания и инструкции, которые вы ему даёте. ### Нужны ли технические навыки, чтобы пользоваться Happ? [#do-i-need-technical-skills-to-use-happ] Нет. Happ рассчитан на нетехнических пользователей. Настроить AI-агента, подключить каналы и управлять разговорами можно полностью через веб-панель на [my.happ.tools](https://my.happ.tools) — без программирования. API доступен разработчикам, которые хотят создать собственные интеграции. ### Какие AI-модели можно использовать? [#which-ai-models-can-i-use] 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-агентов? [#can-i-use-multiple-ai-assistants] Да. Можно создать несколько агентов, у каждого свой промпт, база знаний, инструменты и AI-модель. Назначайте разных агентов разным каналам или сценариям. ## Каналы [#channels] ### Какие мессенджеры поддерживаются? [#which-messengers-are-supported] Telegram, Instagram, WhatsApp, Facebook Messenger и Viber. Подробности по каждому — в [Обзоре каналов](/docs/integrations/messengers). ### Может ли один агент работать в нескольких каналах? [#can-one-assistant-work-on-multiple-channels] Да. Один агент может вести разговоры во всех подключённых каналах одновременно. В каждом канале для каждого клиента создаются отдельные разговоры. ### Что будет, если отключить канал? [#what-happens-if-i-disconnect-a-channel] Активные разговоры перестают получать ответы AI. История разговоров сохраняется. Канал можно подключить снова в любой момент. ### Знают ли клиенты, что говорят с AI? [#do-customers-know-theyre-talking-to-an-ai] Это решаете вы. Настройте промпт агента так, чтобы он представлялся AI-ассистентом или обычным сотрудником поддержки. ## AI и разговоры [#ai--conversations] ### Как улучшить ответы агента? [#how-do-i-improve-my-assistants-responses] 1. **Доработайте промпт** — добавьте конкретные инструкции, правила тона и примеры 2. **Добавьте знания** — загрузите документы, FAQ и контент сайта в [Базу знаний](/docs/agents/knowledge) 3. **Выберите более мощную модель** — `gpt-5.5` и `claude-sonnet-4-5` дают ответы более высокого качества 4. **Просматривайте разговоры** — смотрите [панель чатов](/docs/workspace/chats), чтобы найти места, где агент справляется плохо ### Может ли агент выполнять действия, а не только переписываться? [#can-the-assistant-perform-actions-not-just-chat] Да. Настройте [инструменты](/docs/agents/tools), чтобы агент вызывал внешние API — создавал бронирования, обновлял записи в CRM, проверял наличие, искал данные и многое другое. ### Что происходит, когда агент не может ответить? [#what-happens-when-the-assistant-cant-answer] Агент отвечает согласно инструкциям промпта (например, «У меня нет этой информации, давайте я соединю вас с сотрудником»). Можно настроить [встроенный инструмент](/docs/agents/tools) `turnOffAiMode`, чтобы автоматически выключать AI и оповещать команду через [push-уведомления в Telegram](/docs/integrations/notifications). ### Может ли менеджер перехватить разговор? [#can-a-manager-take-over-a-conversation] Да. Выключите AI для любого разговора — вручную из панели или мобильного приложения, командой `/bot` в Telegram или автоматически через инструмент `turnOffAiMode`. Когда AI выключен, вы можете отвечать вручную. Настройте [push-уведомления в Telegram](/docs/integrations/notifications), чтобы команда узнавала о передаче разговора. Подробнее — в разделе [Контроль AI и передача человеку](/docs/workspace/ai-control). ### Как быстро отвечает AI? [#how-fast-does-the-ai-respond] В чатах агент ждёт около 12 секунд после последнего сообщения клиента (максимум 30 секунд) и отвечает на все сообщения сразу — клиент, который пишет несколькими короткими сообщениями, получает один связный ответ вместо трёх обрывочных. В плейграунде ожидание — 3 секунды. ### Что такое контекстное окно? [#what-is-the-context-window] Агент видит скользящее окно разговора: последние сообщения, которые помещаются в контекст модели, а всё, что было до последнего саммари, заменено этим саммари. Старые сообщения остаются в базе, и их можно найти встроенным инструментом `searchPreviousConversations`. См. [Контроль AI](/docs/workspace/ai-control#auto-resume-and-context-window). ### Включается ли AI автоматически после передачи? [#does-ai-automatically-turn-back-on-after-handoff] Да, но только после автоматической передачи: когда в чате становится тихо, AI возвращается сам через задержку, заданную у агента (по умолчанию 30 минут). После ручного выключения AI сам не включается — его снова включает человек. ## Голос [#voice] ### Как работает голосовой агент? [#how-does-the-voice-assistant-work] Голосовой агент отвечает на телефонные звонки с помощью AI. Он переводит речь в текст (STT), генерирует ответ настроенной AI-моделью и превращает его обратно в речь (TTS) — всё в реальном времени. Во время звонков он также может вызывать инструменты. См. [Голосовой агент](/docs/agents/voice). ### Какие провайдеры телефонии поддерживаются? [#which-telephony-providers-are-supported] Binotel, Ringostat, Phonet и Unitalk. В принципе можно использовать любого SIP-совместимого провайдера. См. [Провайдеры телефонии](/docs/integrations/telephony). ### Можно ли выбрать голос? [#can-i-choose-the-voice] Да. Выбирайте из 30 встроенных голосов или подключите [ElevenLabs](/docs/integrations/telephony#elevenlabs-premium-voices) для премиум-голосов с естественным звучанием, несколькими языками и акцентами. ## Биллинг [#billing] ### Какие тарифы доступны? [#what-plans-are-available] У Happ одна линейка тарифов на всю платформу — чат и голос в одной подписке: Start ($49/мес), Business ($199/мес), Scale ($499/мес) и Enterprise (от $1,000/мес). Тариф задаёт включённый объём диалогов, число одновременных звонков и ставки за использование. Подробности — в [Тарифы и оплата](/docs/settings/subscription). ### Как оплачивается использование? [#how-is-usage-charged] Сверх подписки каждая единица использования списывается с баланса компании: за сообщение, за минуту голоса, за анализ разговора и за минуту транскрипции — по ставкам вашего тарифа плюс собственная стоимость модели. Более длинные разговоры, более мощные модели, поиск по базе знаний и вызовы инструментов увеличивают расход. Следите за расходом в разделе **Биллинг**. ### Что будет, когда закончится баланс? [#what-happens-when-the-balance-runs-out] Агенты перестают отвечать, а чат помечается `aiDisableReason: insufficient_balance`. Агенты сами возобновят работу, как только баланс снова станет положительным. ### Можно ли сменить тариф? [#can-i-change-my-plan] Да. Переход на более дешёвый тариф применяется сразу и ничего не стоит. Переход на более дорогой — доплата пропорционально остатку периода, применяется после оплаты. При отмене доступ сохраняется до конца оплаченного периода. ## Данные и безопасность [#data--security] ### Безопасны ли мои данные? [#is-my-data-secure] Да. Happ использует стандартные отраслевые практики безопасности: * Аутентификация на базе JWT с токенами доступа * HTTPS-шифрование всех передаваемых данных * Изоляция данных между компаниями * Подпись запросов вебхуков HMAC-SHA256 ### Можно ли удалить свои данные? [#can-i-delete-my-data] Да. Можно удалить отдельные разговоры, записи базы знаний или весь воркспейс компании. Удаление данных необратимо. ### Где хранятся данные? [#where-is-data-stored] Данные разговоров хранятся в базах данных PostgreSQL. Файлы — в защищённом облачном хранилище. Векторные эмбеддинги для базы знаний хранятся в Qdrant. ## Поддержка [#support] ### Как получить помощь? [#how-do-i-get-help] * Ищите инструкции и ответы в этой документации * Откройте [Справочник API](https://api.happ.tools/reference) с подробностями по эндпоинтам * Напишите в поддержку через панель платформы на [my.happ.tools](https://my.happ.tools)