Interaktion
Live-Überwachung und ausgehende
Kampagnen.
Verbindungen
Apps, APIs, MCP-Server und VoIP-Anbieter, die Ihre
Agenten verwenden können.
Qualität & Tests
Organisation
Ereignisse
Webhooks und Funktions-Tools für
Ihren eigenen Code.
Organisationen
Eine Organisation ist die Mandanteneinheit. Jede andere Ressource — Agenten, Telefonnummern, Anrufe, Schlüssel — gehört genau einer Organisation. Ihr Konto kann mehreren Organisationen angehören; jede hat ihr eigenes Guthaben, ihre eigenen Schlüssel und ihre eigene Mitgliederliste. Dersk_live_-API-Schlüssel, den Sie unter Organisation → Schlüssel erstellen, ist
an eine Organisation gebunden. Diese Bindung macht die REST-API so
flach: Sie geben nie eine Organisations-ID in URL-Pfaden an, weil Ihr Schlüssel sie bereits
identifiziert.
Im Dashboard: der Organisationswechsler (im Fußbereich der Seitenleiste) und
die Einstellungen unter Organisation — Registerkarten für Allgemein, Schlüssel, Benachrichtigungen,
Abrechnungseinstellungen und Abrechnungsverlauf.
In der API: /v1/orgs,
/v1/developer/api-keys.
Agenten
Ein Agent ist die KI-Konfiguration, die einen Anruf ausführt. Sie umfasst:- Einen Prompt, der bestimmt, was der Agent sagt und wie er sich verhält — einschließlich Anrufaktionen wie Weiterleitungen, Tastendrücken und Auflegen, die einfache Prompt-Zeilen und keine separate Konfiguration sind.
- Eine Engine-Stufe (
spark,bolt,storm-*): Spark ist für Kosten optimiert, Bolt für Geschwindigkeit und Storm für Intelligenz bei komplexen Prompts. - Eine Stimme sowie eine primäre Sprache und optionale zusätzliche Sprachen — der Agent wechselt automatisch, wenn ein Anrufer die Sprache wechselt. Siehe Unterstützte Sprachen.
- Zugeordnete Funktionen: verbundene Apps, API-Verbindungen, Wissensdatenbanken, MCP-Server und eingebundene Funktions-Tools.
- Verhaltensoptionen: Sprechreihenfolge, Bestätigungsmodus, Hintergrundspur, Wartezeitlimit.
/dashboard/agents). Siehe
Erstellen Sie Ihren ersten Sprachagenten.
In der API: /v1/agents — CRUD,
duplizieren, weiterleiten, Versionsverlauf und Prompt-Hilfsfunktionen.
Telefonnummern
Eine Telefonnummer gehört zu einer Organisation und leitet eingehende Anrufe an einen Agenten weiter (und kann für ausgehende Anrufe verwendet werden). Zwei Quellen:- Demo-Nummern — echte US-Telefonnummern aus dem ThunderPhone-Pool, in Sekundenschnelle aktiv. Nur für eingehende Anrufe, sie melden sich mit einem kurzen gesprochenen Hinweis, und das Dashboard begrenzt eine Organisation auf 10 davon. Perfekt für einen ersten Test, nicht für die Produktion.
- VoIP-Nummern — über eine eigene VoIP-Verbindung von Ihrem Anbieter eingebracht. Twilio und Telnyx lassen sich direkt verbinden (Telnyx bietet eine geführte Einrichtung); SignalWire und Vonage folgen demnächst — derzeit erreichen Sie sie über eine manuelle SIP-Konfiguration, die jeden SIP-Trunk akzeptiert. Nach dem Import und der Verifizierung unterstützen VoIP-Nummern eingehende und ausgehende Anrufe.
/dashboard/phone-numbers).
Siehe Telefonnummer erhalten.
In der API: /v1/phone-numbers,
/v1/voip-connections,
/v1/phone-number-labels.
Anrufe
Jeder eingehende Anruf, ausgehende Anruf, jede Simulation und jede Widget-Sitzung wird zu einem Anrufprotokoll. Ein Anruf enthält das vollständige mit Rollen versehene Transkript, den strukturierten Verlauf der Gesprächszüge (einschließlich Tool-Aufrufen), eine Aufzeichnung, die Gesamtabrechnung sowie optionale KI-Bewertungen und Problemberichte. Während ein Anruf live ist, können Sie ihn öffnen und mithören — Sie nehmen lautlos teil, und niemand im Anruf hört Sie. Sobald Sie mithören, können Sie zuflüstern: Geben Sie eine Anweisung ein, die direkt während des Anrufs an Ihren Agenten gesendet wird; der Anrufer hört sie nie, und der Agent befolgt sie live. Im Dashboard: Anrufverlauf (/dashboard/call-history) für
das Archiv und Details zu einzelnen Anrufen; Live für laufende Anrufe. Siehe
Anrufe prüfen, mithören und coachen.
In der API: /v1/calls — Liste, Transkript,
Verlauf, Audio, Bewertung, Export;
/v1/issue-reports.
Web-Widgets
Das Web-Widget ermöglicht Ihren Website-Besuchern eine mikrofonbasierte Unterhaltung mit einem Agenten — keine Telefonnummer erforderlich. Es authentifiziert sich mit einem veröffentlichbaren Schlüssel (pk_live_...), der an Ihre
zulässigen Domains gebunden ist und daher sicher in clientseitigem Code verwendet werden kann.
Schlüssel werden in einem von zwei Modi verwendet: agent (statisch an einen Agenten gebunden)
oder webhook (Ihr Server wählt die Konfiguration pro Besucher — siehe
Dynamische Konfiguration pro Anruf). Widget-Sitzungen
laufen über dieselbe Anrufinfrastruktur wie Telefonanrufe.
Im Dashboard: Web-Widgets (/dashboard/web-widgets) —
erstellen Sie Widgets, legen Sie Modus und Agenten fest, verwalten Sie zulässige Domains und
kopieren Sie das Einbettungs-Snippet. Siehe
Web-Widget erstellen.
In der API: /v1/publishable-key,
/v1/mic-session und die
Widget-SDK-Dokumentation.
Wissensdatenbanken
Eine Wissensdatenbank ist eine Sammlung von Dokumenten, die Ihr Agent während eines Anrufs durchsuchen kann, um seine Antworten zu fundieren — laden Sie Dateien direkt hoch oder importieren Sie sie aus Google Drive und fügen Sie die Wissensdatenbank dann im Builder einem Agenten hinzu. Der Agent fragt sie mit einem integrierten Such-Tool ab, wenn die Unterhaltung es erfordert. Im Dashboard: Wissen (/dashboard/knowledge) für die
Dokumentbibliothek; der Bereich Wissen im Builder, um sie einem
Agenten hinzuzufügen. Siehe
Geben Sie Ihrem Agenten eine Wissensdatenbank.
Verbindungen
Verbindungen ermöglichen Agenten den Zugriff auf die Außenwelt. Vier Arten, eine Seitenleistengruppe:- Apps (
/dashboard/app-connections) — OAuth-Verbindungen zu Slack, HubSpot, Salesforce, Google Calendar, Google Sheets und Cal.com. Einmal verbinden und dann Tools für einzelne Vorgänge (eine Slack-Nachricht senden, einen HubSpot-Kontakt aktualisieren oder erstellen, einen Cal.com-Termin buchen …) für jeden Agenten aktivieren. Siehe Apps verbinden. - APIs (
/dashboard/api-connections) — jede HTTP-API in eine Agentenaktion verwandeln. Fügen Sie einen cURL-Befehl ein, und der KI-Assistent erstellt einen Entwurf für die Tool-Definition, oder erstellen Sie sie manuell; die Schaltfläche Anfrage testen führt vor der Veröffentlichung einen Sandbox-Aufruf aus. Siehe API-Verbindungen — die Dashboard-Oberfläche von/v1/integrations. - MCP (
/dashboard/mcp-connections) — fügen Sie einen Model Context Protocol-Server per URL hinzu und lassen Sie den Agenten die bereitgestellten Tools verwenden. Siehe Einen MCP-Server hinzufügen. - VoIP (
/dashboard/voip-connections) — Anbieterzugangsdaten für die Verwendung eigener Telefonnummern. Siehe Einen VoIP-Anbieter verbinden.
/v1/integrations und
/v1/voip-connections; siehe auch
Eine Tool-Integration erstellen.
Kampagnen
Eine Kampagne führt ausgehende Anrufe im großen Maßstab durch: Laden Sie eine CSV-Datei mit Kontakten hoch, wählen Sie den Agenten und die Absendernummer aus und legen Sie das Anruffenster (Tage und Stunden mit Zeitzonenunterstützung), die Parallelität und die Wiederholungsrichtlinie fest (maximale Anzahl der Versuche und welche Ergebnisse — keine Antwort, Mailbox, fehlgeschlagen — erneut versucht werden). Die Kampagne arbeitet die Liste ab und zeichnet jeden Anruf im Anrufverlauf auf. Im Dashboard: Kampagnen (/dashboard/campaigns). Siehe
Eine Kampagne für ausgehende Anrufe ausführen.
Für einzelne programmatische Anrufe: die
API für ausgehende Anrufe.
Live-Überwachung
Live zeigt jeden laufenden Anruf in der gesamten Organisation und ermöglicht Ihnen, jeden davon zu öffnen, um mitzuhören und einzuflüstern in Echtzeit. Es ist die Überwachungsansicht: Beobachten Sie, wie ein neuer Prompt seinen ersten echten Traffic verarbeitet, oder behalten Sie eine laufende Kampagne im Blick. Im Dashboard: Live (/dashboard/live). Siehe
Live-Anrufe beobachten und überwachen.
Simulationen
Eine Simulation ist ein KI-Anrufer, der ein echtes Gespräch mit Ihrem Agenten führt — derselbe Telefoniepfad, echtes Transkript, echte Bewertung — damit Sie vor (und nach) der Veröffentlichung testen können. Richten Sie sie auf einen Agenten oder eine Telefonnummer aus, schreiben Sie das Anruferszenario selbst oder generieren Sie Szenarien mit KI aus dem Prompt des Agenten (einschließlich Randfällen, wenn Sie danach fragen), und verfolgen Sie den Anruf live. Szenarien werden in Suites gruppiert, die eine Mindest-Erfolgsquote festlegen und als Release-Gate in CI dienen können; Regressionen gegenüber der akzeptierten Referenz werden pro Szenario gemeldet. Im Dashboard: Simulationen (/dashboard/simulations) sowie
die Schaltfläche Simulation im Agent-Builder. Siehe
Einen Anruf simulieren.
In der API: /v1/test-calls und der
Suite-Runner — siehe Einen Agenten Ende-zu-Ende testen.
Experimente
Ein Experiment führt A/B-Tests von Agentenkonfigurationen mit Live-Traffic durch: Definieren Sie Varianten (unterschiedliche Prompts, Engines oder Einstellungen), teilen Sie den Traffic zwischen ihnen auf und vergleichen Sie die Ergebnisse pro Variante. Verwenden Sie dies, statt Bucket-Logik in einem Webhook selbst zu implementieren. Im Dashboard: Experimente (/dashboard/experiments) und
der Tab A/B im Agent-Builder. Siehe
Experimente (A/B-Tests).
Probleme
Ein Problem ist ein markiertes Problem bei einem bestimmten Anruf — gemeldet von einem menschlichen Prüfer oder durch KI-Bewertung erkannt. Probleme enthalten Schweregrad, Quelle und Status, und die Seite „Probleme“ ist die Triage-Warteschlange: Filtern Sie, prüfen Sie den betreffenden Anruf und verfolgen Sie Fehlerbehebungen. Im Dashboard: Probleme (/dashboard/issues) sowie anrufspezifische
Markierungen im Anrufverlauf. Siehe Problem-Triage.
In der API: /v1/issue-reports.
Berichte
Ein Bericht beantwortet eine natürlichsprachliche Frage zu Ihren Anrufdaten („Was waren letzte Woche die drei häufigsten Gründe, aus denen Anrufer nach einem Menschen fragten?“) mit einer von KI verfassten Analyse, begrenzt auf die von Ihnen ausgewählten Agenten und den gewählten Datumsbereich. Im Dashboard: Berichte (/dashboard/reports). Siehe
Berichte.
Observability
Observability ist die Oberfläche für Metriken: Anrufvolumen, Ergebnisse und Qualität im Zeitverlauf, filterbar nach Agent und Zeitfenster, mit Export für nachgelagerte Analysen. Im Dashboard: Observability (/dashboard/observability).
Siehe Observability.
Warnungen
Eine Warnregel überwacht eine Metrik (Erfolgsrate, Fehlerrate, durchschnittliche Bewertung, Anrufvolumen, Suite-Regressionen) über ein Zeitfenster und wird ausgelöst, wenn sie Ihren Schwellenwert überschreitet. Benachrichtigungen werden per E-Mail und Slack gesendet und lösen ein Ereignisalert.triggered an Ihre
Webhook-Endpunkte aus.
Im Dashboard: Organisation → Warnungen. Siehe
Warnungen.
Webhooks
ThunderPhone sendet HTTP-POST-Webhooks an Ihren Server, wenn während und nach einem Anruf Ereignisse eintreten. Zwei Zustellmodelle:- Webhook-Endpunkte (empfohlen): Verwalten Sie mehrere URLs unter
/v1/developer/webhook-endpointsmit endpunktspezifischen Secrets und endpunktspezifischen Ereignisabonnements. - Legacy-Webhooks mit einzelner URL: eine URL pro Organisation. Verwaltet unter
/v1/webhookoder unter Organisation → Allgemein. Zur Abwärtskompatibilität beibehalten.
- Blockierende Ereignisse erwarten von Ihrem Server eine Antwort mit einer
Konfiguration, die den laufenden Anruf beeinflusst — die
Ereignisse für eingehende Anrufe
(
telephony.incoming/web.incoming). Sie haben bis zu 10 Sekunden Zeit zu antworten; bei einer Zeitüberschreitung bearbeitet der statisch zugewiesene Agent den Anruf. - Nicht blockierende Ereignisse sind Fire-and-forget-Benachrichtigungen, die mit exponentiellem Backoff erneut versucht werden — siehe Zustellsemantik.
X-ThunderPhone-Signature. Siehe
Signaturüberprüfung.
Funktions-Tools
Ein Funktions-Tool ist ein HTTP-Endpunkt, den Ihr Agent während eines Gesprächs aufrufen kann. Sie stellen ThunderPhone ein Funktionsschema im OpenAI-Stil sowie eine Endpunkt-URL bereit; der Agent entscheidet, wann er sie aufruft, und ThunderPhone sendet die signierte HTTP-Anfrage von seinen Servern und übergibt das Ergebnis an den Agenten zurück. Agenten enthalten außerdem integrierte Anruffunktionen — den Anruf weiterleiten, Tastatureingaben (DTMF) senden, den Anruf beenden, in der Warteschleife warten — die Sie mit einfachen Prompt-Zeilen statt mit Tool-Definitionen aktivieren. Im Dashboard: der Bereich API-Verbindungen des Builders (siehe Verbindungen). In der API:/v1/integrations und
die Spezifikation für Funktions-Tools.
Team und Rollen
Jede Organisation hat eine Mitgliederliste mit zwei Rollen: Mitglieder erstellen und betreiben Agenten; Administratoren verwalten zusätzlich das Team und die Abrechnung. Laden Sie per E-Mail ein — Einladungen laufen nach 7 Tagen ab und können widerrufen werden; das Menü ⋯ in einer Mitgliederzeile ändert Rollen oder entfernt jemanden. Single Sign-On kann organisationsweit konfiguriert werden — siehe SSO. Im Dashboard: Organisation → Allgemein. Siehe Team einladen. In der API:/v1/members,
/v1/invites.
Abrechnung
ThunderPhone ist Prepaid. Jede Organisation verfügt über ein USD-Guthaben; Anrufe belasten es zum Minutenpreis des Agenten (Engine-Stufe plus Zuschläge — der Builder zeigt den Gesamtpreis live an, wenn Sie Einstellungen ändern, und Premiumsprachen kosten zusätzlich 2 ¢/Min.). Wenn das Guthaben null erreicht, werden eingehende Anrufe abgewiesen und ausgehende Anrufe geben402 Payment Required zurück.
Laden Sie Guthaben manuell auf oder aktivieren Sie automatisches Aufladen mit einem Guthabenschwellenwert, einem
Aufladebetrag und einem optionalen monatlichen Ausgabenlimit — damit ein Anruf
nie mitten im Satz abbricht.
Im Dashboard: Organisation → Abrechnungseinstellungen und
Abrechnungsverlauf. Siehe
Guthaben hinzufügen und automatisches Aufladen aktivieren.
In der API: /v1/billing.
Der In-App-Copilot
Das Dashboard enthält einen integrierten Copiloten — fragen Sie ihn „wie mache ich X“, und er antwortet anhand dieser Docs, bietet Klick-für-Klick-Anleitungen, die die tatsächlichen Bedienelemente hervorheben, und kann jede der geführten Touren erneut abspielen. So finden Sie am schnellsten ein Bedienelement, das auf dieser Seite erwähnt wird. Siehe Den In-App-Copiloten fragen.Alles zusammenführen
Dashboard-Schnellstart
Der Assistent mit fünf Schritten: Agent → Abrechnung → Nummer → Simulation → Überprüfung.
API-Schnellstart
Derselbe erste Anruf in vier REST-Aufrufen.
Das Dashboard verwenden
Erstellen Sie einen Agenten, laden Sie Guthaben auf, erhalten Sie eine Nummer, simulieren und überprüfen Sie Anrufe.
Tools und Daten verbinden
OAuth-Apps, benutzerdefinierte APIs, MCP-Server und VoIP-Anbieter.
Analysieren und verbessern
Berichte, Observability, Experimente, Probleme und Warnungen.
Team und Konto
Einladungen und Rollen, API-Schlüssel, Sicherheit und SSO.
Entwickler-Kochbuch
Die API-Rezepte: eingehend, ausgehend, dynamische Konfiguration, Tools, Tests.
Webhook-Signaturen verifizieren
Prüfen Sie HMAC einmal korrekt und verwenden Sie es überall wieder.