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 для вставки или точной настройки спецификации инструмента напрямую.
Панель Тестовый запрос (необязательно) позволяет выполнить настроенный запрос до сохранения и показывает статус, задержку и предварительный просмотр ответа. Проверить и сохранить всегда выполняет этот тест и сохраняет данные только при успехе.
Добавляйте к параметрам понятные описания («Email-адрес клиента, например jane@example.com»). Агент выбирает аргументы по этим описаниям в реальном времени во время звонка.

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

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

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

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

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

Интеграции инструментов через API

Создавайте и управляйте теми же подключениями программно.

Подключение приложений

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

Добавление MCP-сервера

Предоставьте своим агентам доступ к целому серверу инструментов.

Справочник API интеграций

Все поля ресурса интеграции.