Izvajanje odhodnih klicev (API)

Odhodni klici vam omogočajo, da ThunderPhone posredujete ciljno številko in konfiguracijo agenta, AI pa klic opravi v vašem imenu. Običajni primeri uporabe:

• Potrditve terminov
• Povratni klici za ankete
• Nadaljnji klici ob »drugem poskusu« po neodgovorjenem klicu
• Obvestila v slogu dispečerskih služb

Predpogoji

1. Zagotovite številko VoIP

   Za odhodne klice morate imeti from_number prek povezave VoIP. Predstavitvene številke so samo za dohodne klice. Glejte Uporabite lastne številke.

2. Ustvarite agenta

   Poziv, prilagojen odhodnim klicem, se običajno začne tako, da se agent predstavi in navede svoj namen — »Pozdravljeni, tukaj Acme, kličemo za potrditev vašega jutrišnjega termina ob 15.00 …« Nastavite outbound_speak_order na agent_first (privzeta nastavitev).

3. Ohranite pozitivno stanje

   Odhodni klici vrnejo 402 Payment Required, če je stanje ≤ $0.00. Dobroimetje napolnite prek POST /v1/billing/top-up ali omogočite samodejno ponovno polnjenje.

Opravite klic s shranjenim agentom

Najpreprostejša možnost — navedite agenta po ID-ju:

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":   "+14155550199",
    "agent_id":    12
  }'

Odgovor:

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

Opravite klic z vdelano konfiguracijo

Če želite enkraten poziv, ki ga ni vredno shraniti kot agenta, namesto tega posredujte config. Oblika se ujema s shemo odgovora za webhook call.incoming:

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":   "+14155550199",
    "config": {
      "prompt":  "You are confirming Jane Doe appointment for 3pm tomorrow…",
      "voice":   "john",
      "product": "spark"
    }
  }'

Spremljajte klic

Vzporedno se naročite na webhook telephony.complete — to je najhitrejši način, da ugotovite, da se je klic končal. Če ne morete sprejemati dohodnih webhookov, vsakih nekaj sekund preverjajte GET /v1/calls/{call_id}; zapis po koncu klica vključuje end_reason, duration_seconds in URL posnetka.

Načini napak, ki jih je vredno obravnavati

Nadzor časa čakanja

Odhodne klice, ki trajajo dolgo, ker se klicana oseba počasi odziva (drevesa IVR, čakalne vrste), lahko omejite z max_hold_seconds:

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

Agent prekine klic, če v zadnjih N sekundah ni prejel zvoka človeškega govora. Privzeta vrednost je 900 (15 minut).

Naslednji koraki