---
title: "Conexiuni API"
description: "Transformați orice API HTTP într-o funcție pe care agentul dumneavoastră o poate apela în timpul conversației: lipiți o comandă cURL, iar asistentul creează definiția instrumentului, parametrii și autentificarea."
---

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, 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 conversația
o necesită.

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 o mostră de **comandă
    cURL**, **specificație OpenAPI/Swagger**, **export Postman**, **interfață
    TypeScript** sau **schemă Zod** în casetă.
  </Step>
  <Step title="Faceți clic pe Analizare">
    ThunderPhone deduce întreaga conexiune din conținutul lipit — URL-ul,
    metoda, anteturile și o schemă de parametri derivată din parametrii de
    interogare și corpul cererii pe care le-a găsit. Anteturile pe care le-ați lipit (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 revizuire. Ajustați numele, descrierile și tipurile parametrilor, 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 URL-ul, anteturile de
    autentificare sau corpul și încercați din nou. Dacă reușește, conexiunea este stocată
    cu insigna **Validată**.
  </Step>
</Steps>

Dacă asistentul nu poate găsi un URL de cerere în conținutul lipit, vă va informa —
includeți un endpoint `http(s)` complet și încercați din nou.

## Configurare manuală

Faceți clic pe **Configurați manual →** în asistent (sau pe **Doriți ca AI să deducă aceasta?
Încercați asistentul →** pentru a reveni). Creatorul manual are două editoare:

- **Vizual** — câmpuri de formular pentru numele afișat, numele funcției, **URL-ul**
  cererii, **metoda** (`POST`, `GET`, `PUT`, `PATCH`, `DELETE`), **anteturile**
  personalizate și schema de parametri (**Adăugați proprietate** pentru fiecare
  argument pe care agentul îl poate furniza).
- **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ă trimiteț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.

Valorile anteturilor pot fi doar scrise. După salvare, acestea sunt criptate și nu mai sunt afișate niciodată, nici în tabloul de bord, nici în API. Când editați o conexiune, un antet salvat își afișează numele cu puncte în locul valorii și nota **Salvat**: lăsați-l neschimbat pentru a păstra valoarea salvată sau introduceți o valoare nouă pentru a o înlocui. Solicitările de test și apelurile active folosesc valoarea salvată. **Clonează** copiază valorile salvate în noua conexiune.

<Tip>
  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.
</Tip>

## Gestionați conexiunile

Fiecare rând de conexiune afișează starea validării — **Validată**,
**Netestată** sau **Eroare** — numele funcției și agenții care o utilizează.
Din meniul de acțiuni al rândului puteți:

- **Edita** — redeschide configurația.
- **Clona** — duplicați-o ca punct de plecare (copia începe ca
  Netestată).
- **Istoric revizii** — vizualizați versiunile anterioare și restaurați una în
  editor.
- **Transfera** — copiați sau mutați 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 trebui
  reconfigurați.

## Atașați-o la un agent

Adăugați conexiunea la un agent în secțiunea de conexiuni API a creatorului
([Creați un agent](/ro/guides/build-an-agent)). Lista afișează 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 întreg server 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>