Integrierte Tools

Weisen Sie ThunderPhone-Agenten an, Anrufe zu beenden, Anrufer weiterzuleiten, Tastenfelder zu bedienen, in der Warteschleife zu warten, Wissen zu durchsuchen, Sounds abzuspielen, E-Mails zu senden und Summen zu berechnen.

Integrierte Tools ermöglichen einem Agenten, gängige Anrufaktionen auszuführen, ohne Ihre eigene API anzubinden. Die meisten sind automatisch verfügbar; E-Mail, Sounds, der Rechner und die Wissenssuche erscheinen erst, nachdem Sie die entsprechende Einstellung oder Quelle konfiguriert haben. Teilen Sie dem Agenten in seinem Prompt mit, wann er jede Aktion verwenden soll.

end_call#

Beendet den aktuellen Anruf, wenn der Prompt das Modell dazu auffordert. Es ist standardmäßig verfügbar und hat keine Agenteneinstellung.

Schreiben Sie die Bedingung und einen erforderlichen Abschiedsgruß in den Prompt:

When the caller confirms they need nothing else, say goodbye and end the call.

Ein vom Modell beendeter Anruf hat end_reason: "ai_hangup", auch wenn er nach der Warnung zum Anrufzeitlimit endet. Der Anruf endet nur mit max_duration, wenn das Zeitlimit zuerst erreicht wird, und mit balance_exhausted, wenn das Prepaid-Guthaben aufgebraucht ist.

transfer_call#

Leitet einen Telefonanrufer an eine vom Modell angegebene feste Nummer weiter. Eine kalte Weiterleitung erfolgt sofort. Bei einer überwachten warmen Weiterleitung wird das Ziel privat angerufen, bevor die Parteien verbunden werden. Für eine warme Weiterleitung ist eine verifizierte importierte VoIP-Nummer erforderlich, die Outbound-Anrufe tätigen kann.

Geben Sie die Zielnummer und die genaue Routing-Bedingung im Prompt an:

If the caller asks for billing, transfer them to +15551234567.

Eine erfolgreiche kalte Weiterleitung hat end_reason: "ai_transfer"; eine abgeschlossene warme Übergabe hat end_reason: "ai_warm_transfer". Bei einem fehlgeschlagenen warmen Versuch erhält der Agent wieder die Kontrolle, sodass das spätere Ende des Anrufs seinen Endgrund bestimmt. Bei Nicht-Telefonsitzungen beendet eine Weiterleitungsanfrage stattdessen die Sitzung.

Siehe Anrufe weiterleiten für Dashboard- und API-Einrichtung, Routing, Überwachung, Fehlerbehandlung, Limits und Tests.

send_keypad_input#

Sendet DTMF-Ziffern (Telefontastatur) 0–9, * und # an eine Telefonleitung. Das Modell verwendet sie zur Navigation durch ein IVR, das automatisierte Menü, das Anrufer auffordert, Tasten zu drücken. Es ist standardmäßig verfügbar und hat keine Agenteneinstellung.

Teilen Sie dem Modell mit, durch welche Menüs es navigieren darf und woher angeforderte Werte stammen. Fordern Sie es nicht auf, Menüoptionen zu erraten:

Follow the phone menu for account status. Press a key only after the menu
states what that key does. Enter the account number supplied by the caller.

Die Plattform entfernt nicht unterstützte Zeichen und sendet gültige Ziffern der Reihe nach. Wenn keine gültigen Ziffern verbleiben oder der Anruf keine Tastatureingaben senden kann, wird der Fehler an den Agenten zurückgegeben, damit er reagieren kann.

no_response#

Hält den Sprachagenten stumm, während ein automatisiertes System noch spricht oder ihn auffordert, weiter zuzuhören, sowie wenn ein Anrufer laut nachdenkt („ähm, mal sehen“) oder sich an jemand anderen wendet. Wenn ein Anrufer den Sprachagenten bittet zu warten, während er etwas erledigt („eine Sekunde“, „ich schaue nach“, „können Sie kurz warten?“), und ihm sonst nichts zur Antwort gibt, sagt der Sprachagent nur „Gern.“ (nicht „Lassen Sie sich Zeit“) und wartet, bis der Anrufer wieder spricht. Die Nachfragen des Sprachagenten bei Stille laufen weiterhin und werden immer ausgesprochen, wenn die Leitung still bleibt. Dies gilt nicht für die Begrüßung durch eine reale Person, eine Frage oder eine tatsächliche Warteschleife. Es ist standardmäßig verfügbar und hat keine Agenteneinstellung.

