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

> Gör valfritt HTTP-API till en funktion som din agent kan anropa mitt i ett samtal — klistra in ett cURL-kommando och låt guiden sköta resten.

API-anslutningar är anpassade HTTP-funktioner som dina agenter kan anropa under ett
samtal — slå upp en order, skapa ett ärende, hämta kontostatus
från din egen backend. Du definierar slutpunkten en gång under
**Anslutningar → API:er** (`/dashboard/api-connections`); agenter som har
anslutningen kopplad till sig kan sedan anropa den när samtalet
kräver det.

Det finns två sätt att skapa en: klistra in något som guiden kan analysera,
eller konfigurera anslutningen manuellt.

## Snabbaste sättet: klistra in och analysera

<Steps>
  <Step title="Klicka på Ny API-anslutning">
    Dialogrutan öppnas i guiden. Klistra in ett exempel på ett **cURL-kommando**,
    en **OpenAPI/Swagger-specifikation**, en **Postman-export**, ett **TypeScript-
    gränssnitt** eller ett **Zod-schema** i rutan.
  </Step>

  <Step title="Klicka på Analysera">
    ThunderPhone härleder hela anslutningen från det du klistrar in — URL,
    metod, headers och ett parameterschema härlett från frågeparametrarna
    och förfrågans brödtext som hittades. Headers som du klistrade in (inklusive
    autentiseringsheaders) förs över till slutpunktskonfigurationen.
  </Step>

  <Step title="Bekräfta de markerade fälten">
    Den härledda konfigurationen öppnas med de gissade fälten markerade
    för granskning. Justera namn, beskrivningar och parametertyper så att
    agenten förstår när och hur funktionen ska anropas — beskrivningen
    är det som modellen läser.
  </Step>

  <Step title="Validera och spara">
    Sparandet kör först en live-testförfrågan mot din slutpunkt. Om
    förfrågan misslyckas sparas inte anslutningen — åtgärda URL:en,
    autentiseringsheaders eller brödtexten och försök igen. Vid lyckat resultat lagras
    anslutningen med märkningen **Validerad**.
  </Step>
</Steps>

Om guiden inte hittar en URL för förfrågan i det du klistrar in meddelar den det —
inkludera en fullständig `http(s)`-slutpunkt och försök igen.

## Manuell konfiguration

Klicka på **Konfigurera manuellt →** i guiden (eller **Vill du att AI ska härleda detta?
Prova guiden →** för att gå tillbaka). Den manuella byggaren har två redigerare:

* **Visuell** — formulärfält för visningsnamn, funktionsnamn, förfrågans
  **URL**, **metod** (`POST`, `GET`, `PUT`, `PATCH`, `DELETE`), anpassade
  **headers** och parameterschemat (**Lägg till egenskap** för varje
  argument som agenten kan ange).
* **JSON** — samma definition som rå JSON, för att klistra in eller finjustera
  en verktygsspecifikation direkt.

En panel för **Testförfrågan** (valfritt) låter dig skicka den konfigurerade förfrågan
före sparandet och visar status, latens och en förhandsgranskning av svaret.
**Validera och spara** kör alltid detta test och sparar endast vid lyckat resultat.

<Tip>
  Ge parametrar beskrivningar på klarspråk ("Kundens e-postadress,
  t.ex. [jane@example.com](mailto:jane@example.com)"). Agenten väljer argument utifrån dessa
  beskrivningar i realtid, mitt under samtalet.
</Tip>

## Hantera dina anslutningar

Varje anslutningsrad visar dess valideringsstatus — **Validerad**,
**Otestad** eller **Fel** — dess funktionsnamn och vilka agenter som använder den.
Från radens åtgärdsmeny kan du:

* **Redigera** — öppna konfigurationen igen.
* **Klona** — duplicera den som utgångspunkt (kopian börjar som
  Otestad).
* **Versionshistorik** — visa tidigare versioner och återställ en i
  redigeraren.
* **Överför** — kopiera eller flytta anslutningen till en annan organisation som du
  tillhör. Om du flyttar den tas den bort här; agenter som använde den kan behöva
  konfigureras om.
* **Ta bort** — permanent; agenter som använder anslutningen måste
  konfigureras om.

## Koppla den till en agent

Lägg till anslutningen till en agent i byggarens avsnitt för API-anslutningar
([Bygg en agent](/sv/guides/build-an-agent)). Listan visar vilka agenter som
använder varje anslutning, så att du direkt ser vad en ändring påverkar.

## Nästa steg

<CardGroup cols={2}>
  <Card title="Verktygsintegrationer via API" icon="code" href="/sv/guides/build-tool-integration">
    Skapa och hantera samma anslutningar programmatiskt.
  </Card>

  <Card title="Anslut appar" icon="cable" href="/sv/guides/connect-apps">
    Färdiga anslutningar för Google, Slack, HubSpot, Salesforce och Cal.com.
  </Card>

  <Card title="Lägg till en MCP-server" icon="server" href="/sv/guides/mcp-servers">
    Exponera en hel verktygsserver för dina agenter.
  </Card>

  <Card title="API-referens för integrationer" icon="book" href="/api-reference/integrations">
    Alla fält i integrationsresursen.
  </Card>
</CardGroup>
