Kernebegreber

Et overblik over alt på platformen — hvad hvert objekt gør, hvor det findes i dashboardet, og hvilket API der berører det.

ThunderPhone er en komplet platform til at bygge, drive og forbedre AI-stemmeagenter. Denne side er oversigten: hvert begreb, du møder, i et kort afsnit med dashboardfladen og API'et, der understøtter det. Skim den én gang, og vend tilbage, når et begreb skal forklares.

Dashboardets sidepanel afspejler denne struktur:

Organisationer#

En organisation er enheden for kontoadskillelse. Alle andre ressourcer — agenter, telefonnumre, opkald og nøgler — tilhører præcis én organisation. Din konto kan tilhøre mange organisationer; hver har sin egen saldo, sine egne nøgler og sin egen medlemsliste.

Den sk_live_ API-nøgle, du opretter under Organisation → Nøgler, er knyttet til én organisation. Denne tilknytning gør REST API'et så fladt: du angiver aldrig et organisations-id i URL-stier, fordi din nøgle allerede identificerer organisationen.

I dashboardet: organisationsskifteren (nederst i sidepanelet) og indstillingerne for Organisation — faner til Min konto, Generelt, Nøgler, Advarsler, Faktureringsindstillinger og Faktureringshistorik. Se referencen til organisationsindstillinger.

I API'et: /v1/orgs, /v1/developer/api-keys.

Agenter#

En agent er den AI-konfiguration, der håndterer et opkald. Den samler:

• En prompt, der styrer, hvad agenten siger, og hvordan den opfører sig — herunder opkaldshandlinger som viderestillinger, tastetryk og afslutning af opkald, som er almindelige promptlinjer i stedet for separat konfiguration.
• Et motorniveau (spark, bolt, storm-*): Spark er optimeret til omkostninger, Bolt til hastighed og Storm til intelligens ved komplekse prompter.
• En stemme samt et primært sprog og valgfri yderligere sprog — agenten skifter automatisk, når en opkalder skifter sprog. Se Understøttede sprog.
• Tilknyttede funktioner: forbundne apps, API-forbindelser, vidensbaser, MCP-servere og indlejrede funktionsværktøjer.
• Adfærdsindstillinger: talerækkefølge, bekræftelsestilstand, baggrundslyd, ventetidsgrænse.

Redigeringer i byggeren gemmes automatisk som en kladde; intet går live, før du klikker på Udrul. Hver udrulning gemmes som et øjebliksbillede på byggerens fane Historik, så du kan gennemse og gendanne enhver tidligere version.

I dashboardet: Stemmeagenter → agentbyggeren (/dashboard/agents). Se Byg din første stemmeagent.

I API'et: /v1/agents — CRUD, duplikering, overførsel, versionshistorik og prompthjælpere.

Stemmer#

Stemmebiblioteket indeholder de stemmer, en agent kan bruge, deres afspillelige eksempler, kompatible sprog, køns- og accentgrupperinger samt eventuelle tillæg for premiumstemmer eller -sprog. En betalt prøvegenerator kan syntetisere din egen sætning på 1–500 tegn, før du vælger.

Kvalificerede organisationer kan også oprette brugerdefinerede stemmer fra en kort WAV- eller MP3-prøve. Brugerdefinerede stemmer har en kvote og en asynkron oprettelsesstatus; når de er klar, vises de i den samme agentvælger som biblioteksstemmer.

I dashboardet: Stemmer (/dashboard/voices). Se Stemmebibliotek og brugerdefinerede stemmer.

I API'et: /v1/voices, stemmeprøver og brugerdefinerede stemmer.

Telefonnumre#

Et telefonnummer tilhører en organisation og sender indgående opkald til en agent (og kan håndtere udgående opkald). To kilder:

• ThunderPhone-numre — rigtige amerikanske numre, der klargøres fra ThunderPhones pulje og er aktive på få sekunder, $1/måned plus et tillæg på 1¢/minut. De starter kun med indgående opkald. En organisationsadministrator kan anmode om udgående opkald fra siden Telefonnummerer; ThunderPhone gennemgår hver anmodning manuelt, og godkendte numre kan foretage opkald og køre kampagner. En organisation kan som standard have 25.
• VoIP-numre — hentes fra din egen udbyder via en VoIP-forbindelse. Twilio og Telnyx forbindes direkte med en API-nøgle (Telnyx har også en guidet opsætning af ny konto); SignalWire, Vonage, Plivo og enhver anden SIP-trunk forbindes via SIP- opsætning, en manuel SIP-konfiguration. Når de er importeret og verificeret, understøtter VoIP- numre indgående og udgående opkald.