Wenn Ihr Prompt dem Sprachagenten vorgibt, was er sagen soll, wenn ein Anrufer um einen Moment bittet, hat der Prompt Vorrang.

In der Regel reicht die integrierte Beschreibung aus. Verstärken Sie bei IVR-intensiven Anrufen die Abgrenzung im Prompt:

Stay silent while a phone menu is still speaking. Answer a live person as soon
as they address you.

Diese Aktion beendet den Anruf nicht.

wait_on_hold#

Versetzt einen ausgehenden Agenten in einen stillen Wartezustand, bis eine reale Person zurückkehrt. Das Modell verwendet es nur, nachdem die andere Partei ausdrücklich sagt, dass der Agent in die Warteschleife gelegt wird. Es ist bei ausgehenden Anrufen automatisch verfügbar und verfügt über keine Dashboard-Einstellung.

If a person explicitly puts you on hold, wait silently. When they return,
continue from the question you were discussing.

Fordern Sie den Agenten nicht auf, es für die „Bitte warten“-Meldung eines IVR zu verwenden. Die Warteschleife dauert standardmäßig bis zu 15 Minuten. Für gewöhnliche ausgehende Anrufe akzeptiert POST /v1/call eine positive Ganzzahl für max_hold_seconds; Inline-Realtime beschränkt max_hold_seconds auf 10–900 Sekunden. Wenn die Person zurückkehrt, setzt der Agent fort, ohne den Endgrund des Anrufs zu ändern. Wenn das Limit abläuft, beendet die Plattform den Anruf mit end_reason: "ai_hangup".

search_knowledge_base#

Durchsucht dem Agenten angehängte Dokumente und gibt relevante Passagen zurück. Hängen Sie eine Wissensdatenbank oder einzelne Wissensdokumente an, um dies zu aktivieren, und teilen Sie dem Modell anschließend mit, welche Antworten aus diesen Quellen stammen müssen:

Search the knowledge base before answering policy questions. If the first
search is inconclusive, try once more with different key terms.

Wenn eine Suche fehlschlägt, wird das Ergebnis an den Agenten zurückgegeben. Siehe Wissensdatenbank für die Einrichtung im Dashboard und über die API.

play_sound#

Spielt den konfigurierten Benachrichtigungston des Agenten nach jeder Spracheingabe im selben Zug ab. Legen Sie im Dashboard Erweitert → Tool-Sound auf Chime, Ding oder Beep fest und stellen Sie den Agenten anschließend bereit. Keine entfernt das Tool.

Mit der Agents API hinterlegen Sie play_sound_asset als "chime", "ding" oder "beep" und stellen den Agenten anschließend bereit. Setzen Sie den Wert auf "", um das Tool zu deaktivieren.

After confirming that an appointment was saved, say "You're all set" and play
the notification sound.

Ein Wiedergabefehler wird an den Agenten zurückgegeben und beendet den Anruf nicht.

send_email#

Sendet eine Nur-Text-E-Mail an den einen Empfänger, der vom Eigentümer des Agenten konfiguriert wurde. Das Modell liefert Betreff und Text. Es sieht niemals einen Empfängerparameter und kann die Adresse weder auswählen noch ändern.

Aktivieren Sie im Dashboard Erweitert → E-Mail senden, speichern Sie eine Empfängeradresse und stellen Sie den Agenten anschließend bereit. Mit der Agents API hinterlegen Sie sowohl send_email_enabled: true als auch einen nicht leeren send_email_recipient und stellen Sie den Agenten anschließend bereit. Definieren Sie Auslöser und erforderliche Inhalte im Prompt:

When the caller asks to leave a message, collect their name, callback number,
and message. Read the details back for confirmation, then email them.

