Skip to main content
Połączenia API to niestandardowe funkcje HTTP, które Twoi agenci mogą wywoływać podczas rozmowy — wyszukiwać zamówienie, tworzyć zgłoszenie, pobierać status konta z własnego backendu. Definiujesz endpoint tylko raz w sekcji Połączenia → API (/dashboard/api-connections); agenci z dołączonym połączeniem mogą następnie wywoływać je zawsze, gdy wymaga tego rozmowa. Możesz utworzyć połączenie na dwa sposoby: wkleić coś, co kreator może przeanalizować, albo skonfigurować połączenie ręcznie.

​
Szybka ścieżka: wklej i przeanalizuj

1

Kliknij Nowe połączenie API

Okno dialogowe otworzy się w kreatorze. Wklej przykładowe polecenie cURL, specyfikację OpenAPI/Swagger, eksport Postman, interfejs TypeScript lub schemat Zod do pola.
2

Kliknij Analizuj

ThunderPhone wywnioskuje całe połączenie na podstawie wklejonych danych — adres URL, metodę, nagłówki oraz schemat parametrów utworzony na podstawie znalezionych parametrów zapytania i treści żądania. Wklejone nagłówki (w tym nagłówki uwierzytelniania) zostaną przeniesione do konfiguracji endpointu.
3

Potwierdź wyróżnione pola

Wywnioskowana konfiguracja otworzy się z wyróżnionymi polami sugerowanymi do sprawdzenia. Dostosuj nazwy, opisy i typy parametrów, aby agent wiedział, kiedy i jak wywołać funkcję — opis jest tym, co odczytuje model.
4

Zweryfikuj i zapisz

Zapisanie najpierw uruchamia rzeczywiste testowe żądanie do Twojego endpointu. Jeśli żądanie się nie powiedzie, połączenie nie zostanie zapisane — popraw adres URL, nagłówki uwierzytelniania lub treść i spróbuj ponownie. Po powodzeniu połączenie zostanie zapisane z plakietką Zweryfikowane.
Jeśli kreator nie znajdzie adresu URL żądania we wklejonych danych, poinformuje o tym — uwzględnij pełny endpoint http(s) i spróbuj ponownie.

​
Konfiguracja ręczna

Kliknij Skonfiguruj ręcznie → w kreatorze (lub Chcesz, aby AI to wywnioskowała? Wypróbuj kreatora →, aby wrócić). Kreator ręcznej konfiguracji ma dwa edytory:
  • Wizualny — pola formularza dla nazwy wyświetlanej, nazwy funkcji, żądanego adresu URL, metody (POST, GET, PUT, PATCH, DELETE), niestandardowych nagłówków i schematu parametrów (Dodaj właściwość dla każdego argumentu, który może podać agent).
  • JSON — ta sama definicja jako surowy JSON, do wklejenia lub precyzyjnego dostosowania specyfikacji narzędzia bezpośrednio.
Panel Żądanie testowe (opcjonalny) pozwala wysłać skonfigurowane żądanie przed zapisaniem oraz pokazuje status, opóźnienie i podgląd odpowiedzi. Zweryfikuj i zapisz zawsze uruchamia ten test i zapisuje tylko po powodzeniu.
Nadaj parametrom opisy w prostym języku („Adres e-mail klienta, np. jane@example.com”). Agent wybiera argumenty na podstawie tych opisów w czasie rzeczywistym, w trakcie rozmowy.

​
Zarządzanie połączeniami

Każdy wiersz połączenia pokazuje jego status weryfikacji — Zweryfikowane, Nieprzetestowane lub Błąd — nazwę funkcji oraz agentów, którzy z niego korzystają. W menu działań wiersza możesz:
  • Edytuj — ponownie otworzyć konfigurację.
  • Klonuj — zduplikować połączenie jako punkt wyjścia (kopia ma status Nieprzetestowane).
  • Historia wersji — wyświetlić wcześniejsze wersje i przywrócić jedną z nich w edytorze.
  • Przenieś — skopiować lub przenieść połączenie do innej organizacji, do której należysz. Przeniesienie usuwa je tutaj; agenci, którzy z niego korzystali, mogą wymagać ponownej konfiguracji.
  • Usuń — działanie trwałe; agenci korzystający z połączenia będą wymagać ponownej konfiguracji.

​
Dołącz do agenta

Dodaj połączenie do agenta w sekcji połączeń API kreatora (Utwórz agenta). Lista pokazuje, którzy agenci korzystają z każdego połączenia, dzięki czemu od razu wiesz, czego dotyczy zmiana.

​
Kolejne kroki

Integracje narzędzi przez API

Twórz i zarządzaj tymi samymi połączeniami programowo.

Połącz aplikacje

Gotowe połączenia z Google, Slack, HubSpot, Salesforce i Cal.com.

Dodaj serwer MCP

Udostępnij swoim agentom cały serwer narzędzi.

Dokumentacja API integracji

Każde pole zasobu integracji.