Veiciet izejošos zvanus (API)

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

Zvanāt visam sarakstam? Informācijas paneļa funkcija Kampaņas (/dashboard/campaigns) pieņem kontaktu CSV failu un jūsu vietā pārvalda zvanu logus, ņemot vērā laika joslas, paralēlismu un atkārtotu mēģinājumu politiku. Šajā ceļvedī aprakstīti atsevišķi programmatiskie zvani.

Priekšnosacījumi

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.

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).

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

status: "initiated" nozīmē tikai to, ka pieprasījums tika pieņemts — zvans vēl nav savienots. Aptaujājiet GET /v1/calls/{call_id}, lai iegūtu aktuālo statusu (in_progress → completed / failed).

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

Kļūda	Risinājums
`402 Payment Required`	Papildiniet atlikumu vai iespējojiet automātisko papildināšanu
`403` izejošie zvani bloķēti (demonstrācijas numurs)	Tā vietā pievienojiet VoIP numuru
`403` izejošie zvani bloķēti (neapstiprināts VoIP)	Izpildiet `POST /v1/phone-numbers/{id}/verify-voip`
`404 from_number is not registered to this organization`	Pārbaudiet, vai `from_number` atbilst jums piederošam tālruņa numuram
`502 Bad Gateway`	Pārejoša SIP / LiveKit kļūme; var droši mēģināt vēlreiz

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

Izejošo zvanu atsauce

Katrs pieprasījuma lauks un kļūdas kods.

Saņemt call.complete

Straumējiet pabeigtos izejošos zvanus uz savu sistēmu.

Norēķini

Automātiska papildināšana, lai izejošie zvani nekad neizdotos nepietiekama atlikuma dēļ.

Testēt izejošos balss aģentus

Izmēģiniet savu izejošo balss aģentu pirms izvietošanas produkcijā.

Getting Started

Using the dashboard

Connect tools & data

Analyze & improve

Team & account

Developer cookbook

Operations

Veiciet izejošos zvanus (API)

Priekšnosacījumi

Veiciet zvanu ar saglabātu balss aģentu

Veiciet zvanu ar iegultu konfigurāciju

Sekojiet zvanam

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

Aiztures laika kontrole

Nākamās darbības

Izejošo zvanu atsauce

Saņemt call.complete

Norēķini

Testēt izejošos balss aģentus

​Priekšnosacījumi

​Veiciet zvanu ar saglabātu balss aģentu

​Veiciet zvanu ar iegultu konfigurāciju

​Sekojiet zvanam

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

​Aiztures laika kontrole

​Nākamās darbības

Izejošo zvanu atsauce

Saņemt call.complete

Norēķini

Testēt izejošos balss aģentus

Priekšnosacījumi

Veiciet zvanu ar saglabātu balss aģentu

Veiciet zvanu ar iegultu konfigurāciju

Sekojiet zvanam

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

Aiztures laika kontrole

Nākamās darbības