Ingebouwde tools

Instrueer ThunderPhone-spraakagenten om gesprekken te beëindigen, bellers door te verbinden, door keuzemenu

Ingebouwde tools laten een agent veelvoorkomende oproepacties uitvoeren zonder je eigen API te koppelen. De meeste zijn automatisch beschikbaar; e-mail, geluiden en kenniszoeken verschijnen pas nadat je de bijbehorende instelling of bron hebt geconfigureerd. Vertel de agent in de prompt wanneer elke actie moet worden gebruikt.

end_call#

Beëindigt de huidige oproep wanneer de prompt het model opdraagt dit te doen. Deze is standaard beschikbaar en heeft geen agentinstelling.

Schrijf de voorwaarde en eventueel vereist afscheid in de prompt:

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

Een door het model beëindigde oproep heeft end_reason: "ai_hangup", ook wanneer deze eindigt na de waarschuwing voor de oproeptijdlimiet. De oproep eindigt alleen met max_duration als de tijdlimiet eerst wordt bereikt, en met balance_exhausted wanneer het prepaidtegoed opraakt.

transfer_call#

Verbindt een telefonische beller door naar een vast nummer dat door het model wordt opgegeven. Cold transfer gebeurt onmiddellijk. Een warme doorverbinding met voorselectie belt eerst privé naar de bestemming voordat de partijen worden verbonden. Warme doorverbinding vereist een geverifieerd geïmporteerd VoIP-nummer dat uitgaande oproepen kan plaatsen.

Zet het bestemmingsnummer en de exacte routeringsvoorwaarde in de prompt:

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

Een geslaagde cold transfer heeft end_reason: "ai_transfer"; een voltooide warme overdracht heeft end_reason: "ai_warm_transfer". Een mislukte warme poging geeft de controle terug aan de agent, dus de latere beëindiging van de oproep bepaalt de eindreden. Bij sessies die geen telefoongesprek zijn, beëindigt een doorverbindingsverzoek de sessie in plaats daarvan.

Zie Oproepen doorverbinden voor dashboard- en API-configuratie, routering, voorselectie, foutafhandeling, limieten en tests.

send_keypad_input#

Verstuurt DTMF-cijfers (telefoontoetsenbord) 0–9, * en # naar een telefoonlijn. Het model gebruikt deze om door een IVR te navigeren, het geautomatiseerde menu dat bellers vraagt toetsen in te drukken. Deze is standaard beschikbaar en heeft geen agentinstelling.

Vertel het model door welke menu's het mag navigeren en waar gevraagde waarden vandaan komen. Vraag het niet om menuopties te raden:

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.

Het platform verwijdert niet-ondersteunde tekens en verstuurt geldige cijfers op volgorde. Als er geen geldige cijfers overblijven of de oproep geen toetsenbordinvoer kan verzenden, wordt de fout teruggestuurd naar de agent zodat deze kan herstellen.

no_response#

Houdt de spraakagent stil terwijl een geautomatiseerd systeem nog spreekt of vraagt om te blijven luisteren, en terwijl een beller hardop nadenkt ("eh, even kijken") of zich omdraait om met iemand anders te praten. Wanneer een beller de spraakagent vraagt te wachten terwijl die iets doet ("een momentje", "laat me even kijken", "kun je een seconde wachten?") en niets anders geeft om op te reageren, zegt de spraakagent alleen "Natuurlijk." (niet "Neem rustig de tijd") en wacht tot de beller weer spreekt. De stiltecontroles van de spraakagent blijven actief en worden altijd uitgesproken als de lijn stil blijft. Dit is niet bedoeld voor de begroeting van een echt persoon, een vraag of een daadwerkelijke wachtrij. Het is standaard beschikbaar en heeft geen instelling voor de spraakagent.

Als je prompt de spraakagent vertelt wat hij moet zeggen wanneer een beller om een ogenblik vraagt, krijgt de prompt voorrang.

Meestal is de ingebouwde beschrijving voldoende. Versterk bij oproepen met veel IVR de grens in de prompt:

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

Deze actie beëindigt de oproep niet.

wait_on_hold#

Zet een uitgaande agent in een stille wachtstand totdat een persoon terugkeert. Het model gebruikt dit alleen nadat de andere partij expliciet zegt dat de agent in de wacht wordt gezet. Het is automatisch beschikbaar voor uitgaande oproepen en heeft geen dashboardinstelling.

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