Hver nummerække lader dig angive en routningstilstand, vælge agenten for indgående opkald og navngive nummeret.

I dashboardet: Telefonnumre (/dashboard/phone-numbers). Se Få et telefonnummer.

I API'et: /v1/phone-numbers, /v1/voip-connections, /v1/phone-number-labels.

Opkald#

Hvert indgående opkald, udgående opkald, simulering og widgetsession bliver til en opkaldslog. Et opkald indeholder den fulde transskription med rollemærker, den strukturerede turhistorik (herunder værktøjskald), en optagelse, det samlede faktureringsbeløb samt valgfri AI-evaluering og problemrapporter.

Mens et opkald er live, kan du åbne det og lytte med — du deltager lydløst, og ingen i opkaldet kan høre dig. Når du lytter med, kan du hviske: skriv en instruktion, der sendes direkte til din agent midt i opkaldet; opkalderen hører den aldrig, og agenten følger den i realtid.

I dashboardet: Opkaldshistorik (/dashboard/call-history) for arkivet og detaljer om hvert opkald; Live for igangværende opkald. Se Gennemgå, lyt til og vejled dine opkald.

I API'et: /v1/calls — liste, transskription, historik, lyd, evaluering, eksport; /v1/issue-reports.

Kundeportaler#

En kundeportal er en brandet, skrivebeskyttet visning af opkaldshistorik for en ekstern kunde. Organisationsadministratorer vælger de agenter, hvis opkald vises, tilføjer godkendte seer-e-mails, uploader et logo og en accentfarve og kan valgfrit verificere et brugerdefineret domæne. Portalbrugere kan gennemgå opkaldsdetaljer, transskriptioner og tilgængelige optagelser uden at få adgang til dashboardet.

I dashboardet: Kundeportaler (/dashboard/client-portals). Se Kundeportaler.

I API'et: /v1/client-portals for administratorens administrationsområde.

Webwidgets#

Webwidgeten giver dine besøgende på websitet en mikrofonbaseret samtale med en agent — intet telefonnummer nødvendigt. Den godkender med en publicerbar nøgle (pk_live_...), som browsere kun kan bruge fra dine tilladte domæner, så den er sikker at bruge i klientkode. Domænelisten er ikke godkendelse, og de sessionsindstillinger, en side kan sende, er deaktiveret, indtil du tillader dem på nøglen.

Nøgler kører i en af to tilstande: agent (statisk knyttet til én agent) eller webhook (din server vælger konfigurationen pr. besøgende — se Dynamisk konfiguration pr. opkald). Widgetsessioner kører gennem den samme opkaldsinfrastruktur som telefonopkald.

I dashboardet: Webwidgets (/dashboard/web-widgets) — opret widgets, angiv tilstand og agent, administrer tilladte domæner, og kopiér indlejringskodestykket. Se Opret en webwidget.

I API'et: /v1/publishable-key, /v1/mic-session og Widget SDK-dokumentationen.

Vidensbaser#

En vidensbase er en samling dokumenter, som din agent kan søge i midt i et opkald for at understøtte sine svar — upload filer, indsæt tekst, eller importér websider via URL, og knyt derefter vidensbasen til en agent i byggeren. Agenten forespørger den med et indbygget søgeværktøj, når samtalen kræver det.

I dashboardet: Viden (/dashboard/knowledge) for dokumentbiblioteket; byggerens sektion Viden til at knytte en til en agent. Se Giv din agent en vidensbase.

Forbindelser#

Forbindelser er den måde, agenter når ud til omverdenen på. Fire typer, én sidebjælkegruppe:

• Apps (/dashboard/app-connections) — OAuth-forbindelser til Slack, HubSpot, Salesforce, Google Calendar, Google Sheets og Cal.com. Opret forbindelse én gang, og slå derefter værktøjer pr. handling til eller fra (send en Slack-besked, opret eller opdatér en HubSpot-kontakt, book et Cal.com-tidsrum…) for enhver agent. Se Forbind apps.
• API'er (/dashboard/api-connections) — gør ethvert HTTP API til en agenthandling. Indsæt en cURL-kommando, så udarbejder AI-guiden værktøjsdefinitionen, eller opbyg den manuelt; knappen Testanmodning sender et sandkasseopkald, før du udgiver. Se API-forbindelser — dashboardvisningen af /v1/integrations.
• MCP (/dashboard/mcp-connections) — tilføj en Model Context Protocol-server via URL, og lad agenten bruge de værktøjer, den stiller til rådighed. Se Tilføj en MCP-server.
• VoIP (/dashboard/voip-connections) — udbyderoplysninger til at bruge dine egne telefonnumre. Se Forbind en VoIP-udbyder.

