> ## 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>
  Добавляйте к параметрам понятные описания («Email-адрес клиента,
  например [jane@example.com](mailto:jane@example.com)»). Агент выбирает аргументы по этим
  описаниям в реальном времени во время звонка.
</Tip>

## Управление подключениями

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

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

## Подключите его к агенту

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

## Следующие шаги

<CardGroup cols={2}>
  <Card title="Интеграции инструментов через API" icon="code" href="/ru/guides/build-tool-integration">
    Создавайте и управляйте теми же подключениями программно.
  </Card>

  <Card title="Подключение приложений" icon="cable" href="/ru/guides/connect-apps">
    Готовые подключения к Google, Slack, HubSpot, Salesforce и Cal.com.
  </Card>

  <Card title="Добавление MCP-сервера" icon="server" href="/ru/guides/mcp-servers">
    Предоставьте своим агентам доступ к целому серверу инструментов.
  </Card>

  <Card title="Справочник API интеграций" icon="book" href="/api-reference/integrations">
    Все поля ресурса интеграции.
  </Card>
</CardGroup>