Skip to main content
ThunderPhone er en komplett plattform for å bygge, kjøre og forbedre AI-stemmeagenter. Denne siden er kartet: hvert konsept du møter, ett kort avsnitt om gangen, med dashboardflaten og API-et som ligger bak det. Skumles den én gang, og kom tilbake når et begrep trenger en forklaring. Sidefeltet i dashboardet gjenspeiler denne strukturen:

Organisasjoner

En organisasjon er enheten for tenant-isolering. Alle andre ressurser — agenter, telefonnumre, samtaler, nøkler — tilhører nøyaktig én organisasjon. Kontoen din kan tilhøre mange organisasjoner; hver har sin egen saldo, sine egne nøkler og sin egen medlemsliste. sk_live_-API-nøkkelen du oppretter under Organisasjon → Nøkler er knyttet til én organisasjon. Denne koblingen er det som gjør REST API-et så enkelt: Du legger aldri inn en organisasjons-ID i URL-stier, fordi nøkkelen din allerede identifiserer den. I dashboardet: organisasjonsvelgeren (nederst i sidefeltet) og innstillinger for Organisasjon — faner for Generelt, Nøkler, Varsler, Faktureringsinnstillinger og Faktureringshistorikk. I API-et: /v1/orgs, /v1/developer/api-keys.

Agenter

En agent er AI-konfigurasjonen som håndterer en samtale. Den samler:
  • En prompt som styrer hva agenten sier og hvordan den oppfører seg — inkludert samtalehandlinger som overføringer, tastetrykk og å legge på, som er vanlige promptlinjer i stedet for separat konfigurasjon.
  • Et motornivå (spark, bolt, storm-*): Spark er optimalisert for kostnad, Bolt for hastighet og Storm for intelligens ved komplekse prompter.
  • En stemme samt et primærspråk og valgfrie ekstra språk — agenten bytter automatisk når en innringer skifter språk. Se Støttede språk.
  • Tilknyttede funksjoner: tilkoblede apper, API-tilkoblinger, kunnskapsbaser, MCP-servere og innebygde funksjonsverktøy.
  • Atferdsinnstillinger: talerekkefølge, bekreftelsesmodus, bakgrunnsspor, ventetidsgrense.
Endringer i byggeren lagres automatisk i et utkast; ingenting blir aktivt før du klikker Distribuer. Hver distribusjon lagres som et øyeblikksbilde i byggerens fane Historikk, slik at du kan inspisere og gjenopprette enhver tidligere versjon. I dashboardet: Stemmeagenter → agentbyggeren (/dashboard/agents). Se Bygg din første stemmeagent. I API-et: /v1/agents — CRUD, duplisering, overføring, versjonshistorikk og prompthjelpere.

Telefonnumre

Et telefonnummer tilhører en organisasjon og ruter innkommende samtaler til en stemmeagent (og kan brukes til utgående samtaler). To kilder:
  • Demonumre — ekte amerikanske numre klargjort fra ThunderPhone sin pool, klare på sekunder. Kun innkommende samtaler, de svarer med en kort muntlig ansvarsfraskrivelse, og dashbordet begrenser en organisasjon til 10 av dem. Perfekt for en første test, men ikke for produksjon.
  • VoIP-numre — hentet inn fra din egen leverandør gjennom en VoIP-tilkobling. Twilio og Telnyx kobles til direkte (Telnyx har et veiledet oppsett); SignalWire og Vonage kommer snart — i dag kobler du til disse via manuell SIP-konfigurasjon, som godtar enhver SIP-trunk. Når de er importert og verifisert, støtter VoIP-numre både innkommende og utgående samtaler.
Hver nummerrad lar deg angi en rutemodus, velge stemmeagent for innkommende samtaler og merke nummeret. I dashbordet: Telefonnumre (/dashboard/phone-numbers). Se Skaff et telefonnummer. I API-et: /v1/phone-numbers, /v1/voip-connections, /v1/phone-number-labels.

Samtaler

