Интеграции

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

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

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

Все тарифы

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

---

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

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

Шаги

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

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

---

Интеграция SIP-транка

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

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

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

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

Compliance-одобрение

Подключения SIP-операторов используют тот же compliance-флоу, что и исходящие кампании. Пока ваш аккаунт не одобрен, кнопка Connect SIP открывает showcase-модалку со списком всех поддерживаемых операторов и 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 vs покупку номера

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

---

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

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

Шаги

1. Integration → Calendars
2. «Connect Google Calendar»
3. Войдите в Google
4. Авторизуйте Hanc.AI

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

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

Конфигурация календаря

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

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

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

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

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

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

Клиент: «Можно записаться на вторник 15:00?»

Агент: [проверяет календарь]
       «Да, вторник 15:00 свободен.
        Подскажите имя для записи?»

---

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

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

Шаги

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

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

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

Конфигурация

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

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

Отличия от Google Calendar

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

подсказка

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

Отмена записей

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

---

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

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

Что даёт

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

Шаги

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

подсказка

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

---

MCP-серверы

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

Шаги (обзор)

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

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

См. полную страницу MCP Servers для детальной настройки, решения проблем и того, как MCP сосуществует с встроенными инструментами.

---

API-ключи

Генерируйте API-ключи для интеграции Hanc.AI со своими приложениями.

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

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

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

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

Важно

• Храните ключи безопасно (env, secrets manager)
• Никогда не коммитьте в Git
• Регулярно ротируйте
• Удаляйте неиспользуемые

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

Включите в 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 Reference

---

Вебхуки

Настройте вебхуки для реал-тайм уведомлений о событиях в вашем аккаунте Hanc.AI.

Настройка

1. Integration → Webhooks
2. Введите URL вебхук-эндпоинта
3. Выберите события для подписки
4. Сохраните

Вебхуки шлют HTTP POST на ваш эндпоинт с данными событий в JSON.

---

Пост-звоночные actions

Пост-звоночные actions запускаются автоматически после завершения разговора. Настраиваются на каждом агенте.

Доступные типы

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

Настройка

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

---

Кастомные интеграции

Через API

Делайте кастомные интеграции через Hanc.AI API:

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

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

См. API Reference — полный список эндпоинтов.

---

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

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

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

Надёжность

• Логируйте все события интеграций
• Мониторьте здоровье интеграций

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

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

---

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

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

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

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

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

---

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

• Телефонные номера — управление номерами
• Голосовые агенты — использование интеграций в агентах
• Аналитика — отслеживание событий интеграций