Upućivanje odlaznih poziva (API)

Odlazno pozivanje omogućuje vam da ThunderPhoneu predate odredišni broj i konfiguraciju agenta te da AI uputi poziv u vaše ime. Uobičajeni slučajevi upotrebe:

• Potvrde termina
• Povratni pozivi za ankete
• Naknadni pozivi „iz drugog pokušaja” nakon propuštenog poziva
• Obavijesti u stilu dispečerskih sustava

Preduvjeti

1. Pripremite VoIP broj

   Za odlazno pozivanje morate posjedovati from_number putem VoIP veze. Demo brojevi služe samo za dolazne pozive. Pogledajte Donesite vlastite brojeve.

2. Izradite agenta

   Prompt prilagođen odlaznim pozivima obično započinje tako da se agent predstavi i navede svoju svrhu — „Dobar dan, ovdje Acme, zovemo radi potvrde vašeg termina sutra u 15 h…” Postavite outbound_speak_order na agent_first (zadano).

3. Održavajte pozitivan saldo

   Odlazni pozivi vraćaju 402 Payment Required ako je saldo ≤ $0.00. Nadoplatite saldo putem POST /v1/billing/top-up ili omogućite automatsku nadoplatu.

Uputite poziv sa spremljenim agentom

Najjednostavniji način — navedite agenta prema ID-u:

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

Odgovor:

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

Uputite poziv s ugrađenom konfiguracijom

Ako želite jednokratni prompt koji nije vrijedno spremiti kao agenta, umjesto toga proslijedite config. Struktura odgovara shemi odgovora web-dojavnika call.incoming:

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

Pratite poziv

Istodobno se pretplatite na web-dojavnik telephony.complete — to je najbrži način da saznate da je poziv završen. Ako ne možete primati dolazne web-dojavnike, ispitujte GET /v1/calls/{call_id} svakih nekoliko sekundi; zapis nakon završetka poziva uključuje end_reason, duration_seconds i URL snimke.

Načini neuspjeha koje vrijedi obraditi

Upravljanje vremenom čekanja

Odlazni pozivi koji dugo traju jer pozvana strana sporo odgovara (IVR stabla, redovi čekanja) mogu se ograničiti pomoću max_hold_seconds:

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

Agent prekida poziv ako u posljednjih N sekundi nije primljen ljudski zvuk. Zadana vrijednost je 900 (15 minuta).

Sljedeći koraci