Foreta utgående samtaler (API)

Utløs en KI-drevet utgående samtale fra din egen kode — for spørreundersøkelser, oppfølging eller bekreftelsesflyter.

Utgående oppringing lar deg sende et destinasjonsnummer og en agentkonfigurasjon til ThunderPhone, slik at KI-en ringer på dine vegne. Vanlige bruksområder:

• Avtalebekreftelser
• Tilbakeoppringinger for undersøkelser
• «Andre forsøk»-oppfølging etter et ubesvart anrop
• Varsler i utsendelsesstil

Forutsetninger#

1. Velg et nummer aktivert for utgående anrop

   Bruk et nummer du eier gjennom en VoIP-tilkobling, eller be om tillatelse til å bruke ThunderPhone-numrene dine til utgående anrop fra siden Phone Numbers. ThunderPhone-numre starter som kun innkommende. ThunderPhone gjennomgår hver forespørsel manuelt. Når den er godkjent, kan numrene ringe opp til den godkjente daglige grensen (som tilbakestilles kl. 00:00 UTC) og kjøre kampanjer, og du kan be om en høyere grense. Kundens VoIP-numre har ingen daglig grense, så vi anbefaler dem for utgående anrop. Se Bruk dine egne numre.

2. Opprett en agent

   En prompt tilpasset utgående anrop starter vanligvis med at agenten identifiserer seg selv og formålet sitt — «Hei, dette er Acme som ringer for å bekrefte avtalen din i morgen kl. 15 …» Angi outbound_speak_order til agent_first (standard).

3. Hold en positiv saldo

   Utgående anrop returnerer 402 Payment Required hvis saldoen er ≤ $0.00. Fyll på saldoen eller aktiver automatisk påfylling under Organisasjon → Faktureringsinnstillinger i dashbordet. sk_live_- nøkkelen din kan sjekke saldoen med GET /v1/billing, men kan ikke fylle på saldoen eller endre automatisk påfylling.

Ring med en lagret agent#

Den enkleste metoden — referer til en agent med ID:

curl -X POST https://api.thunderphone.com/v1/call \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from_number": "+15551234567",
    "to_number":   "+14155552671",
    "agent_id":    12
  }'

Svar:

{ "call_id": 987654321, "status": "initiated" }

Ring med innebygd konfigurasjon#

Hvis du vil ha en engangsledetekst som ikke er verdt å lagre som en agent, sender du config i stedet. Strukturen samsvarer med svarskjemaet for call.incoming-webhooken:

curl -X POST https://api.thunderphone.com/v1/call \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from_number": "+15551234567",
    "to_number":   "+14155552671",
    "config": {
      "prompt":  "You are confirming Jane Doe appointment for 3pm tomorrow…",
      "voice":   "john",
      "product": "spark"
    }
  }'

Følg samtalen#

Abonner parallelt på telephony.complete-webhooken — den raskeste måten å vite at en samtale er avsluttet på. Hvis du ikke kan ta imot innkommende webhooker, spør GET /v1/calls/{call_id} hvert par sekunder; oppføringen inneholder end_reason, duration_seconds og opptaks-URL-en når samtalen avsluttes.

Hvis agenten din er konfigurert til å hente ut strukturerte data etter samtalen, leveres disse dataene separat etter at fullføringen er ferdig.

Send variabler per samtale til en lagret agent#

Lagrede agenter kan bruke plassholdere som {{name}} eller {{name|there}} i prompttekst. Når du foretar en utgående samtale med agent_id, sender du variables med verdiene for den samtalen:

{
  "from_number": "+[REDACTED_PHONE]",
  "to_number": "+[REDACTED_PHONE]",
  "agent_id": 12,
  "variables": {
    "name": "Jordan"
  }
}

Bruk strengverdier med plassholdernavnet som nøkkel. Disse variablene gjelder lagrede agenter; denne veiledningens innebygde config-eksempel bruker dem ikke.

Feiltilstander det er verdt å håndtere#

Se referansen for utgående samtaler for den komplette stabile listen over kvalifiseringskoder og begge 409-svarformatene. Hvis et aktivt nummer blir ukvalifisert etter at forespørselen er godtatt, men før samtalen foretas, returnerer den endelige kontrollen 409-nyttelasten som ikke kan prøves på nytt.

Kontrollere ventetid#

Utgående samtaler som varer lenge fordi mottakeren er treg til å svare (IVR-trær, køer), kan begrenses med max_hold_seconds:

{
  "from_number": "+15551234567",
  "to_number":   "+14155552671",
  "agent_id":    12,
  "max_hold_seconds": 120
}

Agenten legger på hvis det ikke har blitt mottatt menneskelig lyd de siste N sekundene. Standardverdien er 900 sekunder (15 minutter).

Neste steg#