Kärna
Engagemang
Liveövervakning och utgående
kampanjer.
Anslutningar
Appar, API:er, MCP-servrar och VoIP-leverantörer som dina
agenter kan använda.
Kvalitet och testning
Organisation
Händelsehantering
Webhooks och funktionsverktyg för
din egen kod.
Organisationer
En organisation är en tenant-enhet. Varje annan resurs — agenter, telefonnummer, samtal, nycklar — tillhör exakt en organisation. Ditt konto kan tillhöra flera organisationer; var och en har eget saldo, egna nycklar och en egen medlemslista. API-nyckelnsk_live_ som du skapar under Organisation → Nycklar är
bunden till en organisation. Den bindningen är det som gör REST API:et så
platt: du behöver aldrig ange ett organisations-id i URL-sökvägar, eftersom
din nyckel redan identifierar organisationen.
I dashboarden: organisationsväxlaren (längst ned i sidofältet) och
inställningarna för Organisation — flikar för Allmänt, Nycklar, Aviseringar, Faktureringsinställningar
och Faktureringshistorik.
I API:et: /v1/orgs,
/v1/developer/api-keys.
Agenter
En agent är AI-konfigurationen som hanterar ett samtal. Den omfattar:- En prompt som styr vad agenten säger och hur den beter sig — inklusive samtalsåtgärder som vidarekopplingar, knappsatsinmatningar och avslut av samtal, som är vanliga rader i prompten i stället för separat konfiguration.
- En motornivå (
spark,bolt,storm-*): Spark är optimerad för kostnad, Bolt för hastighet och Storm för intelligens i komplexa prompter. - En röst samt ett primärt språk och valfria ytterligare språk — agenten växlar automatiskt när en uppringare byter språk. Se Språk som stöds.
- Anslutna funktioner: anslutna appar, API-anslutningar, kunskapsbaser, MCP-servrar och integrerade funktionsverktyg.
- Beteendeinställningar: talordning, bekräftelseläge, bakgrundsspår, tidsgräns för vänteläge.
/dashboard/agents). Se
Bygg din första röstagent.
I API:et: /v1/agents — CRUD,
duplicering, överföring, versionshistorik och prompthjälpmedel.
Telefonnummer
Ett telefonnummer tillhör en organisation och dirigerar inkommande samtal till en agent (och kan användas för utgående samtal). Två källor:- Demonummer — riktiga amerikanska nummer som tillhandahålls från ThunderPhones pool och är aktiva på några sekunder. Endast inkommande samtal, de svarar med en kort talad ansvarsfriskrivning och instrumentpanelen begränsar en organisation till 10 av dem. Perfekt för ett första test, men inte för produktion.
- VoIP-nummer — tas med från din egen leverantör via en VoIP-anslutning. Twilio och Telnyx ansluts direkt (Telnyx har en guidad konfiguration); SignalWire och Vonage kommer snart — i dag når du dem via manuell SIP-konfiguration, som accepterar valfri SIP-trunk. När de har importerats och verifierats stöder VoIP-nummer både inkommande och utgående samtal.
/dashboard/phone-numbers).
Se Skaffa ett telefonnummer.
I API:et: /v1/phone-numbers,
/v1/voip-connections,
/v1/phone-number-labels.
Samtal
Varje inkommande samtal, utgående samtal, simulering och widgetsession blir en samtalslogg. Ett samtal innehåller hela den rollmärkta transkriptionen, den strukturerade turhistoriken (inklusive verktygsanrop), en inspelning, faktureringssumman samt valfri AI-betygsättning och felrapporter. När ett samtal är aktivt kan du öppna det och lyssna med — du ansluter tyst och ingen i samtalet hör dig. När du lyssnar med kan du viska: skriv en instruktion som skickas direkt till din agent mitt under samtalet; uppringaren hör den aldrig och agenten följer den direkt. I instrumentpanelen: Samtalshistorik (/dashboard/call-history) för
arkivet och information per samtal; Live för pågående samtal. Se
Granska, lyssna på och coacha dina samtal.
I API:et: /v1/calls — lista, transkription,
historik, ljud, betygsättning, export;
/v1/issue-reports.
Webbwidgetar
Webbwidgeten ger besökare på din webbplats ett mikrofonbaserat samtal med en agent — inget telefonnummer behövs. Den autentiserar med en publicerbar nyckel (pk_live_...) som är ursprungslåst till dina
tillåtna domäner, så den är säker att använda i klientkod.
Nycklar körs i ett av två lägen: agent (statiskt kopplad till en agent)
eller webhook (din server väljer konfiguration per besökare — se
Dynamisk konfiguration per samtal). Widget-
sessioner går via samma samtalsinfrastruktur som telefonsamtal.
I instrumentpanelen: Webbwidgetar (/dashboard/web-widgets) —
skapa widgetar, ange läge och agent, hantera tillåtna domäner och
kopiera inbäddningskodsnutten. Se
Skapa en webbwidget.
I API:et: /v1/publishable-key,
/v1/mic-session och
Widget SDK-dokumentationen.
Kunskapsbaser
En kunskapsbas är en uppsättning dokument som din agent kan söka i mitt under ett samtal för att förankra sina svar — ladda upp filer direkt eller importera från Google Drive och koppla sedan kunskapsbasen till en agent i byggaren. Agenten frågar den med ett inbyggt sökverktyg när samtalet kräver det. I instrumentpanelen: Kunskap (/dashboard/knowledge) för
dokumentbiblioteket; byggarens avsnitt Kunskap för att koppla en till
en agent. Se
Ge din agent en kunskapsbas.
Anslutningar
Anslutningar är hur agenter når omvärlden. Fyra typer, en sidofältsgrupp:- Appar (
/dashboard/app-connections) — OAuth-anslutningar till Slack, HubSpot, Salesforce, Google Calendar, Google Sheets och Cal.com. Anslut en gång och aktivera sedan verktyg per åtgärd (skicka ett Slack-meddelande, uppdatera eller skapa en HubSpot-kontakt, boka en Cal.com-tid…) för valfri agent. Se Anslut appar. - API:er (
/dashboard/api-connections) — gör valfritt HTTP-API till en agentåtgärd. Klistra in ett cURL-kommando så skapar AI-guiden ett utkast till verktygsdefinitionen, eller bygg den manuellt; knappen Testa begäran skickar ett sandlådeanrop innan du lanserar. Se API-anslutningar — dashboardvyn för/v1/integrations. - MCP (
/dashboard/mcp-connections) — lägg till en Model Context Protocol-server via URL och låt agenten använda verktygen som den exponerar. Se Lägg till en MCP-server. - VoIP (
/dashboard/voip-connections) — leverantörsuppgifter för att använda dina egna telefonnummer. Se Anslut en VoIP-leverantör.
/v1/integrations och
/v1/voip-connections; se även
Bygg en verktygsintegration.
Kampanjer
En kampanj genomför utgående samtal i stor skala: ladda upp en CSV-fil med kontakter, välj agent och utgående nummer och ange samtalsfönster (dagar och timmar, med hänsyn till tidszon), samtidighet och återuppringningspolicy (maximalt antal försök och vilka utfall — inget svar, röstbrevlåda, misslyckat — som ska försökas igen). Kampanjen arbetar sig igenom listan och registrerar varje samtal i Samtalshistorik. I dashboarden: Kampanjer (/dashboard/campaigns). Se
Kör en kampanj för utgående samtal.
För enstaka programmatiska samtal:
API:et för utgående samtal.
Liveövervakning
Live visar alla pågående samtal i organisationen och låter dig öppna valfritt samtal för att lyssna med och viska i realtid. Det är övervakningsytan: se en ny prompt ta emot sin första riktiga trafik eller håll koll på en pågående kampanj. I dashboarden: Live (/dashboard/live). Se
Övervaka och följ livesamtal.
Simuleringar
En simulering är en AI-uppringare som har ett verkligt samtal med din agent — samma telefoniväg, verklig transkription, verklig bedömning — så att du kan testa före (och efter) lansering. Rikta den mot en agent eller ett telefonnummer, skriv uppringarscenariot själv eller generera scenarier med AI från agentens prompt (inklusive kantfall om du ber om det) och följ samtalet live. Scenarier grupperas i sviter som låser en lägsta godkänd frekvens och kan styra releaser i CI; regressioner jämfört med den godkända baslinjen rapporteras per scenario. I dashboarden: Simuleringar (/dashboard/simulations), samt
knappen Simulering i agentbyggaren. Se
Simulera ett samtal.
I API:et: /v1/test-calls och
svitköraren — se Testa en agent från början till slut.
Experiment
Ett experiment A/B-testar agentkonfigurationer på live-trafik: definiera varianter (olika prompter, motorer eller inställningar), fördela trafiken mellan dem och jämför utfall per variant. Använd det i stället för att bygga egen bucketlogik i en webhook. I dashboarden: Experiment (/dashboard/experiments) och
fliken A/B i agentbyggaren. Se
Experiment (A/B-testning).
Problem
Ett problem är ett flaggat problem i ett specifikt samtal — rapporterat av en mänsklig granskare eller upptäckt av AI-bedömning. Problem har allvarlighetsgrad, källa och status, och sidan Problem är triagekön: filtrera, granska samtalet där problemet uppstod och följ upp åtgärder. I instrumentpanelen: Problem (/dashboard/issues), samt flaggning per samtal
i Samtalshistorik. Se Problemtriage.
I API:et: /v1/issue-reports.
Rapporter
En rapport besvarar en fråga på naturligt språk om dina samtalsdata (“Vilka var de tre vanligaste anledningarna till att uppringare bad om en människa förra veckan?”) med en AI-skriven analys, avgränsad till de agenter och det datumintervall du väljer. I instrumentpanelen: Rapporter (/dashboard/reports). Se
Rapporter.
Övervakning
Övervakning är vyn för mätvärden: samtalsvolym, utfall och kvalitet över tid, filtrerbart efter agent och tidsfönster, med export för vidare analys. I instrumentpanelen: Övervakning (/dashboard/observability).
Se Övervakning.
Aviseringar
En aviseringsregel övervakar ett mätvärde (framgångsgrad, felfrekvens, genomsnittligt poäng, samtalsvolym, svitregressioner) under ett tidsfönster och utlöses när det passerar ditt tröskelvärde. Aviseringar skickas till e-post och Slack och utlöser enalert.triggered-händelse till dina
webhook-slutpunkter.
I instrumentpanelen: Organisation → Aviseringar. Se
Aviseringar.
Webhooks
ThunderPhone skickar HTTP POST-webhooks till din server när saker händer under och efter ett samtal. Två leveransmodeller:- Webhook-slutpunkter (rekommenderas): hantera många URL:er på
/v1/developer/webhook-endpointsmed hemligheter per slutpunkt och händelseprenumerationer per slutpunkt. - Äldre webhook med en URL: en URL per organisation. Hanteras på
/v1/webhookeller under Organisation → Allmänt. Behålls för bakåtkompatibilitet.
- Blockerande händelser förväntar sig att din server svarar med konfiguration
som styr det pågående samtalet — inkommande samtalshändelser
(
telephony.incoming/web.incoming). Du har upp till 10 sekunder på dig att svara; vid tidsgräns hanterar den statiskt tilldelade agenten samtalet. - Icke-blockerande händelser är skicka-och-glöm-aviseringar, som försöks igen med exponentiell backoff — se leveranssemantik.
X-ThunderPhone-Signature. Se
Signaturverifiering.
Funktionsverktyg
Ett funktionsverktyg är en HTTP-slutpunkt som din agent kan anropa mitt i ett samtal. Du ger ThunderPhone ett funktionsschema i OpenAI-stil plus en slutpunkts-URL; agenten avgör när den ska anropas, och ThunderPhone gör den signerade HTTP-begäran från sina servrar och skickar resultatet tillbaka till agenten. Agenter har också inbyggda samtalsfunktioner — överföra samtalet, skicka knappsatsinmatning (DTMF), avsluta samtalet, vänta i kö — som du aktiverar med vanliga promptrader i stället för verktygsdefinitioner. I instrumentpanelen: avsnittet API-anslutningar i byggaren (se Anslutningar). I API:et:/v1/integrations och
specifikationen för Funktionsverktyg.
Team och roller
Varje organisation har en medlemslista med två roller: Medlemmar bygger och driver agenter; Administratörer hanterar även teamet och fakturering. Bjud in via e-post — inbjudningar upphör efter 7 dagar och kan återkallas; menyn ⋯ på en medlemsrad ändrar roller eller tar bort någon. Enkel inloggning kan konfigureras för hela organisationen — se SSO. I instrumentpanelen: Organisation → Allmänt. Se Bjud in ditt team. I API:et:/v1/members,
/v1/invites.
Fakturering
ThunderPhone är förbetalt. Varje organisation har ett saldo i USD; samtal debiterar det enligt röstagentens minutpris (motornivå plus tilläggsavgifter — byggaren visar totalpriset i realtid när du ändrar inställningar, och premiumspråk lägger till 2 ¢/min). När saldot når noll avvisas inkommande samtal och utgående samtal returnerar402 Payment Required.
Fyll på manuellt, eller aktivera automatisk påfyllning med en
saldogräns, ett påfyllningsbelopp och en valfri månatlig utgiftsgräns —
så att ett samtal aldrig bryts mitt i en mening.
I dashboarden: Organisation → Faktureringsinställningar och
Faktureringshistorik. Se
Fyll på saldo och aktivera automatisk påfyllning.
I API:t: /v1/billing.
Copiloten i appen
Dashboarden har en inbyggd copilot — fråga den “hur gör jag X” så svarar den utifrån den här dokumentationen, erbjuder klick-för-klick-rundturer som lyfter fram de faktiska reglagen och kan spela upp valfria av de guidade rundturerna igen. Det är det snabbaste sättet att hitta ett reglage som den här sidan nämner. Se Fråga copiloten i appen.Så hänger allt ihop
Snabbstart i dashboarden
Femstegsguiden: röstagent → fakturering → nummer → simulering → granskning.
Snabbstart för API:t
Samma första samtal med fyra REST-anrop.
Använda dashboarden
Skapa en röstagent, fyll på saldo, skaffa ett nummer, simulera och granska samtal.
Anslut verktyg och data
OAuth-appar, anpassade API:er, MCP-servrar och VoIP-leverantörer.
Analysera och förbättra
Rapporter, observerbarhet, experiment, problem och aviseringar.
Team och konto
Inbjudningar och roller, API-nycklar, säkerhet och SSO.
Receptbok för utvecklare
API-recepten: inkommande, utgående, dynamisk konfiguration, verktyg, testning.
Verifiera webhook-signaturer
Gör HMAC-kontrollen rätt en gång och återanvänd den överallt.