Hver innkommende samtale, utgående samtale, simulering og widgetøkt blir til en samtalelogg. En samtale inneholder hele transkripsjonen med rollemerking, den strukturerte turhistorikken (inkludert verktøykall), et opptak, faktureringstotalen samt valgfri KI-vurdering og problemrapporter. Mens en samtale pågår, kan du åpne den og lytte med — du kobler deg til uten lyd, og ingen i samtalen hører deg. Når du lytter med, kan du hviske: skriv en instruksjon som går direkte til stemmeagenten midt i samtalen. Innringeren hører den aldri, og stemmeagenten følger den direkte. I dashbordet: Samtalehistorikk (/dashboard/call-history) for arkivet og detaljer per samtale; Direkte for pågående samtaler. Se Se gjennom, lytt til og veiled samtalene dine. I API-et: /v1/calls — liste, transkripsjon, historikk, lyd, vurdering, eksport; /v1/issue-reports.

Nettwidgeter

Nettwidgeten gir besøkende på nettstedet ditt en mikrofonbasert samtale med en stemmeagent — uten behov for telefonnummer. Den autentiserer med en publiserbar nøkkel (pk_live_...) som er låst til opprinnelsen for de tillatte domenene dine, så den er trygg å bruke i kode på klientsiden. Nøkler kjører i én av to moduser: agent (statisk bundet til én stemmeagent) eller webhook (serveren din velger konfigurasjonen per besøkende — se Dynamisk konfigurasjon per samtale). Widgetøkter går gjennom den samme samtaleinfrastrukturen som telefonsamtaler. I dashbordet: Nettwidgeter (/dashboard/web-widgets) — opprett widgeter, angi modus og stemmeagent, administrer tillatte domener og kopier innebyggingsutdraget. Se Opprett en nettwidget. I API-et: /v1/publishable-key, /v1/mic-session, og Widget SDK-dokumentasjonen.

Kunnskapsbaser

En kunnskapsbase er en samling dokumenter som stemmeagenten kan søke i midt i samtalen for å forankre svarene sine — last opp filer direkte eller importer fra Google Drive, og koble deretter kunnskapsbasen til en stemmeagent i byggeren. Stemmeagenten spør den med et innebygd søkeverktøy når samtalen krever det. I dashbordet: Kunnskap (/dashboard/knowledge) for dokumentbiblioteket; byggerens Kunnskap-seksjon for å koble en til en stemmeagent. Se Gi stemmeagenten din en kunnskapsbase.

Tilkoblinger

Tilkoblinger er hvordan agenter når omverdenen. Fire typer, én sidefeltgruppe:
  • Apper (/dashboard/app-connections) — OAuth-tilkoblinger til Slack, HubSpot, Salesforce, Google Calendar, Google Sheets og Cal.com. Koble til én gang, og slå deretter verktøy for hver operasjon (send en Slack-melding, oppdater eller opprett en HubSpot-kontakt, bestill et Cal.com-tidspunkt …) på for enhver agent. Se Koble til apper.
  • API-er (/dashboard/api-connections) — gjør et hvilket som helst HTTP API om til en agenthandling. Lim inn en cURL-kommando, så utarbeider AI-veiviseren verktøydefinisjonen, eller bygg den manuelt; knappen Test forespørsel utfører et sandkassekall før du lanserer. Se API-tilkoblinger — dashbordgrensesnittet til /v1/integrations.
  • MCP (/dashboard/mcp-connections) — legg til en Model Context Protocol-server via URL, og la agenten bruke verktøyene den tilbyr. Se Legg til en MCP-server.
  • VoIP (/dashboard/voip-connections) — leverandørlegitimasjon for å bruke dine egne telefonnumre. Se Koble til en VoIP-leverandør.
I API-et: /v1/integrations og /v1/voip-connections; se også Bygg en verktøyintegrasjon.

Kampanjer

En kampanje foretar utgående samtaler i stor skala: last opp en CSV-fil med kontakter, velg agenten og avsendernummeret, og angi ringevinduet (dager og timer, med tidssone), samtidighet og retningslinjer for nye forsøk (maksimalt antall forsøk og hvilke utfall — ikke svar, telefonsvarer, mislykket — som skal prøves på nytt). Kampanjen går gjennom listen og registrerer hver samtale i Samtalehistorikk. I dashbordet: Kampanjer (/dashboard/campaigns). Se Kjør en kampanje for utgående samtaler. For enkeltstående programmatisk utførte samtaler: API-et for utgående samtaler.

