> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Підключення API

> Перетворіть будь-який 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 без обробки, для вставлення або
  точного налаштування специфікації інструмента безпосередньо.

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

<Tip>
  Додавайте до параметрів зрозумілі описи («Електронна адреса клієнта,
  наприклад [jane@example.com](mailto: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>