--- title: "API-anslutningar" description: "Gör valfritt HTTP-API till en funktion som din agent kan anropa mitt i ett samtal: klistra in ett cURL-kommando så skapar guiden verktygsdefinitionen, parametrarna och autentiseringen." --- API-anslutningar är anpassade HTTP-funktioner som dina röstagenter 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`); röstagenter som har anslutningen kopplad 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 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. ThunderPhone härleder hela anslutningen från det du klistrar in — URL, metod, headers och ett parameterschema baserat på frågeparametrarna och begärandetexten som hittades. Headers som du klistrade in (inklusive autentiseringsheaders) förs över till slutpunktskonfigurationen. Den härledda konfigurationen öppnas med de gissade fälten markerade för granskning. Justera namn, beskrivningar och parametertyper så att röstagenten förstår när och hur funktionen ska anropas — beskrivningen är vad modellen läser. När du sparar körs först en live-testbegäran mot din slutpunkt. Om begäran misslyckas sparas inte anslutningen — åtgärda URL:en, autentiseringsheaders eller begärandetexten och försök igen. Vid lyckat resultat lagras anslutningen med märket **Validerad**. Om guiden inte hittar någon URL för en begäran 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, begärans **URL**, **metod** (`POST`, `GET`, `PUT`, `PATCH`, `DELETE`), anpassade **headers** och parameterschemat (**Lägg till egenskap** för varje argument som röstagenten kan ange). - **JSON** — samma definition som rå JSON, för att klistra in eller finjustera en verktygsspecifikation direkt. En panel för **Testbegäran** (valfri) låter dig skicka den konfigurerade begäran innan du sparar och visar status, latens och en förhandsgranskning av svaret. **Validera och spara** kör alltid detta test och sparar endast vid lyckat resultat. Rubrikvärden kan bara skrivas. När de har sparats krypteras de och visas aldrig igen, varken i instrumentpanelen eller API:t. När du redigerar en anslutning visar en sparad rubrik sitt namn med punkter i stället för värdet och en notis med **Sparat**: låt den vara för att behålla det sparade värdet, eller skriv ett nytt för att ersätta det. Test- begäranden och aktiva samtal använder det sparade värdet. **Klona** kopierar sparade värden till den nya anslutningen. Ge parametrarna beskrivningar på vanlig svenska ("Kundens e-postadress, t.ex. jane@example.com"). Röstagenten väljer argument från dessa beskrivningar i realtid, mitt under samtalet. ## Hantera dina anslutningar Varje anslutningsrad visar valideringsstatus — **Validerad**, **Otestad** eller **Fel** — dess funktionsnamn och vilka röstagenter 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; röstagenter som använde den kan behöva konfigureras om. - **Ta bort** — permanent; röstagenter som använder anslutningen behöver konfigureras om. ## Koppla den till en röstagent Lägg till anslutningen till en röstagent i byggarens avsnitt för API-anslutningar ([Bygg en röstagent](/sv/guides/build-an-agent)). Listan visar vilka röstagenter som använder varje anslutning, så att du direkt kan se vad en ändring påverkar. ## Nästa steg Skapa och hantera samma anslutningar programmatiskt. Förbyggda anslutningar för Google, Slack, HubSpot, Salesforce och Cal.com. Exponera en hel verktygsserver för dina agenter. Alla fält i integrationsresursen.