Перейти к основному содержимому
DocumentationAPI ReferenceVideo Tutorials

Часто задаваемые вопросы

Ответы на самые частые вопросы про платформу Hanc.AI.

Общие вопросы​

Что такое Hanc.AI?​

Hanc.AI — платформа для создания голосовых AI-агентов, способных автоматически принимать телефонные звонки. Ваш голосовой агент отвечает на вопросы клиентов, записывает на приём, переадресует звонки и многое другое — 24/7, без участия человека.

Нужны ли мне технические навыки?​

Нет. Платформа сделана для бизнес-пользователей без опыта программирования. Вы настраиваете агентов через визуальный интерфейс, пишете инструкции обычным языком и загружаете документы для базы знаний.

Какие языки поддерживает Hanc.AI?​

Интерфейс платформы доступен на:

  • Английском (EN)
  • Немецком (DE)
  • Испанском (ES)
  • Французском (FR)
  • Итальянском (IT)
  • Венгерском (HU)

Голосовые агенты поддерживают 25+ языков. Язык можно задать каждому агенту отдельно. Агент также умеет автоматически переключать язык в звонке, подстраиваясь под собеседника.

Как AI понимает звонящих?​

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

Аккаунт и оплата​

Как создать аккаунт?​

  1. Зайдите на сайт Hanc.AI
  2. Нажмите «Sign Up» или «Get Started»
  3. Введите email и придумайте пароль
  4. Подтвердите телефон по SMS
  5. Заполните профиль

Какие тарифы доступны?​

Hanc.AI предлагает пять тарифов:

  • Free — разовая выдача кредитов, лимит 1 агент. Идеально для тестирования.
  • Starter — ежемесячные кредиты, безлимит агентов. Для малого бизнеса.
  • Pro — больше кредитов, более низкая поминутная ставка. Для растущего бизнеса.
  • Business — высокая выдача, приоритетная поддержка, 99.9% SLA. Для устоявшегося бизнеса.
  • Enterprise — индивидуальные цены, выделенный менеджер, white-label, SSO/SAML. Для крупных организаций.

Доступна годовая оплата со скидкой. См. Settings > Billing за актуальными ценами.

Как работает кредитный биллинг?​

Каждый тариф включает ежемесячные кредиты (package_credits). Всё потребление списывается с баланса по категориям:

  • Кредиты на телефонные звонки — поминутно за телефонные звонки
  • Кредиты на веб-звонки — поминутно за звонки через виджет (обычно ставка ниже)
  • Кредиты на SMS — за каждое SMS, отправленное как пост-звоночное действие
  • Кредиты на переадресацию — за каждую переадресацию человеку
  • Кредиты на телефонные номера — ежемесячно за каждый активный номер

Поддерживаются валюты USD и EUR. Неиспользованные кредиты переносятся на следующий период.

Можно ли поменять тариф?​

Да. Апгрейды действуют немедленно (с пропорциональным расчётом). Понижения — со следующего цикла. Меняется в Settings > Billing.

Какие методы оплаты принимаются?​

  • Кредитные/дебетовые карты (Visa, Mastercard, American Express) через Stripe
  • Банковский перевод (только Enterprise)

Переносятся ли неиспользованные кредиты?​

Да. Они переходят на следующий биллинговый период и не сгорают, пока аккаунт активен.

Голосовые агенты​

Что такое голосовой агент?​

Голосовой агент — это AI-виртуальный ассистент, ведущий телефонные разговоры. Он отвечает на звонки, понимает, что нужно звонящему, даёт информацию из базы знаний и выполняет действия — записывает на приём, переадресует и т. д.

Сколько агентов можно создать?​

  • Free: 1 агент
  • Платные (Starter, Pro, Business, Enterprise): безлимит

Может ли один агент обслуживать несколько номеров?​

Да. На одного агента можно назначить несколько номеров, если они должны вести себя одинаково.

Можно ли иметь разных агентов для разных задач?​

Да. Многие бизнесы используют отдельных агентов для:

  • Запросов о продажах
  • Поддержки клиентов
  • Записи на приём
  • Приёма звонков вне рабочих часов

Можно ли дублировать агента?​

Да. Используйте функцию дублирования, чтобы клонировать существующего агента со всеми настройками, промптом и конфигурацией. Полезно для вариаций и тестирования изменений.

Как протестировать агента перед запуском?​

  1. Используйте кнопку «Talk to Agent» в панели
  2. Разрешите доступ к микрофону в браузере
  3. Говорите естественно и тестируйте разные сценарии
  4. Просматривайте транскрипт после каждого теста

Поймут ли звонящие, что говорят с AI?​

