Developer cookbook

Veiciet izejošos zvanus (API)

Aktivizējiet MI vadītu izejošo zvanu no sava koda — aptauju, turpmāko darbību vai apstiprināšanas plūsmām.

Izejošie zvani ļauj nodot ThunderPhone mērķa numuru un balss aģenta konfigurāciju, lai MI veiktu zvanu jūsu vārdā. Tipiski lietošanas gadījumi:

• Tikšanos apstiprināšana
• Aptauju atkārtotie zvani
• Otrreizēji atgādinājumi pēc neatbildēta zvana
• Dispečera tipa paziņojumi

Priekšnosacījumi#

1. Pievienojiet VoIP numuru

   Lai veiktu izejošos zvanus, jums jābūt from_number īpašniekam, izmantojot VoIP savienojumu. Demonstrācijas numuri ir paredzēti tikai ienākošajiem zvaniem. Skatiet Pievienojiet savus numurus.

2. Izveidojiet balss aģentu

   Izejošajiem zvaniem paredzēta uzvedne parasti sākas ar to, ka balss aģents iepazīstina ar sevi un savu mērķi — "Sveiki, zvana Acme, lai apstiprinātu jūsu rītdienas tikšanos plkst. 15.00…" Iestatiet outbound_speak_order uz agent_first (noklusējuma vērtība).

3. Uzturiet pozitīvu atlikumu

   Izejošie zvani atgriež 402 Payment Required, ja atlikums ir ≤ $0.00. Papildiniet atlikumu, izmantojot POST /v1/billing/top-up, vai iespējojiet automātisko papildināšanu.

Veiciet zvanu ar saglabātu balss aģentu#

Vienkāršākais veids — norādiet balss aģentu pēc 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":   "+14155550199",
    "agent_id":    12
  }'

Atbilde:

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

Veiciet zvanu ar iegultu konfigurāciju#

Ja vēlaties vienreizēju uzvedni, kuru nav vērts saglabāt kā balss aģentu, tā vietā nododiet config. Tās struktūra atbilst call.incoming tīmekļa aizķeres atbildes shēmai:

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

Sekojiet zvanam#

Paralēli abonējiet telephony.complete tīmekļa aizķeri — tas ir ātrākais veids, kā uzzināt, ka zvans ir beidzies. Ja nevarat pieņemt ienākošās tīmekļa aizķeres, ik pēc dažām sekundēm aptaujājiet GET /v1/calls/{call_id}; ierakstā pēc zvana beigām ir iekļauti end_reason, duration_seconds un ieraksta URL.

Kļūdu režīmi, kurus vērts apstrādāt#

Aiztures laika kontrole#

Izejošajiem zvaniem, kas ieilgst, jo izsauktais abonents lēni atbild (IVR izvēlnes, rindas), var iestatīt ierobežojumu ar max_hold_seconds:

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

Balss aģents pārtrauc zvanu, ja pēdējo N sekunžu laikā nav saņemts cilvēka audio. Noklusējuma vērtība ir 900 (15 minūtes).

Nākamās darbības#