Skip to main content
Bouw je je eerste agent met de hand? Het dashboard begeleidt precies deze flow — bouw de agent, voeg een nummer toe, simuleer, controleer — met een begeleide wizard. Begin met de quickstart voor het dashboard.
De standaardflow voor “een telefoon opnemen met AI”, vanuit je terminal. Je gaat:
  1. Een agent maken met een prompt en stem.
  2. Een telefoonnummer provisionen (of meenemen) en de agent toewijzen als inkomende afhandelaar.
  3. Het nummer bellen. Bekijk het oproeplogboek, transcript en de opname.
Totaal aantal API-aanroepen: vier. Totale tijd: minder dan vijf minuten.

1. Maak een agent

Een agent bundelt de prompt, stem en het productpakket die het gesprek aansturen. Zie Agents voor elk configuratieveld; het minimum is:
Sla de geretourneerde id op — je hebt die nodig in stap 2.
Kies spark voor eenvoudige vraag-en-antwoordgesprekken tegen de laagste kosten, en bolt wanneer snelheid het belangrijkst is. Upgrade naar storm-base-with-ack wanneer je prompt diepere redenering nodig heeft en een opvulling van een halve seconde kan verdragen terwijl het model nadenkt. Zie productpakketten.

2. Vraag een telefoonnummer aan

Als je alleen een nummer nodig hebt om naartoe te bellen, provision dan een demonummer uit de pool van ThunderPhone:
Het antwoord bevat een id en een number in E.164. Demonummers starten met status="provisioning" en worden binnen enkele seconden active — poll GET /v1/phone-numbers/{id} om de overgang te volgen als dat belangrijk voor je is.
Sla voor productie demonummers over en neem je eigen nummers mee via VoIP. Demonummers zijn alleen inkomend en beperkt in volume.

3. Wijs de agent toe

Koppel de agent uit stap 1 aan de inkomende afhandeling van het nummer:
Dat is alles — het nummer is actief. Je kunt ook outbound_agent_id instellen in dezelfde PATCH, zodat het nummer ook klaar is om uitgaande oproepen te doen.

4. Neem een oproep aan

Bel het nummer vanaf je telefoon. De agent neemt op, stelt zich voor volgens je prompt en het gesprek begint. Terwijl het gesprek bezig is, verschijnt het in GET /v1/calls met status="in_progress". Wanneer het eindigt, wordt het record bijgewerkt met end_reason, duration_seconds, billable_minutes en (uiteindelijk) een opname-URL en AI-beoordeling.

5. Controleer de resultaten

Haal de lijst met recente oproepen op:
Haal het transcript op:
En de opname-URL (tijdelijk, ondertekend):
Als je geabonneerd bent op de telephony.complete webhook, ontvang je dezelfde gegevens als een POST naar je server — zie call.complete.

Volgende stappen

Dynamische configuratie per oproep

Kies op basis van het telefoonnummer of aangepaste logica in een webhook een andere agent per beller.

Toolintegraties toevoegen

Laat de agent tijdens het gesprek je API’s aanroepen.

call.complete-webhooks ontvangen

Stream elke afgeronde oproep naar je CRM- / analysepipeline.

AI-beoordeling en probleemrapporten

Beoordeel elke oproep automatisch en stuur gemarkeerde oproepen door voor controle.