Современные голосовые агенты звучат очень естественно, но мы рекомендуем быть прозрачными со звонящими. Многие бизнесы включают в приветствие фразу: «Здравствуйте, вы дозвонились до виртуального ассистента...»

Какие настройки звонка можно конфигурировать?​

У каждого агента — настраиваемые параметры:

  • Триггер напоминания — время до напоминания, если звонящий молчит (по умолчанию 30 секунд)
  • Макс. напоминаний — максимум напоминаний перед завершением (по умолчанию 3)
  • End call after silence — автозавершение после затяжной тишины (по умолчанию 10 секунд, нужно явно включить)
  • Sentiment analysis — анализ настроения (по умолчанию выкл.)
  • Резюме звонка — генерация резюме после звонка (по умолчанию выкл.)
  • Запись — запись звонка (по умолчанию выкл., проверяйте местные законы о согласии)
  • Язык — основной язык агента
  • Opt-out sensitive data storage — приватность для чувствительных данных

Что такое поля сбора данных?​

Поля сбора данных позволяют агенту извлекать структурированную информацию из разговоров. Поддерживаемые типы:

  • Text — свободный текст (имя, email)
  • Number — числа (бюджет, количество)
  • Boolean — да/нет («интересно ли демо?»)
  • Selector — выбор из предопределённого списка (например, желаемый продукт)

Извлечённые данные доступны в логах и могут отправляться во внешние системы через пост-звоночные actions.

База знаний​

Что такое база знаний?​

База знаний — это коллекция информации, используемая агентом для ответов. Включает детали бизнеса, FAQ, описания продуктов, политики и всё, что могут спросить звонящие.

Какие форматы файлов можно загружать?​

Поддерживаются:

  • PDF (.pdf)
  • Word (.docx, .doc)
  • Excel (.xlsx, .xls)
  • Текст (.txt)
  • Markdown (.md)
  • HTML (.html)
  • CSV (.csv)
  • RTF (.rtf)
  • JSON (.json)

Каков размер базы знаний?​

  • Отдельные файлы: до 10 МБ каждый
  • До 10 файлов на одну базу знаний

Как часто обновлять базу знаний?​

Обновляйте каждый раз, когда:

  • Меняются цены
  • Меняются часы работы
  • Добавляются продукты/услуги
  • Меняются политики
  • Замечаете, что агент даёт устаревшую информацию

Можно ли импортировать БЗ массово?​

Да. Используйте ZIP-импорт для загрузки нескольких файлов сразу. См. Импорт базы знаний.

Почему агент не использует базу знаний?​

Проверьте:

  1. БЗ подключена к агенту (Agent Settings > Knowledge Base)
  2. Информация чётко структурирована
  3. Контент совпадает с тем, как клиенты задают вопросы
  4. Загрузка файла не упала и не в процессе

Телефонные номера и звонки​

Нужен ли свой номер?​

Три варианта:

  1. Купить номер — прямо через платформу
  2. Импортировать существующий — подключить уже имеющиеся номера
  3. Подключить SIP — использовать существующего SIP-провайдера

Можно ли использовать SIP-транки?​

Да. SIP-интеграция доступна на всех тарифах, включая Free. Подключите существующую PBX или телефонную систему через SIP.

Записываются ли звонки?​

Запись опциональна и настраивается на каждого агента (recording_enabled, по умолчанию выкл.). Если включена:

  • Записи хранятся безопасно
  • Доступны в логах звонков
  • Учитывайте местные законы о согласии на запись

Что если агент не может помочь?​

Можно настроить правила эскалации:

  • Передача оператору (Call Forwarding tool)
  • Записать сообщение для перезвона
  • Дать альтернативные контакты
  • Запланировать встречу

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

Какие типы виджетов доступны?​

Четыре типа:

  • Floating call widget (hanc-ai-floating-call) — плавающая кнопка
  • Pill call widget (hanc-ai-pill-call) — компактная пилюлевидная кнопка
  • Inline call widget (hanc-ai-inline-call) — встроен прямо в макет страницы
  • Callback widget (hanc-ai-callback) — форма, собирающая номер посетителя; агент перезванивает. Отличается от других — совершает реальный исходящий звонок, а не голосовой в браузере. См. Callback Widget.

Какие цветовые темы доступны?​

Виджет поддерживает 12 тем, настраиваемых из панели:

Default, Purple, Blue, Cyan, Emerald, Amber, Tangerine, Rose, Ember, Black, White и Tangerine Neon.

Тема задаётся через атрибут theme на элементе виджета или через настройки виджета агента в панели.

Какие события генерирует виджет?​

Виджет генерирует события для интеграций:

  • status-changed — при изменении статуса соединения LiveKit. Статусы: idle, connecting, connected, agent-connected, disconnecting, disconnected, error
  • call-start — при начале звонка
  • call-end — при завершении звонка
  • state-change — при смене состояния виджета. Состояния: idle, connecting, active, ending, error
  • error — при ошибках
  • audio-track — при получении удалённого аудиотрека
  • local-audio-track — при создании локального аудиотрека

