Getting Started

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 kortet: alle de begreber, du møder, ét kort afsnit om hver, med dashboardgrænsefladen og API'et, der understøtter dem. Skim den én gang, og vend derefter tilbage, når et begreb skal forklares.

Dashboardets sidepanel afspejler denne struktur:

Organisationer#

En organisation er enheden for tenantadministration. Alle andre ressourcer — agenter, telefonnumre, opkald, 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 bundet til én organisation. Denne binding gør REST API'et så enkelt: Du angiver aldrig et org-id i URL-stier, fordi din nøgle allerede identificerer organisationen.

I dashboardet: organisationsvælgeren (nederst i sidepanelet) og indstillingerne for Organisation — faner for Min konto, Generelt, Nøgler, Advarsler, Faktureringsindstillinger og Faktureringshistorik. Se referencen for 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 frem for separat konfiguration.
• Et motorniveau (spark, bolt, storm-*): Spark er optimeret til omkostninger, Bolt til hastighed og Storm til intelligens ved komplekse prompts.
• 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 indbyggede funktionsværktøjer.
• Adfærdsindstillinger: talerækkefølge, bekræftelsestilstand, baggrundsspor, timeout for venteposition.

Redigeringer i byggeværktøjet gemmes automatisk i en kladde; intet bliver udgivet, før du klikker på Udrul. Hver udrulning gemmes som et øjebliksbillede i byggeværktøjets fane Historik, så du kan gennemse og gendanne enhver tidligere version.

I dashboardet: Stemmeagenter → agentbyggeværktøjet (/dashboard/agents). Se Byg din første stemmeagent.

I API'et: /v1/agents — CRUD, duplikering, overførsel, versionshistorik og prompt-hjælpefunktioner.

Stemmer#

Stemmebiblioteket indeholder de stemmer, en agent kan bruge, deres afspilbare eksempler, kompatible sprog, køns- og accentgrupperinger samt eventuelle tillæg for premiumstemmer/-sprog. Med en betalt prøvefunktion kan du syntetisere din egen frase på 1–500 tegn, før du vælger.

Kvalificerede organisationer kan også oprette brugerdefinerede stemmer ud 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 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 dirigerer indgående opkald til en agent (og kan håndtere udgående opkald). To kilder:

• Demonumre — rigtige amerikanske numre fra ThunderPhones pulje, klar på få sekunder. Kun indgående opkald, de svarer med en kort mundtlig ansvarsfraskrivelse, og dashboardet begrænser en organisation til 10 af dem. Perfekt til en første test, men ikke til produktion.
• VoIP-numre — hentet fra din egen udbyder via en VoIP-forbindelse. Twilio og Telnyx forbindes direkte (Telnyx har en guidet opsætning); SignalWire og Vonage kommer snart — i dag kan du nå dem via manuel SIP-konfiguration, som accepterer enhver SIP-trunk. Når de er importeret og verificeret, understøtter VoIP-numre både indgående og udgående opkald.

Hver nummerrække giver dig mulighed for at 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 rolletags, den strukturerede historik over samtaleskift (herunder værktøjskald), en optagelse, det samlede faktureringsbeløb samt valgfri AI-vurdering og problemrapporter.

Mens et opkald er aktivt, 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 går direkte til din agent midt i opkaldet; opkalderen hører den aldrig, og agenten følger den med det samme.

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

I API'et: /v1/calls — liste, transskription, historik, lyd, vurdering, 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 e-mailadresser til visningsbrugere, uploader et logo og en accentfarve og verificerer eventuelt 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 administrationsområdet.

Webwidgets#

En webwidget giver dine besøgende på webstedet en mikrofonbaseret samtale med en agent — intet telefonnummer nødvendigt. Den godkendes med en offentlig nøgle (pk_live_...), der er låst til oprindelsen for dine tilladte domæner, så den er sikker at bruge i klientsidekode.

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 går 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 indlejringsudsnittet. Se Opret en webwidget.

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

Vidensbaser#

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

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

Forbindelser#

Forbindelser er, hvordan agenter når omverdenen. Fire typer, én gruppe i sidepanelet:

• Apps (/dashboard/app-connections) — OAuth-forbindelser til Slack, HubSpot, Salesforce, Google Calendar, Google Sheets og Cal.com. Forbind én gang, og aktivér derefter værktøjer pr. handling (send en Slack-besked, opret eller opdatér en HubSpot-kontakt, book et Cal.com-tidspunkt…) for enhver agent. Se Forbind apps.
• API'er (/dashboard/api-connections) — gør ethvert HTTP API til en agenthandling. Indsæt en cURL-kommando, og AI-guiden opretter et udkast til værktøjsdefinitionen, eller byg den manuelt; en knap til Testanmodning udfører et sandkasseopkald, før du lancerer. Se API-forbindelser — dashboardets grænseflade til /v1/integrations.
• MCP (/dashboard/mcp-connections) — tilføj en Model Context Protocol-server via URL, og lad agenten bruge de værktøjer, den eksponerer. Se Tilføj en MCP-server.
• VoIP (/dashboard/voip-connections) — udbyderlegitimationsoplysninger til at bruge dine egne telefonnumre. Se Forbind en VoIP-udbyder.

ThunderPhone eksponerer også sit eget MCP-endpoint, så en ekstern MCP-klient kan vise agenter, inspicere 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 genopkaldspolitik (maksimalt antal forsøg, og hvilke udfald — intet svar, telefonsvarer, mislykket — der forsøges igen). Kampagnen gennemgår 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 på tværs af organisationen og lader dig åbne ethvert af dem for at lytte med og hviske i realtid. Det er overvågningsfladen: se en ny prompt få sin første reelle trafik, eller hold øje med en igangværende kampagne.

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

Simuleringer#

En simulering er en AI-opkalder, der har en reel samtale med din agent — samme telefoniforløb, reel transskription, reel evaluering — så du kan teste, før (og efter) du udruller. Knyt den til en agent eller et telefonnummer, skriv selv opkalderens scenarie, eller generer scenarier med AI ud fra agentens prompt (inklusive grænsetilfælde, hvis du beder om det), og følg opkaldet live.

Scenarier grupperes i testuiter, der fastsætter en minimumsbeståelsesrate og kan blokere udrulninger i CI; regressioner i forhold til den godkendte reference rapporteres pr. scenarie.

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

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

Valideringssæt#

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

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

I API'et: /v1/validation-sets og endepunkterne til genafspilning af agent/eksempel på samme referenceside.

Eksperimenter#

Et eksperiment A/B-tester agentkonfigurationer på live trafik: definér varianter (forskellige prompts, motorer eller indstillinger), fordel trafikken mellem dem, og sammenlign resultater pr. variant. Brug det i stedet for selv at implementere 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 — oprettet af en menneskelig gennemgår eller registreret af AI-evaluering. Problemer indeholder alvorlighedsgrad, kilde og status, og siden Problemer er triageringskøen: filtrér, undersøg det problematiske opkald, og følg rettelser.

I dashboardet: Problemer (/dashboard/issues) samt markering pr. opkald i Opkaldshistorik. Se Triagering 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 primære grunde til, at personer, der ringede, 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 metricsoverfladen: opkaldsvolumen, resultater og kvalitet over tid, filtrerbart 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, fejlfrekvens, gennemsnitlig score, opkaldsvolumen, regressioner i testsuiter) over et tidsvindue og udløses, når den krydser din tærskel. Notifikationer sendes til e-mail og Slack, og reglen udløser en alert.triggered-hændelse til dine webhookendepunkter.

I dashboardet: Organisation → Advarsler. Se Advarsler.

Webhooks#

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

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

Hændelser opdeles i to klasser:

• Blokerende hændelser forventer, at din server svarer med konfiguration, der former det igangværende opkald — indgående opkaldshændelser (telephony.incoming / web.incoming). Du har op til 10 sekunder til at svare; ved timeout håndterer den statisk tildelte agent opkaldet.
• Ikke-blokerende hændelser er fire-and-forget-notifikationer, der prøves igen med eksponentiel backoff — se leveringssemantik.

Hver anmodning indeholder en HMAC-SHA256-signatur i X-ThunderPhone-Signature. Se signaturverifikation.

Funktionsværktøjer#

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

Agenter leveres også med indbyggede opkaldsfunktioner — viderestilling af opkaldet, afsendelse af tastaturinput (DTMF), afslutning af opkaldet og venten på hold — 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 til agentens pris pr. minut (motorniveau plus tillæg — builderen viser den samlede pris løbende, 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.

Indbetal manuelt, eller aktivér automatisk optankning med en saldogrænse, et genopfyldningsbelø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 midler og aktivér automatisk optankning samt den komplette prisoversigt.

I API'et: /v1/billing.

Copiloten i appen#

Dashboardet leveres med 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 kontrolelementer, og kan afspille enhver af de vejledte ture igen. Det er den hurtigste måde at finde et kontrolelement, som denne side nævner. Se Spørg copiloten i appen.

Sæt det hele sammen#