Ein Anruf kann höchstens drei E-Mails senden. Jeder Betreff ist auf 300 Zeichen und jeder Text auf 20.000 Zeichen begrenzt. Fehlende Konfiguration, ungültige Inhalte, das Limit pro Anruf und Zustellfehler werden an den Agenten zurückgegeben. Eine fehlgeschlagene Zustellung verbraucht dennoch einen der drei Versuche.

Testen Sie mit einem kontrollierten Empfänger, bevor Sie die Funktion breit bereitstellen. Browser Talk und Simulationen senden echte E-Mails; es gibt keinen Trockenlaufmodus.

calculate#

Wertet einen arithmetischen Ausdruck exakt aus und gibt das Ergebnis zurück, damit der Agent Preise nicht im Kopf addieren muss. Standardmäßig ist die Funktion deaktiviert. Aktivieren Sie im Dashboard Erweitert → Rechner und stellen Sie den Agenten dann bereit. Setzen Sie mit der Agents API calculator_enabled: true und stellen Sie ihn dann bereit.

Das Modell schreibt den Ausdruck, beispielsweise 2*23.5 + 16.5 + 4, und liest dem Anrufer das Ergebnis vor. Ausdrücke können Zahlen, +, -, *, / und Klammern enthalten. Ein Aufruf kann bis zu 10 durch ; getrennte Ausdrücke enthalten, beispielsweise eine Zwischensumme und die Gesamtsumme mit Liefergebühr, mit insgesamt bis zu 500 Zeichen. Ergebnisse werden auf 10 Dezimalstellen gerundet. Die Berechnung erfolgt als exakte Dezimalarithmetik, daher gibt 0.1 + 0.2 den Wert 0.3 zurück. Division durch null und alles andere, was im Ausdruck nicht zulässig ist, wird dem Agenten als zu korrigierender Fehler zurückgegeben. Die Funktion läuft auf ThunderPhone und antwortet sofort, ohne Füllsatz oder Tippgeräusch.

Aktivieren Sie sie für Agenten, die Bestellsummen, Gebühren oder Wechselgeld nennen. Eine Prompt-Änderung ist nicht erforderlich.

Kompatibilitätshinweis#

Die Einstellung Erweitert → Nicht unterbrechbare Hinweise und das veraltete Feld speak_uninterruptible_enabled bleiben aus Kompatibilitätsgründen erhalten, ihre Aktivierung hat jedoch keine Wirkung. Lassen Sie die Einstellung deaktiviert; kein Prompt kann dieses Tool aktivieren.

Verwenden Sie für einen erforderlichen Hinweis zu Beginn des Anrufs Einwilligungsankündigung. Dieser wird vor dem gewöhnlichen Gespräch wortgetreu abgespielt und kann nicht unterbrochen werden. Siehe Gesetze zur Einwilligung in Anrufaufzeichnungen.

Integrierte Tools testen und überwachen#

Verwenden Sie Browser Talk oder eine Simulation, um Prompts, Wissenssuche, Töne und E-Mails zu prüfen. Diese Umgebungen können das Verhalten des Telefonnetzes nicht nachbilden. Testen Sie Tastaturnavigation und Warteschleife bei einem ausgehenden Telefonanruf und testen Sie eine vollständige warme Übergabe bei einem echten Anruf mit einer berechtigten importierten VoIP-Nummer. Die Realtime-Unterstützung ist wie in der obigen Tabelle dargestellt eingeschränkt.

Anrufe, Preise und Webhooks#

Integrierte Aktionen haben keine nutzungsabhängige Tool-Gebühr. Die regulären Anruf- und Anbietergebühren gelten weiterhin; siehe Preise. Ihre Aufrufe und Ergebnisse können im abgeschlossenen Transkript erscheinen, senden jedoch weder telephony.tool noch web.tool. Diese Ereignisse sind für benutzerdefinierte Funktionen vorgesehen. Nur ein abgeschlossener Auflege- oder Weiterleitungsvorgang ändert den end_reason des Anrufs; andere Fehler werden an den Agenten zurückgegeben. Den Anrufdatensatz finden Sie unter Abschluss-Webhooks.