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

> Gjør et hvilket som helst HTTP-API om til en funksjon agenten din kan kalle midt i en samtale — lim inn en cURL-kommando, så tar veiviseren seg av resten.

API-tilkoblinger er tilpassede HTTP-funksjoner som agentene dine kan kalle under en
samtale — slå opp en bestilling, opprette en sak, hente kontostatus
fra din egen backend. Du definerer endepunktet én gang under
**Tilkoblinger → API-er** (`/dashboard/api-connections`); agenter som har
tilkoblingen koblet til, kan deretter bruke den når samtalen
krever det.

Det finnes to måter å opprette en på: lim inn noe veiviseren kan analysere,
eller sett opp tilkoblingen manuelt.

## Den raske måten: lim inn og analyser

<Steps>
  <Step title="Klikk på Ny API-tilkobling">
    Dialogboksen åpnes i veiviseren. Lim inn et eksempel på en **cURL-kommando**,
    **OpenAPI/Swagger-spesifikasjon**, **Postman-eksport**, **TypeScript-
    grensesnitt** eller **Zod-skjema** i feltet.
  </Step>

  <Step title="Klikk på Analyser">
    ThunderPhone utleder hele tilkoblingen fra det du limer inn — URL,
    metode, overskrifter og et parameterskjema basert på spørrings-
    parameterne og forespørselsbrødteksten den fant. Overskrifter du limte inn (inkludert
    autentiseringsoverskrifter) tas med i endepunktkonfigurasjonen.
  </Step>

  <Step title="Bekreft de uthevede feltene">
    Den utledede konfigurasjonen åpnes med de foreslåtte feltene uthevet
    for gjennomgang. Juster navn, beskrivelser og parametertyper slik at
    agenten forstår når og hvordan funksjonen skal kalles — beskrivelsen
    er det modellen leser.
  </Step>

  <Step title="Valider og lagre">
    Lagring kjører først en direktetestforespørsel mot endepunktet ditt. Hvis
    forespørselen mislykkes, lagres ikke tilkoblingen — rett opp URL-en, autentiserings-
    overskriftene eller brødteksten, og prøv igjen. Ved vellykket resultat lagres tilkoblingen
    med merket **Validert**.
  </Step>
</Steps>

Hvis veiviseren ikke finner en forespørsels-URL i det du limer inn, sier den ifra —
inkluder et fullstendig `http(s)`-endepunkt og prøv igjen.

## Manuelt oppsett

Klikk på **Sett opp manuelt →** i veiviseren (eller **Vil du at AI skal utlede dette?
Prøv veiviseren →** for å gå tilbake). Den manuelle byggeren har to redigeringsverktøy:

* **Visuell** — skjemafelt for visningsnavn, funksjonsnavn, forespørsels-
  **URL**, **metode** (`POST`, `GET`, `PUT`, `PATCH`, `DELETE`), egendefinerte
  **overskrifter** og parameterskjemaet (**Legg til egenskap** for hvert
  argument agenten kan oppgi).
* **JSON** — den samme definisjonen som rå JSON, for å lime inn eller finjustere
  en verktøyspesifikasjon direkte.

Et **Testforespørsel**-panel (valgfritt) lar deg sende den konfigurerte forespørselen
før lagring og viser status, forsinkelse og en forhåndsvisning av svaret.
**Valider og lagre** kjører alltid denne testen og lagrer bare ved vellykket resultat.

<Tip>
  Gi parametere beskrivelser på vanlig språk ("Kundens e-postadresse,
  f.eks. [jane@example.com](mailto:jane@example.com)"). Agenten velger argumenter ut fra disse
  beskrivelsene i sanntid, midt i samtalen.
</Tip>

## Administrer tilkoblingene dine

Hver tilkoblingsrad viser valideringsstatusen — **Validert**,
**Ikke testet** eller **Feil** — funksjonsnavnet og hvilke agenter som bruker den.
Fra radens handlingsmeny kan du:

* **Rediger** — åpne konfigurasjonen på nytt.
* **Klon** — duplisere den som et utgangspunkt (kopien starter som
  Ikke testet).
* **Revisjonshistorikk** — vis tidligere versjoner og gjenopprett en i
  redigeringsverktøyet.
* **Overfør** — kopier eller flytt tilkoblingen til en annen organisasjon du
  tilhører. Flytting fjerner den her; agenter som brukte den, kan trenge
  ny konfigurasjon.
* **Slett** — permanent; agenter som bruker tilkoblingen, må
  konfigureres på nytt.

## Koble den til en agent

Legg til tilkoblingen i en agent i byggerens seksjon for API-tilkoblinger
([Bygg en agent](/nb/guides/build-an-agent)). Listen viser hvilke agenter som
bruker hver tilkobling, slik at du umiddelbart ser hva en endring påvirker.

## Neste steg

<CardGroup cols={2}>
  <Card title="Verktøyintegrasjoner via API" icon="code" href="/nb/guides/build-tool-integration">
    Opprett og administrer de samme tilkoblingene programmatisk.
  </Card>

  <Card title="Koble til apper" icon="cable" href="/nb/guides/connect-apps">
    Ferdigbygde tilkoblinger for Google, Slack, HubSpot, Salesforce og Cal.com.
  </Card>

  <Card title="Legg til en MCP-server" icon="server" href="/nb/guides/mcp-servers">
    Gi agentene dine tilgang til en hel verktøyserver.
  </Card>

  <Card title="API-referanse for integrasjoner" icon="book" href="/api-reference/integrations">
    Alle felt i integrasjonsressursen.
  </Card>
</CardGroup>