Tee väljuvaid kõnesid (API)

Käivita oma koodist tehisintellektil põhinev väljuv kõne — küsitluse, järeltegevuse või kinnituse töövoogude jaoks.

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
• Pärast vastamata kõnet tehtavad „teise katse” järeltegevused
• Dispetšeri stiilis teavitused

Eeldused#

1. Too VoIP-number

   Väljaminevate kõnede tegemiseks peab sulle kuuluma from_number VoIP-ühenduse kaudu. ThunderPhone’i numbrid on ainult sissetulevate kõnede jaoks. Vaata Kasuta oma numbreid.

2. Loo agent

   Väljaminevale kõnele suunatud juhis 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 positiivset saldot

   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 juhist, mida ei tasu agendina salvestada, edasta selle asemel config. Struktuur vastab call.incoming webhooki vastuseskeemile:

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 webhook — see on kiireim viis teada saada, et kõne lõppes. Kui sa ei saa sissetulevaid webhooke vastu võtta, küsi GET /v1/calls/{call_id} kaudu olekut iga paari sekundi järel; kirje sisaldab pärast kõne lõppu end_reason, duration_seconds ja salvestise URL-i.

Käsitlemist väärt tõrkerežiimid#

Ooteaja juhtimine#

Väljaminevaid kõnesid, mis kestavad kaua, kuna kõne vastuvõtja reageerib aeglaselt (IVR-menüüd, järjekorrad), saab piirata parameetriga max_hold_seconds:

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

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

Järgmised sammud#