Connect tools & data

API-anslutningar

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#

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

2. Klicka på Analysera

   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.

3. 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 röstagenten förstår när och hur funktionen ska anropas — beskrivningen är vad modellen läser.

4. Validera och spara

   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.

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). Listan visar vilka röstagenter som använder varje anslutning, så att du direkt kan se vad en ändring påverkar.

Nästa steg#