Sanntidsovervåking

Live viser alle pågående samtaler i hele organisasjonen, og lar deg åpne hvilken som helst av dem for å lytte med og hviske i sanntid. Det er overvåkingsflaten: følg med når en ny prompt får sin første reelle trafikk, eller hold øye med en aktiv kampanje. I dashbordet: Live (/dashboard/live). Se Se og overvåk samtaler i sanntid.

Simuleringer

En simulering er en AI-oppringer som har en ekte samtale med agenten din — samme telefoniflyt, ekte transkripsjon, ekte vurdering — slik at du kan teste før (og etter) du lanserer. Rett den mot en agent eller et telefonnummer, skriv oppringerscenarioet selv, eller generer scenarioer med AI fra agentens prompt (inkludert randtilfeller hvis du ber om det), og følg samtalen direkte. Scenarioer grupperes i suiter som fastsetter en minimumsrate for bestått og kan styre lanseringer i CI; regresjoner mot den godkjente grunnlinjen rapporteres per scenario. I dashbordet: Simuleringer (/dashboard/simulations), samt knappen Simulering i agentbyggeren. Se Simuler en samtale. I API-et: /v1/test-calls og suitekjøreren — se Test en agent fra ende til ende.

Eksperimenter

Et eksperiment A/B-tester agentkonfigurasjoner på direktetrafikk: definer varianter (ulike prompter, motorer eller innstillinger), fordel trafikken mellom dem, og sammenlign utfall per variant. Bruk det i stedet for å bygge bøttelogikk manuelt i en webhook. I dashbordet: Eksperimenter (/dashboard/experiments) og fanen A/B i agentbyggeren. Se Eksperimenter (A/B-testing).

Problemer

Et problem er et flagget problem i en bestemt samtale — rapportert av en menneskelig kontrollør eller oppdaget av KI-evaluering. Problemer har alvorlighetsgrad, kilde og status, og Problems-siden er triagekøen: filtrer, undersøk samtalen det gjelder, og følg opp rettinger. I dashbordet: Problemer (/dashboard/issues), samt flagging per samtale i samtalehistorikken. Se triagering av problemer. I API-et: /v1/issue-reports.

Rapporter

En rapport besvarer et spørsmål på naturlig språk om samtaledataene dine (“Hva var de tre vanligste grunnene til at innringere ba om et menneske forrige uke?”) med en KI-skrevet analyse, avgrenset til stemmeagentene og datointervallet du velger. I dashbordet: Rapporter (/dashboard/reports). Se Rapporter.

Observerbarhet

Observerbarhet er flaten for målinger: samtalevolum, utfall og kvalitet over tid, filtrerbart etter stemmeagent og tidsvindu, med eksport for videre analyse. I dashbordet: Observerbarhet (/dashboard/observability). Se Observerbarhet.

Varsler

En varslingsregel overvåker en måling (suksessrate, feilrate, gjennomsnittlig poengsum, samtalevolum, regresjoner i suiter) over et tidsvindu og utløses når den krysser terskelen din. Varsler sendes på e-post og Slack, og utløser en alert.triggered-hendelse til webhook-endepunktene dine. I dashbordet: Organisasjon → Varsler. Se Varsler.

Webhooks

ThunderPhone sender HTTP POST-webhooks til serveren din når ting skjer under og etter en samtale. To leveringsmodeller:
  • Webhook-endepunkter (anbefalt): administrer mange URL-er på /v1/developer/webhook-endpoints med hemmeligheter per endepunkt og hendelsesabonnementer per endepunkt.
  • Eldre webhook med én URL: én URL per organisasjon. Administreres på /v1/webhook eller under Organisasjon → Generelt. Beholdt for bakoverkompatibilitet.
