Skip to main content
Bygger du din første agent for hånd? Kontrollpanelet veileder deg gjennom akkurat denne flyten — bygg agenten, legg til et nummer, simuler, gjennomgå — med en veiviser. Start med hurtigstart for kontrollpanelet.
Standardflyten for å «svare på en telefon med en AI», fra terminalen. Du skal:
  1. Opprette en agent med en prompt og stemme.
  2. Klargjøre (eller ta med) et telefonnummer og tilordne agenten som innkommende behandler.
  3. Ringe nummeret. Se samtaleloggen, transkripsjonen og opptaket.
Totalt antall API-kall: fire. Total tid: under fem minutter.

1. Opprett en agent

En agent samler prompten, stemmen og produktnivået som skal håndtere samtalen. Se Agenter for alle konfigurasjonsfeltene; minimumet er:
Lagre returnert id — du trenger den i trinn 2.
Velg spark for enkel spørsmål og svar til lavest kostnad, eller bolt når hastighet er viktigst. Oppgrader til storm-base-with-ack når prompten din trenger dypere resonnering og kan tåle en halvtsekunds utfylling mens modellen tenker. Se produktnivåer.

2. Skaff et telefonnummer

Hvis du bare trenger noe å ringe til, kan du klargjøre et demonummer fra ThunderPhone-poolen:
Svaret inneholder en id og et number i E.164-format. Demonumre starter med status="provisioning" og blir active i løpet av noen sekunder — spør GET /v1/phone-numbers/{id} for å følge overgangen hvis du trenger det.
For produksjon kan du hoppe over demonumre og ta med dine egne numre via VoIP. Demonumre er kun for innkommende samtaler og har volumbegrensning.

3. Tilordne agenten

Knytt agenten fra trinn 1 til nummerets innkommende retning:
Det er alt — nummeret er aktivt. Du kan også angi outbound_agent_id i samme PATCH, slik at nummeret også er klart for utgående samtaler.

4. Ta imot en samtale

Ring nummeret fra telefonen din. Agenten svarer, introduserer seg i henhold til prompten din, og samtalen begynner. Mens samtalen pågår, vises den i GET /v1/calls med status="in_progress". Når den avsluttes, oppdateres posten med end_reason, duration_seconds, billable_minutes og (etter hvert) en URL til opptaket og en AI-vurdering.

5. Undersøk resultatene

Hent listen over nylige samtaler:
Hent transkripsjonen:
Og URL-en til opptaket (kortvarig, signert):
Hvis du abonnerte på telephony.complete-webhooken, mottar du de samme dataene som en POST til serveren din — se call.complete.

Neste trinn

Dynamisk konfigurasjon per samtale

Velg en annen agent for hver innringer basert på telefonnummeret eller egendefinert logikk i en webhook.

Legg til verktøyintegrasjoner

La agenten kalle API-ene dine midt i samtalen.

Motta call.complete-webhooks

Send hver fullførte samtale til CRM- eller analysepipelinen din.

KI-vurdering og problemrapporter

Vurder hver samtale automatisk, og send flaggede samtaler til gjennomgang.