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

Інтеграції

Інтеграції розширюють ваших AI голосових агентів через підключення до зовнішніх сервісів. У цьому розділі описано всі доступні інтеграції та як їх налаштовувати.

Доступні інтеграції​

ІнтеграціяПризначенняСтатусТарифи
Phone NumbersТелефонні номери та дзвінкиДоступнаУсі
SIP TrunkПідключіть свого оператора (sipgate, Placetel, TENIOS, easybell, Zadarma, Twilio BYO, Telnyx, Custom)ДоступнаУсі — потребує перевірки відповідності
Google CalendarПланування прийомів через GoogleДоступнаУсі
Outlook CalendarПланування прийомів через Microsoft OutlookДоступнаУсі
HubSpot CRMЧитання/запис контактів та угод з вашого AI голосового агентаДоступнаУсі
MCP serversПідключіть свій MCP-сумісний tool-сервер і надайте його інструменти агентам — див. MCP ServersДоступнаУсі
API KeysДоступ зовнішніх застосунківДоступнаУсі
WebhooksСповіщення про події в реальному часіДоступнаУсі
Усі тарифи

Інтеграції з календарем, SIP, HubSpot, MCP-сервери, API-доступ і webhooks доступні на всіх тарифах, включно з Free. SIP trunking потребує одноразового затвердження перевірки відповідності перед розблокуванням майстра підключення.

Налаштування телефонного номера​

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

Кроки налаштування​

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

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

Інтеграція SIP Trunk​

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

Підтримувані оператори​

HANC має налаштовані адаптери для таких операторів плюс загальний варіант для будь-чого іншого:

ОператорАвтоімпорт номерів через APIПримітки
sipgateТак (Personal Access Token)EU SIP trunking
PlacetelВручнуGerman VoIP, дані Webportal
TENIOSВручнуEuropean SIP
easybellВручнуНімецький оператор, дані Kundencenter
ZadarmaТак (опціональний API-ключ)Глобальні номери
Twilio (BYO)ТакAccount SID + Auth Token
TelnyxТакAPI-керований SIP та DIDs
Custom SIP trunkВручнуБудь-який інший провайдер — вкажіть хост, порт, транспорт

Затвердження перевірки відповідності​

SIP-з'єднання операторів використовують той самий потік перевірки відповідності, що й вихідні кампанії. Поки ваш обліковий запис не схвалено, кнопка Connect SIP відкриває модальну вітрину, що перераховує всіх підтримуваних операторів з CTA mailto:support@hanc.ai. Затвердження зазвичай протягом того ж робочого дня.

Кроки налаштування (після затвердження)​

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

Коли використовувати SIP проти купівлі номера​

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

Інтеграція Google Calendar​

Підключіть Google Calendar, щоб ваші AI голосові агенти могли перевіряти доступність і бронювати прийоми під час дзвінків.

Кроки налаштування​

  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 хвилин)

Використання календаря в агентах​

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

  • Перевіряти доступність для конкретних дат і часу
  • Бронювати прийоми автоматично
  • Дотримуватися робочих годин і розривів
  • Обробляти запити перепланування

Приклад розмови:

Клієнт: «Чи можу я забронювати прийом на вівторок о 15:00?»

Агент: [Перевіряє календар]
       «Так, вівторок о 15:00 доступний.
        Чи можу я отримати ваше ім'я, щоб завершити бронювання?»

Інтеграція Outlook Calendar​

Підключіть Microsoft Outlook Calendar, щоб увімкнути планування прийомів через ваших AI голосових агентів.

Кроки налаштування​

  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 календарі, але кожен агент може використовувати лише один інструмент календаря.

Скасування прийомів​

Ті, хто телефонував і забронював прийом, отримують посилання для скасування. Вони можуть скасувати свій прийом безпосередньо, не телефонуючи знову.

Інтеграція HubSpot CRM​

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

Що це вмикає​

  • Live tool — HubSpot CRM на вкладці Actions агента. Агент може зіставити того, хто телефонує, з контактом HubSpot за телефоном, отримати етап угоди та оновити властивості з живої розмови. Див. Actions & Tools.
  • Віддзеркалення пайплайнів у 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 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. Негайно скопіюйте ключ (показується лише один раз)

Безпека 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

Webhooks​

Налаштуйте webhooks для отримання сповіщень про події у вашому обліковому записі Hanc.AI у реальному часі.

Налаштування​

  1. Перейдіть до Integration → Webhooks
  2. Введіть URL вашого webhook-ендпоінта
  3. Виберіть події для підписки
  4. Збережіть конфігурацію

Webhooks надсилають HTTP POST-запити до вашого ендпоінта з даними подій у форматі JSON.

Дії після дзвінка​

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

Доступні типи дій​

ДіяОпис
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 хвилин)

Пов'язані теми​