Hendelser deles inn i to klasser:
  • Blokkerende hendelser forventer at serveren din svarer med konfigurasjon som former den pågående samtalen — hendelsene for innkommende samtaler (telephony.incoming / web.incoming). Du har opptil 10 sekunder på å svare; ved tidsavbrudd håndterer den statisk tilordnede stemmeagenten samtalen.
  • Ikke-blokkerende hendelser er varsler som sendes uten å vente på svar, og prøves på nytt med eksponentiell backoff — se leveringssemantikk.
Hver forespørsel har en HMAC-SHA256-signatur i X-ThunderPhone-Signature. Se signaturverifisering.

Funksjonsverktøy

Et funksjonsverktøy er et HTTP-endepunkt som stemmeagenten din kan kalle midt i en samtale. Du gir ThunderPhone et funksjonsskjema i OpenAI-stil samt en endepunkt-URL; stemmeagenten bestemmer når den skal kalle det, og ThunderPhone gjør den signerte HTTP-forespørselen fra sine servere og gir resultatet tilbake til stemmeagenten. Stemmeagenter leveres også med innebygde samtalefunksjoner — å overføre samtalen, sende tastaturinngang (DTMF), avslutte samtalen, vente på vent — som du aktiverer med vanlige promptlinjer i stedet for verktøydefinisjoner. I dashbordet: byggerens seksjon for API-tilkoblinger (se Tilkoblinger). I API-et: /v1/integrations og spesifikasjonen for Function Tools.

Team og roller

Hver organisasjon har en medlemsliste med to roller: Medlemmer bygger og drifter stemmeagenter; Administratorer administrerer også teamet og fakturering. Inviter via e-post — invitasjoner utløper etter 7 dager og kan trekkes tilbake; menyen ⋯ på en medlemsrad endrer roller eller fjerner noen. Enkel pålogging kan konfigureres for hele organisasjonen — se SSO. I dashbordet: Organisasjon → Generelt. Se Inviter teamet ditt. I API-et: /v1/members, /v1/invites.

Fakturering

ThunderPhone er forhåndsbetalt. Hver organisasjon har en saldo i USD; samtaler belaster den med agentens minuttpris (motornivå pluss tillegg — byggeren viser totalprisen fortløpende når du endrer innstillinger, og premiumsprog legger til 2¢/min). Når saldoen når null, avvises innkommende samtaler, og utgående samtaler returnerer 402 Payment Required. Fyll på manuelt, eller aktiver automatisk påfylling med en saldogrense, et påfyllingsbeløp og en valgfri månedlig forbruksgrense — slik at en samtale aldri avbrytes midt i en setning. I dashbordet: Organisasjon → Faktureringsinnstillinger og Faktureringshistorikk. Se Fyll på saldo og slå på automatisk påfylling. I API-et: /v1/billing.

Copiloten i appen

Dashbordet leveres med en innebygd copilot — spør den «hvordan gjør jeg X», så svarer den basert på denne dokumentasjonen, tilbyr trinnvise veiledninger som fremhever de faktiske kontrollene, og kan spille av alle de veiledede omvisningene på nytt. Det er den raskeste måten å finne en kontroll som denne siden nevner. Se Spør copiloten i appen.

Sett det hele sammen

Hurtigstart i dashbordet

Veiviseren i fem trinn: agent → fakturering → nummer → simulering → gjennomgang.

Hurtigstart for API

Det samme første anropet med fire REST-kall.

Bruke dashbordet

Bygg en agent, fyll på saldo, få et nummer, simuler og gjennomgå samtaler.

Koble til verktøy og data

OAuth-apper, egendefinerte API-er, MCP-servere og VoIP-leverandører.

Analyser og forbedre

Rapporter, observerbarhet, eksperimenter, problemer og varsler.

Team og konto

Invitasjoner og roller, API-nøkler, sikkerhet og SSO.

Oppskriftsbok for utviklere

API-oppskriftene: innkommende, utgående, dynamisk konfigurasjon, verktøy, testing.

Bekreft webhook-signaturer

Få HMAC-kontrollen riktig én gang, og gjenbruk den overalt.