Какие технические требования у виджета?​

Виджет требует:

  • WebGL 2.0 (для анимации шара)
  • Web Audio API
  • WebRTC (для реал-тайм голоса)

Callback Widget​

Почему для Callback Widget нужен платный тариф?​

Callback Widget совершает реальные исходящие звонки — каждый callback потребляет исходящие минуты. Free не включает исходящие, поэтому callback недоступен. Остальные виджеты (Floating, Pill, Inline) работают в браузере и остаются бесплатными.

Какие страны поддерживает country picker?​

Picker покрывает Европу (EU + DACH + UK), Северную Америку (US + Canada) и набор дополнительных стран с широкой поддержкой. У каждой страны — флаг, название и пример в нативном формате в поле телефона. Если нужной страны нет — пишите на support@hanc.ai, покрытие расширяется по запросу.

Что если посетитель отправил форму, перезагрузил страницу и снова ввёл тот же номер?​

Виджет понимает, что активный callback на этот номер уже есть у этого агента, и тихо переподключается к нему. Никакого дубль-набора. Посетитель видит свой текущий статус.

Почему виджет пишет «Перезагрузите страницу, чтобы сделать ещё один callback»?​

Виджет блокируется после успешной отправки. Это предотвращает случайные дубли, пока звонок идёт. Если посетитель хочет сделать второй callback (другой номер, вторая попытка), он перезагружает страницу — форма снова чиста. Явная кнопка «Cancel» на экране очереди снимает блокировку без перезагрузки.

Почему виджет показывает «Queue full»?​

Один агент держит одновременно до 10 callback. Если очередь заполнена, новые отправки ждут — виджет показывает дружелюбное «свяжемся в ближайшее время». Пропускная способность восстанавливается по мере завершения текущих звонков.

Как поменять язык интерфейса виджета?​

Два способа:

  • По умолчанию у агента — вкладка Widgets агента → Callback widget → Widget language. Выберите из 14 поддерживаемых языков.
  • Переопределение на странице — добавьте locale="de" (или другой код) на тег <hanc-ai-callback>. Переопределение побеждает дефолт.

Язык виджета влияет только на текст на странице — реальный голосовой разговор идёт на том языке, на который настроен агент.

Может ли агент перезвонить на языке, отличном от языка виджета?​

Да. Язык интерфейса виджета и язык речи агента независимы. Французский виджет на мультиязычном лендинге можно сочетать с англоязычным агентом — или наоборот.

Что делает настройка Max Call Duration с callback?​

Если задан Max Call Duration меньше, чем 10-минутный потолок callback, побеждает ваше короткое значение. Если задан больше 10 минут, 10-минутный потолок callback всё равно действует. Большинству сценариев callback подходит 3–5 минут — стоимость предсказуема.

Actions и Tools​

Какие tools может использовать агент во время звонка?​

ToolНазначениеТарифы
Call ForwardingПередача человекуВсе
Google Calendar / OutlookПроверить доступность и записатьВсе
API Tool RAGПолучить live-данные из APIВсе
HubSpot CRMЧтение/запись контактов и сделок HubSpot из звонкаВсе
Agent TransferПередать звонок другому голосовому агенту вашего аккаунтаВсе
MCP serversОткрыть tools зарегистрированных MCP-серверов — см. MCP ServersВсе

Какие actions агент может выполнять после звонков?​

ActionНазначение
Send EmailEmail-уведомление с данными звонка
Send SMSSMS с данными звонка
Send WhatsAppСообщение в WhatsApp с данными звонка
API CallОтправка данных во внешние системы (CRM, вебхуки)

Может ли агент записывать на приём?​

Да. Подключите Google Calendar и включите соответствующий tool. Агент проверит доступность и запишет прямо в звонке. Доступно на всех тарифах.

Настройки Google Calendar:

  • Длительность слотов: 15, 30, 45, 60, 75, 90, 105 или 120 минут
  • Рабочие часы: настраиваются (по умолчанию 09:00–18:00)
  • Рабочие дни: настраиваются (по умолчанию пн–пт)
  • Часовой пояс: настраивается на каждый календарь

Может ли агент отправлять WhatsApp-сообщения?​

Да. Добавьте «Send WhatsApp» action. Настройте шаблон сообщения, получателей и условия триггера. Сообщения WhatsApp могут включать переменные, извлечённые из разговора.

Промпты и настройка​

Что такое промпт?​

Промпт — это набор инструкций, говорящих агенту, как себя вести. Определяет личность, какую информацию давать, как обрабатывать ситуации и какие действия совершать.