Instrueer de agent niet om dit te gebruiken voor een IVR-bericht zoals "een ogenblik geduld". De wachtstand duurt standaard maximaal 15 minuten. Voor gewone uitgaande oproepen accepteert POST /v1/call een positief geheel getal voor max_hold_seconds; inline Realtime beperkt max_hold_seconds tot 10–900 seconden. Als de persoon terugkeert, hervat de agent zonder de eindreden van de oproep te wijzigen. Als de limiet verstrijkt, beëindigt het platform de oproep met end_reason: "ai_hangup".

search_knowledge_base#

Doorzoekt documenten die aan de agent zijn gekoppeld en retourneert relevante passages. Koppel een kennisbank of afzonderlijke kennisdocumenten om dit in te schakelen en vertel het model vervolgens welke antwoorden uit die bronnen moeten komen:

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

Als een zoekopdracht mislukt, wordt het resultaat aan de agent geretourneerd. Zie Kennisbank voor configuratie in het dashboard en via de API.

play_sound#

Speelt het geconfigureerde meldingsgeluid van de agent af na spraak in dezelfde beurt. Stel in het dashboard Geavanceerd → Toolgeluid in op Chime, Ding of Beep en implementeer vervolgens de agent. Met None wordt de tool verwijderd.

Met de Agents API stel je play_sound_asset in op "chime", "ding" of "beep" en implementeer je vervolgens. Stel dit in op "" om de tool uit te schakelen.

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

Een afspeelfout wordt aan de agent geretourneerd en beëindigt de oproep niet.

send_email#

Verstuurt een e-mail in platte tekst naar de ene ontvanger die door de eigenaar van de agent is geconfigureerd. Het model levert het onderwerp en de inhoud. Het ziet nooit een ontvangerparameter en kan het adres niet kiezen of wijzigen.

Schakel in het dashboard Geavanceerd → E-mail verzenden in, sla een ontvangeradres op en implementeer vervolgens de agent. Met de Agents API stel je zowel send_email_enabled: true als een niet-lege send_email_recipient in en implementeer je vervolgens. Definieer de trigger en vereiste inhoud in de 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.

Een oproep kan maximaal drie e-mails proberen te versturen. Elk onderwerp is beperkt tot 300 tekens en elke inhoud tot 20.000 tekens. Ontbrekende configuratie, ongeldige inhoud, de limiet per oproep en bezorgfouten worden aan de agent geretourneerd. Een mislukte bezorging gebruikt nog steeds een van de drie pogingen.

Test met een gecontroleerde ontvanger voordat je breed implementeert. Browser Talk en simulaties versturen echte e-mail; er is geen dry-runmodus.

Compatibiliteitsopmerking#

De instelling Geavanceerd → Onderbrekingsvrije mededelingen en het verouderde veld speak_uninterruptible_enabled blijven beschikbaar voor compatibiliteit, maar het inschakelen ervan heeft geen effect. Laat de instelling uitgeschakeld; geen enkele prompt kan deze tool activeren.

Gebruik Toestemmingsmelding voor een verplichte mededeling aan het begin van een oproep. Deze wordt letterlijk afgespeeld vóór het gewone gesprek en kan niet worden onderbroken. Zie Wetten voor toestemming voor oproepopname.

Ingebouwde tools testen en monitoren#

Gebruik browser Talk of een simulatie om prompts, kennisbankzoekopdrachten, geluiden en e-mail te controleren. Deze omgevingen kunnen gedrag van het telefoonnetwerk niet reproduceren. Test toetsenbordnavigatie en wachtstand in een uitgaande telefoongesprek, en test een volledige warme doorschakeling in een echte oproep met een geschikt geïmporteerd VoIP-nummer. Realtime-ondersteuning is beperkt zoals weergegeven in de bovenstaande tabel.

Oproepen, prijzen en webhooks#

Ingebouwde acties hebben geen kosten per toolgebruik. De normale kosten voor oproepen en providers blijven van toepassing; zie Prijzen. Hun oproepen en resultaten kunnen in het voltooide transcript verschijnen, maar ze genereren geen telephony.tool of web.tool. Die gebeurtenissen zijn voor door gebruikers gedefinieerde functies. Alleen een voltooide ophanging of doorschakeling wijzigt de end_reason van de oproep; andere fouten worden aan de agent teruggekoppeld. Zie Completion-webhooks voor de oproepregistratie.