---
title: "Підключення API"
description: "Перетворіть будь-який HTTP API на функцію, яку ваш агент може викликати під час розмови: вставте команду cURL, і майстер створить визначення інструмента, параметри та автентифікацію."
---

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

Є два способи створити підключення: вставити дані, які майстер може проаналізувати,
або налаштувати підключення вручну.

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

<Steps>
  <Step title="Натисніть «Нове API-підключення»">
    Відкриється діалогове вікно майстра. Вставте в поле приклад **команди cURL**,
    **специфікації OpenAPI/Swagger**, **експорту Postman**, **інтерфейсу TypeScript**
    або **схеми Zod**.
  </Step>
  <Step title="Натисніть «Аналізувати»">
    ThunderPhone визначить усе підключення з ваших даних — URL,
    метод, заголовки та схему параметрів на основі параметрів запиту
    й тіла запиту, які він знайде. Вставлені вами заголовки (зокрема
    заголовки автентифікації) буде перенесено до конфігурації кінцевої точки.
  </Step>
  <Step title="Підтвердьте виділені поля">
    Визначена конфігурація відкриється з виділеними передбаченими полями
    для перевірки. Скоригуйте назви, описи й типи параметрів, щоб
    агент розумів, коли та як викликати функцію — опис
    читає модель.
  </Step>
  <Step title="Перевірити й зберегти">
    Перед збереженням буде виконано тестовий запит до вашої кінцевої точки. Якщо
    запит не вдасться, підключення не буде збережено — виправте URL, заголовки
    автентифікації або тіло запиту й спробуйте ще раз. У разі успіху підключення буде збережено
    з позначкою **Перевірено**.
  </Step>
</Steps>

Якщо майстер не може знайти URL запиту у вставлених даних, він повідомить про це —
додайте повну кінцеву точку `http(s)` і спробуйте ще раз.

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

Натисніть **Налаштувати вручну →** у майстрі (або **Хочете, щоб це визначив ШІ?
Спробуйте майстер →**, щоб повернутися). Конструктор ручного налаштування має два редактори:

- **Візуальний** — поля форми для відображуваної назви, назви функції, **URL**
  запиту, **методу** (`POST`, `GET`, `PUT`, `PATCH`, `DELETE`), користувацьких
  **заголовків** і схеми параметрів (**Додати властивість** для кожного
  аргументу, який може передати агент).
- **JSON** — те саме визначення у форматі необробленого JSON для вставлення
  або точного налаштування специфікації інструмента безпосередньо.

Панель **Тестовий запит** (необов’язкова) дає змогу виконати налаштований запит
перед збереженням і показує статус, затримку та попередній перегляд відповіді.
**Перевірити й зберегти** завжди виконує цей тест і зберігає лише в разі успіху.

Значення заголовків доступні лише для запису. Після збереження вони шифруються й більше не відображаються ні на панелі керування, ні в API. Під час редагування підключення збережений заголовок показує свою назву, крапки замість значення та позначку **Збережено**: залиште його без змін, щоб зберегти збережене значення, або введіть нове, щоб замінити його. Тестові запити й дзвінки в реальному часі використовують збережене значення. **Клонувати** копіює збережені значення до нового підключення.

<Tip>
  Надавайте параметрам зрозумілі описи («Електронна адреса клієнта,
  наприклад jane@example.com»). Агент вибирає аргументи на основі цих
  описів у реальному часі, посеред дзвінка.
</Tip>

## Керуйте підключеннями

У кожному рядку підключення відображається його статус перевірки — **Перевірено**,
**Не перевірено** або **Помилка** — назва функції та агенти, які його використовують.
У меню дій рядка ви можете:

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

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

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

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

<CardGroup cols={2}>
  <Card title="Інтеграції інструментів через API" icon="code" href="/uk/guides/build-tool-integration">
    Програмно створюйте й керуйте тими самими підключеннями.
  </Card>
  <Card title="Підключення застосунків" icon="cable" href="/uk/guides/connect-apps">
    Готові підключення Google, Slack, HubSpot, Salesforce і Cal.com.
  </Card>
  <Card title="Додати сервер MCP" icon="server" href="/uk/guides/mcp-servers">
    Надайте своїм агентам доступ до цілого сервера інструментів.
  </Card>
  <Card title="Довідник API інтеграцій" icon="book" href="/api-reference/integrations">
    Усі поля ресурсу інтеграції.
  </Card>
</CardGroup>