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

# API savienojumi

> Pārvērtiet jebkuru HTTP API par funkciju, ko jūsu balss aģents var izsaukt sarunas laikā — ielīmējiet cURL komandu, un vednis paveiks pārējo.

API savienojumi ir pielāgotas HTTP funkcijas, kuras jūsu balss aģenti var izsaukt sarunas laikā — atrast pasūtījumu, izveidot biļeti, iegūt konta statusu
no savas aizmugursistēmas. Galapunktu definējat vienreiz sadaļā
**Savienojumi → API** (`/dashboard/api-connections`); balss aģenti, kuriem
ir pievienots savienojums, var to izsaukt, kad tas nepieciešams sarunā.

To var izveidot divos veidos: ielīmēt kaut ko, ko vednis var analizēt,
vai iestatīt savienojumu manuāli.

## Ātrais ceļš: ielīmējiet un analizējiet

<Steps>
  <Step title="Noklikšķiniet uz Jauns API savienojums">
    Dialoglodziņš tiek atvērts vednī. Lodziņā ielīmējiet **cURL komandas**,
    **OpenAPI/Swagger specifikācijas**, **Postman eksportēšanas**, **TypeScript
    saskarnes** vai **Zod shēmas** paraugu.
  </Step>

  <Step title="Noklikšķiniet uz Analizēt">
    ThunderPhone nosaka visu savienojuma konfigurāciju no jūsu ielīmētā satura — URL,
    metodi, galvenes un parametru shēmu, kas izveidota no atrastajiem vaicājuma
    parametriem un pieprasījuma pamatteksta. Ielīmētās galvenes (tostarp
    autorizācijas galvenes) tiek pārnestas uz galapunkta konfigurāciju.
  </Step>

  <Step title="Apstipriniet iezīmētos laukus">
    Noteiktā konfigurācija tiek atvērta ar iezīmētiem paredzētajiem laukiem,
    lai jūs tos pārskatītu. Pielāgojiet nosaukumus, aprakstus un parametru tipus,
    lai balss aģents saprastu, kad un kā izsaukt funkciju — aprakstu
    lasa modelis.
  </Step>

  <Step title="Validēt un saglabāt">
    Saglabāšanas laikā vispirms tiek veikts reāls testa pieprasījums jūsu galapunktam. Ja
    pieprasījums neizdodas, savienojums netiek saglabāts — izlabojiet URL, autorizācijas
    galvenes vai pamattekstu un mēģiniet vēlreiz. Veiksmes gadījumā savienojums tiek saglabāts
    ar emblēmu **Validēts**.
  </Step>
</Steps>

Ja vednis jūsu ielīmētajā saturā nevar atrast pieprasījuma URL, tas par to paziņos —
iekļaujiet pilnu `http(s)` galapunktu un mēģiniet vēlreiz.

## Manuāla iestatīšana

Vednī noklikšķiniet uz **Iestatīt manuāli →** (vai uz **Vai vēlaties, lai MI to noteiktu?
Izmēģiniet vedni →**, lai atgrieztos). Manuālajam veidotājam ir divi redaktori:

* **Vizuāli** — veidlapas lauki parādāmajam nosaukumam, funkcijas nosaukumam, pieprasījuma
  **URL**, **metodei** (`POST`, `GET`, `PUT`, `PATCH`, `DELETE`), pielāgotām
  **galvenēm** un parametru shēmai (**Pievienot īpašību** katram
  argumentam, ko balss aģents var norādīt).
* **JSON** — tā pati definīcija kā neapstrādāts JSON, lai tieši ielīmētu vai precizētu
  rīka specifikāciju.

Panelī **Testa pieprasījums** (neobligāts) varat nosūtīt konfigurēto pieprasījumu
pirms saglabāšanas un skatīt statusu, aizkavi un atbildes priekšskatījumu.
**Validēt un saglabāt** vienmēr veic šo pārbaudi un saglabā tikai veiksmes gadījumā.

<Tip>
  Norādiet parametriem aprakstus vienkāršā valodā ("Klienta e-pasta adrese,
  piem., [jane@example.com](mailto:jane@example.com)"). Balss aģents izvēlas argumentus pēc šiem
  aprakstiem reāllaikā, zvana laikā.
</Tip>

## Pārvaldiet savus savienojumus

Katra savienojuma rinda rāda tā validācijas statusu — **Validēts**,
**Netestēts** vai **Kļūda** — funkcijas nosaukumu un balss aģentus, kas to izmanto.
No rindas darbību izvēlnes varat:

* **Rediģēt** — atkārtoti atvērt konfigurāciju.
* **Klonēt** — dublēt to kā sākumpunktu (kopija sākotnēji ir
  netestēta).
* **Versiju vēsture** — skatīt iepriekšējās versijas un atjaunot kādu no tām
  redaktorā.
* **Pārsūtīt** — kopēt vai pārvietot savienojumu uz citu organizāciju, kurai
  piederat. Pārvietošana to no šejienes noņem; balss aģentiem, kas to izmantoja, var būt
  nepieciešama pārkonfigurēšana.
* **Dzēst** — neatgriezeniski; balss aģentiem, kas izmanto savienojumu, būs nepieciešama
  pārkonfigurēšana.

## Pievienojiet to balss aģentam

Pievienojiet savienojumu balss aģentam veidotāja sadaļā API savienojumi
([Izveidojiet balss aģentu](/lv/guides/build-an-agent)). Sarakstā redzams, kuri balss aģenti
izmanto katru savienojumu, lai jūs uzreiz varētu noteikt, ko ietekmē izmaiņas.

## Nākamās darbības

<CardGroup cols={2}>
  <Card title="Rīku integrācijas, izmantojot API" icon="code" href="/lv/guides/build-tool-integration">
    Izveidojiet un pārvaldiet tās pašas savienojumu konfigurācijas programmatiski.
  </Card>

  <Card title="Savienojiet lietotnes" icon="cable" href="/lv/guides/connect-apps">
    Iepriekš izveidotas Google, Slack, HubSpot, Salesforce un Cal.com savienojumu konfigurācijas.
  </Card>

  <Card title="Pievienojiet MCP serveri" icon="server" href="/lv/guides/mcp-servers">
    Padariet visu rīku serveri pieejamu saviem balss aģentiem.
  </Card>

  <Card title="Integrāciju API atsauce" icon="book" href="/api-reference/integrations">
    Visi integrācijas resursa lauki.
  </Card>
</CardGroup>