Connect tools & data

API-tilkoblinger

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#

1. Klikk på Ny API-tilkobling

   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.

2. Klikk på Analyser

   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.

3. Bekreft de uthevede feltene

   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.

4. Valider og lagre

   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.

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). Listen viser hvilke stemmeagenter som bruker hver tilkobling, slik at du raskt kan se hva en endring påvirker.

Neste steg#