ThunderPhone stiller også sit eget MCP-endpoint til rådighed, så en ekstern MCP-klient kan vise agenter, undersøge opkald og transskriptioner samt foretage opkald. Se Brug ThunderPhone som en MCP-server.

I API'et: /v1/integrations, /v1/mcp-servers og /v1/voip-connections; se også Byg en værktøjsintegration.

Kampagner#

En kampagne foretager udgående opkald i stor skala: upload en CSV med kontakter, vælg agent og afsendernummer, og angiv opkaldsvinduet (dage og timer med tidszone), samtidighed og genforsøgspolitik (maksimalt antal forsøg, og hvilke resultater — intet svar, telefonsvarer, mislykket — der forsøges igen). Kampagnen arbejder sig gennem listen og registrerer hvert opkald i Opkaldshistorik.

I dashboardet: Kampagner (/dashboard/campaigns). Se Kør en kampagne med udgående opkald.

Til enkeltstående programmatiske opkald: API'et til udgående opkald.

Liveovervågning#

Live viser alle igangværende opkald i organisationen og lader dig åbne ethvert af dem for at medlytte og hviske i realtid. Det er overvågningsfladen: Se en ny prompt få sin første reelle trafik, eller hold øje med en kørende kampagne.

I dashboardet: Live (/dashboard/live). Se Overvåg og superviser liveopkald.

Simulationer#

En simulation er en AI-opkalder, der har en reel samtale med din agent — samme telefoni-vej, reel transskription, reel bedømmelse — så du kan teste, før (og efter) du udgiver. Ret den mod en agent eller et telefonnummer, skriv selv opkalderens scenarie, eller generer scenarier med AI ud fra agentens prompt (inklusive kanttilfælde, hvis du beder om det), og følg opkaldet live.

Scenarier grupperes i suiter, der fastlægger en minimumsbeståelsesrate og kan styre udgivelser i CI; regressioner i forhold til den accepterede baseline rapporteres pr. scenarie.

I dashboardet: Simulationer (/dashboard/simulations) samt knappen Simulation i agentbyggeren. Se Simuler et opkald.

I API'et: /v1/test-calls og suitekøreren — se Test en agent fra ende til ende.

Valideringssæt#

Et valideringssæt omdanner reelle øjeblikke fra opkald til gentagelige regressionskontroller med én tur. Hvert eksempel fastfryser samtalekontekst, relevant opkalderlyd, det oprindelige svar og den forventede adfærd. Genafspilninger kører mod det aktuelle agentudkast uden at foretage endnu et opkald, og udgivelsesdialogen kan vise, om den seneste kørsel stadig matcher det udkast.

I dashboardet: Valideringssæt (/dashboard/validation) for organisationens datasæt og agentbyggerens fane Validering for kørsler. Se Valideringssæt.

I API'et: /v1/validation-sets og genafspilningsendepunkterne for agent/eksempel på samme referenceside.

Eksperimenter#

Et eksperiment A/B-tester agentkonfigurationer på live trafik: definer varianter (forskellige prompts, motorer eller indstillinger), fordel trafikken mellem dem, og sammenlign resultater pr. variant. Brug det i stedet for selv at opbygge bucket-logik i en webhook.

I dashboardet: Eksperimenter (/dashboard/experiments) og fanen A/B i agentbyggeren. Se Eksperimenter (A/B-test).

Problemer#

Et problem er et markeret problem på et bestemt opkald — indberettet af en menneskelig gennemser eller opdaget af AI-bedømmelse. Problemer indeholder alvorlighedsgrad, kilde og status, og siden Problemer er triagekøen: filtrer, undersøg det pågældende opkald, og følg rettelser.

I dashboardet: Problemer (/dashboard/issues) samt markering pr. opkald i Opkaldshistorik. Se Triage af problemer.

I API'et: /v1/issue-reports.

Rapporter#

En rapport besvarer et spørgsmål på naturligt sprog om dine opkaldsdata ("Hvad var de tre vigtigste grunde til, at opkaldere bad om et menneske i sidste uge?") med en AI-skrevet analyse, afgrænset til de agenter og det datointerval, du vælger.

I dashboardet: Rapporter (/dashboard/reports). Se Rapporter.

Observerbarhed#

