--- title: "API-tilkoblinger" description: "Gjør et hvilket som helst HTTP-API om til en funksjon agenten din kan kalle opp midt i en samtale: lim inn en cURL-kommando, så bygger veiviseren verktøydefinisjonen, parameterne og autentiseringen." --- API-tilkoblinger er egendefinerte HTTP-funksjoner som stemmeagentene dine kan kalle under en samtale — slå opp en ordre, opprette en sak eller hente kontostatus fra din egen backend. Du definerer endepunktet én gang under **Tilkoblinger → API-er** (`/dashboard/api-connections`); stemmeagenter som har tilkoblingen knyttet til seg, 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 metoden: lim inn og analyser Dialogboksen åpnes i veiviseren. Lim inn en eksempelkommando med **cURL**, en **OpenAPI/Swagger-spesifikasjon**, en **Postman-eksport**, et **TypeScript- grensesnitt** eller et **Zod-skjema** i feltet. ThunderPhone utleder hele tilkoblingen fra det du limer inn — URL, metode, headere og et parameterskjema basert på spørringsparameterne og forespørselsinnholdet den finner. Headere du limte inn (inkludert autentiseringsheadere) blir lagt til i endepunktkonfigurasjonen. Den utledede konfigurasjonen åpnes med de antatte feltene uthevet for gjennomgang. Juster navn, beskrivelser og parametertyper slik at stemmeagenten forstår når og hvordan funksjonen skal kalles — beskrivelsen er det modellen leser. Lagring kjører først en direkte testforespørsel mot endepunktet ditt. Hvis forespørselen mislykkes, lagres ikke tilkoblingen — korriger URL-en, autentiseringsheaderne eller innholdet, og prøv igjen. Ved suksess lagres tilkoblingen med merket **Validert**. 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 **headere** og parameterskjemaet (**Legg til egenskap** for hvert argument stemmeagenten kan oppgi). - **JSON** — den samme definisjonen som ren JSON, for å lime inn eller finjustere en verktøyspesifikasjon direkte. Et panel for **Testforespørsel** (valgfritt) lar deg sende den konfigurerte forespørselen før du lagrer, og viser status, responstid og en forhåndsvisning av svaret. **Valider og lagre** kjører alltid denne testen og lagrer bare ved suksess. Headerverdier kan bare skrives. Når de er lagret, krypteres de og vises aldri igjen, verken i dashbordet eller API-et. Når du redigerer en tilkobling, viser en lagret header navnet sitt med prikker i stedet for verdien og en **Lagret**-merknad: La den stå som den er for å beholde den lagrede verdien, eller skriv inn en ny for å erstatte den. Testforespørsler og aktive samtaler bruker den lagrede verdien. **Klon** kopierer lagrede verdier til den nye tilkoblingen. Gi parametere beskrivelser på vanlig språk ("Kundens e-postadresse, f.eks. jane@example.com"). Stemmeagenten velger argumenter fra disse beskrivelsene i sanntid, midt i samtalen. ## Administrer tilkoblingene dine Hver tilkoblingsrad viser valideringsstatusen — **Validert**, **Ikke testet** eller **Feil** — funksjonsnavnet og hvilke stemmeagenter 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** — se tidligere versjoner og gjenopprett en i redigeringsverktøyet. - **Overfør** — kopier eller flytt tilkoblingen til en annen organisasjon du tilhører. Ved flytting fjernes den her; stemmeagenter som brukte den, kan trenge ny konfigurasjon. - **Slett** — permanent; stemmeagenter som bruker tilkoblingen, må konfigureres på nytt. ## Knytt den til en stemmeagent Legg til tilkoblingen i en stemmeagent i byggerens seksjon for API-tilkoblinger ([Bygg en stemmeagent](/nb/guides/build-an-agent)). Listen viser hvilke stemmeagenter som bruker hver tilkobling, slik at du raskt kan se hva en endring påvirker. ## Neste steg Opprett og administrer de samme tilkoblingene programmatisk. Ferdigbygde tilkoblinger for Google, Slack, HubSpot, Salesforce og Cal.com. Gi agentene dine tilgang til en hel verktøyserver. Alle feltene i integrasjonsressursen.