---
title: "Tee väljuvaid kõnesid (API)"
description: "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

<Note>
  Helistad tervele loendile? Armatuurlaua
  [**Kampaaniate**](/et/guides/outbound-campaigns) funktsioon
  (`/dashboard/campaigns`) võtab vastu kontaktide CSV-faili ning haldab sinu eest
  ajavöönditeadlikke helistamisaknaid, samaaegsust ja korduskatsete poliitikat.
  See juhend käsitleb üksikuid programmilisi kõnesid.
</Note>

## Eeldused

<Steps>
  <Step title="Too VoIP-number">
    Väljaminevate kõnede tegemiseks peab sulle kuuluma `from_number`
    [VoIP-ühenduse](/api-reference/voip-connections) kaudu. ThunderPhone’i numbrid
    on ainult sissetulevate kõnede jaoks. Vaata
    [Kasuta oma numbreid](/et/guides/bring-your-own-numbers).
  </Step>
  <Step title="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).
  </Step>
  <Step title="Hoia positiivset saldot">
    Väljaminevad kõned tagastavad `402 Payment Required`, kui saldo on ≤
    `$0.00`. Lisa raha
    [`POST /v1/billing/top-up`](/api-reference/billing#top-up-balance) kaudu
    või luba [automaatne saldo täiendamine](/api-reference/billing#update-auto-reload).
  </Step>
</Steps>

## Tee kõne salvestatud agendiga

Lihtsaim viis — viita agendile ID järgi:

```bash
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:

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

<Warning>
  `status: "initiated"` tähendab ainult seda, et päring võeti vastu — kõne
  **ei ole veel ühendatud**. Küsi
  [`GET /v1/calls/{call_id}`](/api-reference/calls#retrieve-a-call) kaudu
  reaalajas olekut (`in_progress` → `completed` / `failed`).
</Warning>

## Tee kõne sisekonfiguratsiooniga

Kui soovid ühekordset juhist, mida ei tasu agendina salvestada,
edasta selle asemel `config`. Struktuur vastab
[`call.incoming` webhooki](/et/webhooks/call-incoming)
vastuseskeemile:

```bash
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](/et/webhooks/events) —
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

| Tõrge | Lahendus |
|-------|-----|
| `402 Payment Required` | Lisa saldot või luba automaatne saldo täiendamine |
| `403` väljaminev kõne blokeeritud (ThunderPhone’i number) | Kasuta selle asemel VoIP-numbrit |
| `403` väljaminev kõne blokeeritud (kinnitamata VoIP) | Käivita [`POST /v1/phone-numbers/{id}/verify-voip`](/api-reference/phone-numbers#verify-a-voip-sourced-number) |
| `404 from_number is not registered to this organization` | Veendu, et `from_number` vastab telefoninumbrile, mis sulle kuulub |
| `502 Bad Gateway` | Ajutine SIP-i / LiveKit’i tõrge; korduskatse on turvaline |

## 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`:

```json
{
  "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

<CardGroup cols={2}>
  <Card title="Väljaminevate kõnede viide" icon="phone-arrow-up-right" href="/api-reference/outbound-calls">
    Kõik päringuväljad ja veakoodid.
  </Card>
  <Card title="Võta vastu call.complete" icon="bolt" href="/et/webhooks/call-complete">
    Edasta lõpetatud väljaminevad kõned oma süsteemi.
  </Card>
  <Card title="Arveldamine" icon="credit-card" href="/api-reference/billing">
    Automaatne saldo täiendamine, et väljaminevad kõned ei nurjuks saldo puudumise tõttu.
  </Card>
  <Card title="Testi väljaminevaid agente" icon="flask" href="/et/guides/test-agents">
    Käivita oma väljaminev agent enne tootmiskeskkonda proovirežiimis.
  </Card>
</CardGroup>