Observerbarhed er metrikfladen: opkaldsvolumen, resultater og kvalitet over tid, som kan filtreres efter agent og tidsvindue, med eksport til efterfølgende analyse.

I dashboardet: Observerbarhed (/dashboard/observability). Se Observerbarhed.

Advarsler#

En advarselsregel overvåger en metrik (succesrate, fejlrate, gennemsnitlig score, opkaldsvolumen, suite-regressioner) over et tidsvindue og udløses, når den krydser din tærskel. Notifikationer sendes via e-mail og Slack og udløser en alert.triggered-hændelse til dine webhook-endepunkter.

I dashboardet: Organisation → Advarsler. Se Advarsler.

Webhooks#

ThunderPhone sender HTTP POST-webhooks til din server, når der sker noget under og efter et opkald. To leveringsmodeller:

• Webhook-endpoints (anbefalet): administrer mange URL'er på /v1/developer/webhook-endpoints med hemmeligheder og hændelsesabonnementer pr. endpoint.
• Ældre webhook med enkelt URL: én URL pr. organisation. Administreres på /v1/webhook eller under Organisation → Generelt. Beholdt for bagudkompatibilitet.

Hændelser er opdelt i to klasser:

• Blokerende hændelser forventer, at din server svarer med konfiguration, der former det igangværende opkald — de indgående opkaldshændelser (telephony.incoming / web.incoming). Et telefonopkald venter op til 13 sekunder, inklusive ét genforsøg, og en widgetsessions 10 sekunder. Der er ingen reserveagent: uden en brugbar konfiguration afsluttes telefonopkaldet, og widgetsessionen mislykkes.
• Ikke-blokerende hændelser er fire-and-forget-notifikationer, der genforsøges med eksponentiel backoff — se leveringssemantik.

Hver anmodning indeholder en tidsstemplet HMAC-SHA256-signatur i X-ThunderPhone-Signature-V2 samt den ældre kropsbaserede X-ThunderPhone-Signature. Se Signaturverificering.

Funktionsværktøjer#

Et funktionsværktøj er et HTTP-endpoint, som din agent kan kalde midt i en samtale. Du giver ThunderPhone et funktionsskema i OpenAI-stil samt en endpoint-URL; agenten beslutter, hvornår den skal kalde det, og ThunderPhone foretager den signerede HTTP-anmodning fra sine servere og sender resultatet tilbage til agenten.

Agenter har også indbyggede opkaldsfunktioner — overførsel af opkaldet, afsendelse af tastaturinput (DTMF), afslutning af opkaldet og venteposition — som du aktiverer med enkle promptlinjer i stedet for værktøjsdefinitioner.

I dashboardet: builderens sektion API-forbindelser (se Forbindelser).

I API'et: /v1/integrations og specifikationen for funktionsværktøjer.

Team og roller#

Hver organisation har en medlemsliste med to roller: Medlemmer bygger og driver agenter; Administratorer administrerer også teamet og fakturering. Inviter via e-mail — invitationer udløber efter 7 dage og kan tilbagekaldes; menuen ⋯ på en medlemsrække ændrer roller eller fjerner en person. Single sign-on kan konfigureres for hele organisationen — se SSO.

I dashboardet: Organisation → Generelt. Se Inviter dit team.

I API'et: /v1/members, /v1/invites.

Fakturering#

ThunderPhone er forudbetalt. Hver organisation har en saldo i USD; opkald trækker fra den efter agentens pris pr. minut (motorniveau plus tillæg — builderen viser den samlede pris i realtid, når du ændrer indstillinger, og udvalgte ekstra sprog tilføjer 3¢/min). Når saldoen når nul, afvises indgående opkald, og udgående opkald returnerer 402 Payment Required.

Fyld saldo på manuelt, eller aktivér automatisk optankning med en saldogrænse, et optankningsbeløb og en valgfri månedlig forbrugsgrænse — så et opkald aldrig afbrydes midt i en sætning.

I dashboardet: Organisation → Faktureringsindstillinger og Faktureringshistorik. Se Indsæt saldo og aktivér automatisk optankning samt den komplette prisoversigt.

I API'et: /v1/billing.

Copiloten i appen#

Dashboardet indeholder en indbygget copilot — spørg den "hvordan gør jeg X", så svarer den ud fra denne dokumentation, tilbyder trin-for-trin-gennemgange der fremhæver de faktiske kontroller, og kan afspille enhver af de guidede gennemgange igen. Det er den hurtigste måde at finde en kontrol, som denne side nævner. Se Spørg copiloten i appen.

Sådan hænger det sammen#