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

Интеграции

Интеграции расширяют возможности голосовых агентов за счёт подключения к внешним сервисам. В этом разделе описаны все доступные интеграции и их настройка.

Доступные интеграции​

ИнтеграцияНазначениеСтатусТарифы
Phone NumbersНомера телефонов и звонкиДоступноВсе
SIP TrunkПодключите своего оператора (sipgate, Placetel, TENIOS, easybell, Zadarma, Twilio BYO, Telnyx, Custom)ДоступноВсе — требуется одобрение комплаенса
Google CalendarЗапись на приём через GoogleДоступноВсе
Outlook CalendarЗапись на приём через Microsoft OutlookДоступноВсе
eTerminПроверка доступности и запись/перенос/отмена приёмов вживую — см. eTerminДоступноВсе
resmioБронирование столов в ресторане вживую — см. resmioДоступноВсе
HubSpot CRMЧтение/запись контактов и сделок из голосового агентаДоступноВсе
MCP serversПодключите свой MCP-совместимый сервер инструментов и предоставьте его инструменты агентам — см. MCP ServersДоступноВсе
API KeysДоступ для внешних приложенийДоступноВсе
WebhooksУведомления о событиях в реальном времениДоступноВсе
Все тарифы

Интеграции с календарями, SIP, HubSpot, MCP-серверы, доступ к API и вебхуки доступны на всех тарифах, включая Free. Для SIP-транкинга требуется однократное одобрение комплаенса, прежде чем разблокируется мастер подключения.

Настройка номера телефона​

Номера телефонов позволяют агентам принимать и совершать реальные телефонные звонки.

Шаги настройки​

  1. Перейдите в Phone Numbers в боковой панели
  2. Нажмите «Buy Number»
  3. Выберите страну и тип номера
  4. Завершите покупку
  5. Назначьте агента на номер

Номера настраиваются автоматически и готовы к использованию сразу после покупки.

Интеграция SIP Trunk​

Подключите своего SIP-оператора — HANC говорит на SIP нативно и направляет входящие звонки в ваш голосовой агент (а исходящие — обратно через ваш транк). Доступно на всех тарифах, включая Free, после однократного одобрения комплаенса.

Поддерживаемые операторы​

У HANC есть настроенные адаптеры для следующих операторов, плюс универсальный вариант для всего остального:

ОператорАвто-импорт номеров через APIПримечания
sipgateДа (Personal Access Token)SIP-транкинг в ЕС
PlacetelВручнуюНемецкий VoIP, учётные данные Webportal
TENIOSВручнуюЕвропейский SIP
easybellВручнуюНемецкий оператор, учётные данные Kundencenter
ZadarmaДа (опциональный API-ключ)Глобальные номера
Twilio (BYO)ДаAccount SID + Auth Token
TelnyxДаSIP и DID через API
Custom SIP trunkВручнуюЛюбой другой провайдер — укажите host, port, transport

Одобрение комплаенса​

Подключения SIP-операторов проходят тот же процесс комплаенса, что и исходящие кампании. Пока ваш аккаунт не одобрен, кнопка Connect SIP открывает демонстрационное окно со списком всех поддерживаемых операторов и CTA mailto:support@hanc.ai. Одобрение обычно в тот же рабочий день.

Шаги настройки (после одобрения)​

  1. Перейдите в Phone Numbers → Connect SIP.
  2. Выберите оператора.
  3. Введите учётные данные SIP (и опциональный API-ключ/секрет, если ваш оператор поддерживает авто-импорт).
  4. Для Custom SIP также укажите host, port (по умолчанию 5060) и transport (UDP / TCP / TLS).
  5. Нажмите Connect — HANC зарегистрирует вашего SIP-пользователя и, где поддерживается, выведет список ваших номеров.
  6. Выберите номера для импорта (или добавьте вручную по E.164).
  7. Назначьте входящего и/или исходящего агента на каждый номер.

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

СценарийРекомендация
Новичок в телефонииПокупайте номера через HANC (проще — без шага комплаенса)
Есть PBX или контракт с операторомПодключайтесь через SIP — сохраните свой номер
Корпоративная телефония со строгими требованиями оператораSIP для полного контроля
Несколько регионов / пулы номеровSIP для гибкости

Интеграция Google Calendar​

Подключите Google Calendar, чтобы голосовые агенты могли проверять доступность и записывать на приём во время звонков.

Шаги настройки​

  1. Перейдите в Integration → Calendars
  2. Нажмите «Connect Google Calendar»
  3. Войдите через Google
  4. Авторизуйте доступ Hanc.AI

Запрашиваемые права:

  • Просмотр событий календаря (для проверки доступности)
  • Создание событий календаря (для записи на приём)

Настройка календаря​

После подключения настройте инструмент календаря на вашем агенте:

