> ## 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.

# Conexiuni API

> Transformați orice API HTTP într-o funcție pe care agentul dvs. o poate apela în timpul conversației — lipiți o comandă cURL și lăsați asistentul să se ocupe de restul.

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

<Steps>
  <Step title="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**.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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ă**.
  </Step>
</Steps>

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.

<Tip>
  Oferiți parametrilor descrieri în limbaj simplu („Adresa de e-mail a clientului,
  de exemplu [jane@example.com](mailto:jane@example.com)”). Agentul alege argumentele din aceste
  descrieri în timp real, în timpul apelului.
</Tip>

## 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](/ro/guides/build-an-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

<CardGroup cols={2}>
  <Card title="Integrări de instrumente prin API" icon="code" href="/ro/guides/build-tool-integration">
    Creați și gestionați programatic aceleași conexiuni.
  </Card>

  <Card title="Conectați aplicații" icon="cable" href="/ro/guides/connect-apps">
    Conexiuni preconfigurate pentru Google, Slack, HubSpot, Salesforce și Cal.com.
  </Card>

  <Card title="Adăugați un server MCP" icon="server" href="/ro/guides/mcp-servers">
    Expuneți un server întreg de instrumente agenților dumneavoastră.
  </Card>

  <Card title="Referință API pentru integrări" icon="book" href="/api-reference/integrations">
    Fiecare câmp din resursa de integrare.
  </Card>
</CardGroup>