Какой длины должен быть промпт?​

  • Минимум: 10 символов (системный минимум)
  • Максимум: 15 000 символов (системный максимум)
  • Рекомендуется: 500–1000 слов для всеобъемлющего поведения

Качество важнее длины. Будьте конкретны и ясны.

Что такое «temperature» в настройках агента?​

Temperature управляет тем, насколько креативны или предсказуемы ответы агента:

  • Низкая (0.1–0.3): более последовательные, детерминистичные ответы
  • Средняя (0.4–0.6): сбалансировано (рекомендуется для большинства случаев)
  • Высокая (0.7–1.0): более разнообразные, креативные ответы

Для бизнеса обычно лучше низкие значения.

Можно ли менять голос агента?​

Да. Можно выбрать из разных голосов:

  • Мужской или женский
  • Разные возраста и стили
  • Разные акценты
  • Разные скорости речи

Подбирайте голос под бренд.

Интеграции​

Какие интеграции доступны?​

ИнтеграцияСтатусТарифы
Телефонные номераДоступноВсе
SIP TrunkДоступноВсе
Google CalendarДоступноВсе
API KeysДоступноВсе

Сколько API-ключей можно создать?​

Можно создать до 3 API-ключей на пользователя.

Решение проблем​

Агент не отвечает на звонки​

Проверьте:

  1. Агент в статусе «Active»
  2. Номер назначен агенту
  3. Телефонное подключение (или SIP) активно
  4. Настроено приветствие
  5. На балансе есть средства

Агент даёт неверную информацию​

Решения:

  1. Проверьте, что в базе знаний правильная информация
  2. Убедитесь, что БЗ подключена к агенту
  3. Добавьте в промпт явные инструкции использовать только БЗ
  4. Понизьте temperature (0.3–0.5)

Плохое качество звонка​

Попробуйте:

  1. Проверить интернет (рекомендуется 5+ Мбит/с)
  2. Открыть страницу статуса платформы
  3. Попробовать другой голос
  4. Для тестов в браузере — проводное подключение

Не получается войти​

Шаги:

  1. Проверьте правильность email
  2. Попробуйте «Forgot Password» для сброса
  3. Очистите кеш и куки браузера
  4. Попробуйте режим инкогнито
  5. Свяжитесь с поддержкой, если проблема осталась

Безопасность и приватность​

Безопасны ли мои данные?​

Да. Платформа использует:

  • Шифрование AES-256 at rest
  • Шифрование TLS 1.3 in transit
  • Безопасную облачную инфраструктуру (ЦОДы в ЕС)
  • Регулярные аудиты безопасности
  • Firebase-аутентификацию с подтверждением телефона

Кто имеет доступ к записям звонков?​

Только пользователи с подходящими правами в вашей организации. Доступом управляет администратор через настройки команды и ролевую модель (Owner, Admin, Member).

Соответствует ли платформа GDPR?​

Да. Платформа соответствует требованиям GDPR:

  • Доступны DPA-договоры
  • Поддерживается право на удаление
  • Доступен экспорт данных
  • Контроль приватности для записей
  • Опция отказа от хранения чувствительных данных

Можно ли удалить мои данные?​

Да. Можно:

  • Удалять отдельные записи звонков
  • Очищать содержимое базы знаний
  • Удалять агентов
  • Запросить полное удаление аккаунта

Помощь​

Как связаться с поддержкой?​

  • Email: support@hanc.ai
  • Стандартный отклик: в течение 24 часов
  • Pro/Business отклик: в течение 4 часов

Где найти туториалы?​

  • Эта документация
  • Гиды настройки и шаблоны — скачиваемые гиды
  • Видеоуроки (когда доступны)
  • Тултипы и подсказки в приложении

Можно ли предложить функции?​

Да! Присылайте предложения на support@hanc.ai. Мы активно учитываем фидбек пользователей в разработке продукта.

Есть ли сообщество или форум?​

Загляните на сайт Hanc.AI за ресурсами сообщества и новостями.

Быстрый референс​

Рекомендуемые настройки под частые сценарии​

СценарийTemperatureДлина ответаСтиль голоса
Поддержка клиентов0.3–0.4КороткийСпокойный, услужливый
Продажи0.5–0.6СреднийЭнергичный, дружелюбный
Запись на приём0.3–0.4КороткийПрофессиональный
Ресепшен0.3–0.5Очень короткийПриветливый

Чек-лист перед запуском​

  • Промпт полностью готов и протестирован
  • База знаний загружена и подключена
  • Приветствие звучит естественно
  • Настроены правила эскалации
  • Назначен телефонный номер
  • Тестовые звонки прошли успешно
  • У участников команды нужные права

Связанные темы​