НастройкаОписание
calendar_idКакой Google Calendar использовать для записи
timezoneЧасовой пояс для записи (например, Europe/Vienna)
work_hoursДоступные часы для записи (например, понедельник–пятница 9:00–18:00)
slot_durationДлительность приёма по умолчанию (например, 30 минут)
bufferПромежуток между приёмами (например, 15 минут)

Использование календаря в агентах​

После подключения и настройки агенты могут:

  • Проверять доступность на конкретные даты и время
  • Автоматически записывать на приём
  • Учитывать часы работы и промежутки
  • Обрабатывать запросы на перенос

Пример разговора:

Customer: "Can I book an appointment for Tuesday at 3pm?"

Agent: [Checks calendar]
       "Yes, Tuesday at 3pm is available.
        May I have your name to complete the booking?"

Интеграция Outlook Calendar​

Подключите Microsoft Outlook Calendar, чтобы включить запись на приём через голосовых агентов.

Шаги настройки​

  1. Перейдите в Integration → Calendars
  2. Нажмите «Connect Outlook Calendar»
  3. Войдите в свой аккаунт Microsoft
  4. Авторизуйте доступ Hanc.AI

Запрашиваемые права:

  • Просмотр событий календаря (для проверки доступности)
  • Создание событий календаря (для записи на приём)

Настройка календаря​

После подключения настройте инструмент календаря на вашем агенте:

НастройкаОписание
CalendarКакой календарь Outlook использовать для записи
TimezoneЧасовой пояс для записи (например, Europe/Vienna)
Work HoursДоступные часы для записи (например, понедельник–пятница 9:00–18:00)
Slot DurationДлительность приёма по умолчанию (например, 30 минут)
BufferПромежуток между приёмами (например, 15 минут)

Отличия от Google Calendar​

Обе интеграции с календарём работают одинаково с точки зрения агента. Единственное отличие — процесс входа: выбирайте тот сервис календаря, которым уже пользуетесь.

подсказка

Можно подключить одновременно и Google, и Outlook, но каждый агент может использовать только один инструмент календаря.

Отмена приёмов​

Звонящие, записавшиеся на приём, получают ссылку отмены. Они могут отменить свой приём напрямую, без повторного звонка.

Запись на приём через eTermin​

Подключите eTermin, чтобы агенты могли проверять доступность и записывать, переносить или отменять приёмы вживую во время звонка, прямо в ваши календари и услуги eTermin — со встроенной защитой от двойной записи. Используйте eTermin вместо обычного календаря, когда ваши приёмы уже живут в eTermin и вы предлагаете разные услуги со своей длительностью и правилами.

Полную страницу с шагами подключения, настройкой для каждого агента и защитой от двойной записи см. в eTermin.

Бронирование столов resmio​

Подключите resmio, чтобы агенты могли бронировать столы в ресторане прямо в вашу книгу резервов во время звонка — проверяя реальную доступность по времени и числу гостей и обрабатывая переносы и отмены. Используйте resmio, когда ваш ресторан уже принимает брони через него.

Полную страницу с шагами подключения и деталями см. в resmio.

Действия через подключённые аккаунты в сценариях​

Помимо всегда включённых инструментов, которыми агент пользуется во время живого звонка, у сценариев есть отдельный шаг Integration (добавлен в v2.8). Добавьте шаг Integration в сценарий, чтобы одним шагом выполнить действие через подключённый аккаунт Google Calendar, Outlook или HubSpot — например, создать событие в календаре или обновить сделку в HubSpot как часть большего автоматизированного потока. Шаг использует те же подключения на уровне аккаунта, что вы настроили на этой странице, так что ничего дополнительно авторизовывать не нужно.

Интеграция HubSpot CRM​

Подключите ваше рабочее пространство HubSpot, чтобы голосовые агенты могли читать и записывать контакты и сделки во время звонка, а встроенная CRM HANC могла зеркалировать ваши воронки HubSpot.

Что это даёт​

  • Живой инструмент — HubSpot CRM во вкладке Actions агента. Агент может сопоставить звонящего с контактом HubSpot по телефону, получить этап сделки и обновить свойства из живого разговора. См. Действия и инструменты.
  • Зеркалирование воронок в CRM HANC. Ваши этапы сделок HubSpot появляются в канбане Deals, чтобы видеть звонки и контекст HubSpot рядом.
  • Переключатель AI для каждой воронки — решайте, в каких воронках HubSpot AI разрешено действовать; всё остальное остаётся только для чтения.

Шаги настройки​

  1. Откройте страницу Integrations и нажмите Connect HubSpot.
  2. Авторизуйте HANC в вашем аккаунте HubSpot.
  3. Выберите, какие воронки зеркалировать (видны в настройках CRM → Pipeline) и какие должны разрешать обновление этапов агентом.
  4. Добавьте инструмент HubSpot CRM любому агенту, который должен работать с HubSpot во время звонка.
подсказка

Использовать HubSpot для работы с CRM HANC необязательно. Встроенная CRM работает автономно — интеграция с HubSpot нужна исключительно организациям, которые уже живут в HubSpot и хотят синхронизировать оба мира.

