Tee väljuvaid kõnesid (API)

Väljaminevad kõned võimaldavad sul anda ThunderPhone'ile sihtnumbri ja agendi konfiguratsiooni ning lasta tehisintellektil sinu eest kõne teha. Tüüpilised kasutusjuhud:

• Kohtumiste kinnitused
• Küsitluste järelkõned
• „Teise katse” järeltegevused pärast vastamata kõnet
• Dispetšerilaadsed teavitused

Eeldused

1. Lisa VoIP-number

   Väljaminevate kõnede tegemiseks peab sulle kuuluma from_number läbi VoIP-ühenduse. Demonumbrid on ainult sissetulevate kõnede jaoks. Vaata Kasuta oma numbreid.

2. Loo agent

   Väljaminevale kõnele kohandatud viip algab tavaliselt sellega, et agent tutvustab ennast ja oma eesmärki — „Tere, siin Acme, helistame, et kinnitada teie homne kohtumine kell 15…” Määra outbound_speak_order väärtuseks agent_first (vaikeväärtus).

3. Hoia saldot positiivsena

   Väljaminevad kõned tagastavad 402 Payment Required, kui saldo on ≤ $0.00. Lisa raha POST /v1/billing/top-up kaudu või luba automaatne saldo täiendamine.

Tee kõne salvestatud agendiga

Lihtsaim viis — viita agendile ID järgi:

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
  }'

Vastus:

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

Tee kõne sisekonfiguratsiooniga

Kui soovid ühekordset viipa, mida ei tasu agendina salvestada, edasta selle asemel config. Selle kuju vastab call.incoming veebikonksu vastusskeemile:

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"
    }
  }'

Jälgi kõnet

Samal ajal telli telephony.complete veebikonks — see on kiireim viis teada saada, et kõne lõppes. Kui sa ei saa sissetulevaid veebikonkse vastu võtta, küsi GET /v1/calls/{call_id} iga paari sekundi järel; kirje sisaldab pärast kõne lõppu end_reason, duration_seconds ja salvestise URL-i.

Tõrked, mida tasub käsitleda

Ooteaja juhtimine

Pikaks venivaid väljuvaid kõnesid, kuna kõne vastuvõtja reageerib aeglaselt (IVR-menüüd, järjekorrad), saab piirata max_hold_seconds abil:

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

Agent lõpetab kõne, kui viimase N sekundi jooksul pole vastu võetud inimese heli. Vaikeväärtus on 900 (15 minutit).

Järgmised sammud