Skip to main content
Conexiunile API sunt funcții HTTP personalizate pe care agenții dumneavoastră le pot apela în timpul unei conversații — pentru a căuta o comandă, a crea un tichet sau a prelua starea contului din propriul backend. Definiți endpointul o singură dată în Conexiuni → API-uri (/dashboard/api-connections); agenții care au conexiunea atașată o pot invoca apoi ori de câte ori este necesar în conversație. Există două modalități de a crea una: lipiți ceva ce asistentul poate analiza sau configurați conexiunea manual.

​
Calea rapidă: lipiți și analizați

1

Faceți clic pe Conexiune API nouă

Fereastra de dialog se deschide în asistent. Lipiți în câmp un exemplu de comandă cURL, specificație OpenAPI/Swagger, export Postman, interfață TypeScript sau schemă Zod.
2

Faceți clic pe Analizați

ThunderPhone deduce întreaga conexiune din conținutul lipit — adresa URL, metoda, anteturile și o schemă de parametri derivată din parametrii de interogare și corpul cererii pe care le-a identificat. Anteturile lipite de dumneavoastră (inclusiv anteturile de autentificare) sunt transferate în configurația endpointului.
3

Confirmați câmpurile evidențiate

Configurația dedusă se deschide cu câmpurile estimate evidențiate pentru verificare. Ajustați numele, descrierile și tipurile de parametri astfel încât agentul să înțeleagă când și cum să apeleze funcția — descrierea este ceea ce citește modelul.
4

Validați și salvați

Salvarea execută mai întâi o cerere de test live către endpointul dumneavoastră. Dacă cererea eșuează, conexiunea nu este salvată — corectați adresa URL, anteturile de autentificare sau corpul cererii și încercați din nou. Dacă reușește, conexiunea este stocată cu insigna Validată.
Dacă asistentul nu găsește o adresă URL de cerere în conținutul lipit, vă va informa — includeți un endpoint complet http(s) și încercați din nou.

​
Configurare manuală

Faceți clic pe Configurați manual → în asistent (sau pe Doriți ca AI-ul să deducă aceasta? Încercați asistentul → pentru a reveni). Generatorul manual are doi editori:
  • Vizual — câmpuri de formular pentru numele afișat, numele funcției, adresa URL, metoda (POST, GET, PUT, PATCH, DELETE), anteturile personalizate și schema de parametri (Adăugați proprietate pentru fiecare argument pe care îl poate furniza agentul).
  • JSON — aceeași definiție ca JSON brut, pentru lipirea sau ajustarea directă a unei specificații de instrument.
Un panou Cerere de test (opțional) vă permite să executați cererea configurată înainte de salvare și afișează starea, latența și o previzualizare a răspunsului. Validați și salvați execută întotdeauna acest test și salvează numai dacă reușește.
Oferiți parametrilor descrieri în limbaj simplu („Adresa de e-mail a clientului, de exemplu jane@example.com”). Agentul alege argumentele din aceste descrieri în timp real, în timpul apelului.

​
Gestionați-vă conexiunile

Fiecare rând de conexiune afișează starea validării — Validată, Netestată sau Eroare — numele funcției sale și agenții care o utilizează. Din meniul de acțiuni al rândului puteți:
  • Edita — redeschide configurația.
  • Clona — duplica conexiunea ca punct de plecare (copia începe ca Netestată).
  • Istoricul reviziilor — vizualiza versiunile anterioare și restaura una în editor.
  • Transfera — copia sau muta conexiunea într-o altă organizație din care faceți parte. Mutarea o elimină de aici; agenții care o utilizau pot necesita reconfigurare.
  • Șterge — permanent; agenții care utilizează conexiunea vor necesita reconfigurare.

​
Atașați-o la un agent

Adăugați conexiunea la un agent în secțiunea de conexiuni API din generator (Creați un agent). Lista arată ce agenți utilizează fiecare conexiune, astfel încât puteți vedea dintr-o privire ce afectează o modificare.

​
Pașii următori

Integrări de instrumente prin API

Creați și gestionați programatic aceleași conexiuni.

Conectați aplicații

Conexiuni preconfigurate pentru Google, Slack, HubSpot, Salesforce și Cal.com.

Adăugați un server MCP

Expuneți un server întreg de instrumente agenților dumneavoastră.

Referință API pentru integrări

Fiecare câmp din resursa de integrare.