MCP-серверы​

Model Context Protocol (MCP) — открытый стандарт для подключения AI-ассистентов к внешним инструментам. Если у вас есть MCP-совместимый сервер, вы можете зарегистрировать его один раз на странице Integration и позволить агентам вызывать его инструменты прямо в разговоре.

Шаги настройки (обзор)​

  1. Перейдите в Integration → MCP servers.
  2. Нажмите Connect MCP server, введите название и HTTPS-URL вашего сервера, выберите аутентификацию (None или Bearer token) и сохраните.
  3. Откройте агента, которому нужны эти инструменты, перейдите в Actions → Add Action → MCP servers и включите подключения, которые должен использовать этот агент.

Агент обнаружит и будет использовать инструменты сервера в начале каждого звонка.

Полную страницу с подробной настройкой, устранением неполадок и тем, как MCP сочетается со встроенными инструментами, см. в MCP Servers.

API Keys​

Создавайте API-ключи, чтобы интегрировать Hanc.AI со своими приложениями.

Создание API-ключа​

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

  1. Перейдите в Integration → API Keys
  2. Нажмите «Create API Key»
  3. Введите название (например, «CRM Integration»)
  4. Задайте права (read, write, admin)
  5. Скопируйте ключ сразу (показывается только один раз)

Безопасность API-ключей​

Важно
  • Храните ключи безопасно (переменные окружения, менеджер секретов)
  • Никогда не коммитьте ключи в систему контроля версий
  • Периодически меняйте ключи
  • Удаляйте неиспользуемые ключи

Использование API-ключей​

Добавляйте в API-запросы:

curl -X GET "https://api.hanc.ai/v1/agent/list" \
  -H "x-api-key: YOUR_API_KEY"

Права API-ключей​

ПравоДоступ
ReadПросмотр агентов, звонков, аналитики
WriteСоздание/изменение агентов, загрузка базы знаний
AdminВсе операции, удаление, настройки

Доступные эндпоинты​

Полный список эндпоинтов API, сгруппированных по ресурсам (Calls, Agents, Knowledge Base, Phone Numbers, Voices, Subscription, Customers, Workspaces), находится на отдельной странице:

→ Полный справочник API

Вебхуки​

После каждого звонка Hanc.AI может отправить его данные — резюме, транскрипцию и ваши извлечённые поля — на ваш собственный эндпоинт в формате JSON. Настройте это как действие API-вызов после звонка у агента (Действия → Post call) или как шаг API-запрос в воркфлоу.

Если ваш сервер недоступен, запрос повторяется по расписанию (по умолчанию 8 попыток примерно за 3,4 дня), каждая попытка записывается в журнал, а неудавшуюся доставку можно отправить снова.

Повторы, журнал доставки, требования к файрволу и формат данных описаны на странице Вебхуки и доставка.

Действия после звонка​

Действия после звонка запускаются автоматически после завершения разговора голосового агента. Настраиваются на отдельных агентах.

Доступные типы действий​

ДействиеОписание
EmailОтправить email со сводкой звонка (владельцу бизнеса, клиенту или обоим)
SMSОтправить SMS-уведомление после звонка
WhatsAppОтправить сообщение в WhatsApp после звонка
API CallВыполнить HTTP-запрос к внешнему эндпоинту с данными звонка

Настройка​

  1. Перейдите в Voice Agents → выберите агента
  2. Откройте вкладку Actions
  3. Нажмите «Add Action»
  4. Выберите тип действия и настройте:
    • Trigger: Когда действие срабатывает (например, после каждого звонка, только при определённых исходах)
    • Recipients: Кто получает уведомление
    • Content: Шаблон сообщения с переменными данных звонка

Пользовательские интеграции​

Использование API​

Создавайте собственные интеграции с помощью API Hanc.AI:

Base URL: https://api.hanc.ai/v1
Authentication: Bearer token (API key)
Format: JSON

Документация API​

Полный список доступных эндпоинтов см. в Справочнике API.

Лучшие практики интеграций​

Безопасность​

  • Храните учётные данные безопасно
  • Регулярно меняйте API-ключи
  • Ограничивайте права до необходимого минимума

Надёжность​

  • Логируйте все события интеграций
  • Отслеживайте состояние интеграций

Тестирование​

  • Сначала тестируйте интеграции в staging
  • Проверяйте поток данных в обе стороны
  • Тестируйте сценарии ошибок
  • Документируйте настройку интеграции

Устранение неполадок​

Интеграция не подключается​

  1. Проверьте правильность учётных данных
  2. Проверьте на опечатки
  3. Убедитесь, что сторонний аккаунт активен
  4. Попробуйте отключить и подключить заново

Календарь не синхронизируется​

  1. Повторно авторизуйте доступ к календарю
  2. Проверьте права календаря
  3. Убедитесь, что выбран правильный календарь
  4. Проверьте задержки синхронизации (до 5 минут)

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