Skip to main content
API-підключення — це власні HTTP-функції, які ваші агенти можуть викликати під час розмови: шукати замовлення, створювати тікети, отримувати статус облікового запису з вашого бекенду. Ви визначаєте кінцеву точку один раз у розділі Підключення → API (/dashboard/api-connections); агенти, до яких прикріплено підключення, можуть викликати його щоразу, коли цього потребує розмова. Створити підключення можна двома способами: вставити дані, які майстер може проаналізувати, або налаштувати підключення вручну.

​
Швидкий спосіб: вставте й проаналізуйте

1

Натисніть «Нове API-підключення»

Діалогове вікно відкриється в майстрі. Вставте в поле приклад команди cURL, специфікацію OpenAPI/Swagger, експорт Postman, інтерфейс TypeScript або схему Zod.
2

Натисніть «Аналізувати»

ThunderPhone визначить усе підключення на основі вставлених даних — URL, метод, заголовки та схему параметрів, сформовану з параметрів запиту й тіла запиту, які він знайде. Вставлені вами заголовки (зокрема заголовки автентифікації) буде додано до конфігурації кінцевої точки.
3

Підтвердьте виділені поля

Відкриється визначена конфігурація з виділеними для перевірки полями. Скоригуйте назви, описи й типи параметрів, щоб агент розумів, коли та як викликати функцію — саме опис читає модель.
4

Перевірити й зберегти

Перед збереженням буде виконано тестовий запит до вашої кінцевої точки. Якщо запит не виконається, підключення не буде збережено — виправте URL, заголовки автентифікації або тіло запиту та спробуйте ще раз. У разі успіху підключення буде збережено з позначкою Перевірено.
Якщо майстер не знайде URL запиту у вставлених даних, він повідомить про це — додайте повну кінцеву точку http(s) і спробуйте ще раз.

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

Натисніть Налаштувати вручну → у майстрі (або Хочете, щоб ШІ визначив це? Спробувати майстер →, щоб повернутися). У конструкторі вручну є два редактори:
  • Візуальний — поля форми для відображуваної назви, назви функції, URL запиту, методу (POST, GET, PUT, PATCH, DELETE), власних заголовків і схеми параметрів (Додати властивість для кожного аргументу, який може передати агент).
  • JSON — те саме визначення у вигляді JSON без обробки, для вставлення або точного налаштування специфікації інструмента безпосередньо.
Панель Тестовий запит (необов’язково) дає змогу надіслати налаштований запит перед збереженням і показує статус, затримку та попередній перегляд відповіді. Перевірити й зберегти завжди виконує цей тест і зберігає лише в разі успіху.
Додавайте до параметрів зрозумілі описи («Електронна адреса клієнта, наприклад jane@example.com»). Агент вибирає аргументи на основі цих описів у реальному часі, під час дзвінка.

​
Керуйте своїми підключеннями

У кожному рядку підключення відображається його статус перевірки — Перевірено, Не перевірено або Помилка — назва функції та агенти, які його використовують. У меню дій рядка можна:
  • Редагувати — повторно відкрити конфігурацію.
  • Клонувати — створити дублікат як початкову точку (копія починається зі статусом «Не перевірено»).
  • Історія редакцій — переглянути попередні версії та відновити одну з них у редакторі.
  • Передати — скопіювати або перемістити підключення до іншої організації, до якої ви належите. Переміщення видаляє його звідси; агентам, які його використовували, може знадобитися повторне налаштування.
  • Видалити — назавжди; агентів, які використовують підключення, потрібно буде налаштувати повторно.

​
Прикріпіть його до агента

Додайте підключення до агента в розділі API-підключень конструктора (Створення агента). Список показує, які агенти використовують кожне підключення, тож ви одразу бачите, на що вплине зміна.

​
Наступні кроки

Інтеграції інструментів через API

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

Підключення застосунків

Готові підключення Google, Slack, HubSpot, Salesforce і Cal.com.

Додайте MCP-сервер

Надайте своїм агентам доступ до цілого сервера інструментів.

Довідник API інтеграцій

Усі поля ресурсу інтеграції.