Упућујте одлазне позиве (API)

Одлазно позивање Вам омогућава да ThunderPhone-у проследите одредишни број и конфигурацију агента, а да AI упути позив у Ваше име. Типични случајеви употребе:

• Потврде термина
• Повратни позиви за анкете
• Накнадни покушаји након пропуштеног позива
• Обавештења у стилу диспечерске службе

Предуслови

1. Додајте VoIP број

   За одлазно позивање потребно је да поседујете from_number преко VoIP везе. Демо бројеви су само за долазне позиве. Погледајте Додајте сопствене бројеве.

2. Креирајте агента

   Упит прилагођен одлазним позивима обично почиње тако што се агент представља и наводи своју сврху — „Здраво, овде Acme, зовемо да потврдимо Ваш термин сутра у 15 часова…“ Подесите outbound_speak_order на agent_first (подразумевана вредност).

3. Одржавајте позитиван салдо

   Одлазни позиви враћају 402 Payment Required ако је салдо ≤ $0.00. Допуните салдо путем POST /v1/billing/top-up или омогућите аутоматско допуњавање.

Упутите позив са сачуваним агентом

Најједноставнији начин — наведите агента по идентификатору:

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

Одговор:

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

Упутите позив са уграђеном конфигурацијом

Ако желите једнократни упит који не вреди чувати као агента, уместо тога проследите config. Облик одговара шеми одговора 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"
    }
  }'

Пратите позив

Истовремено, претплатите се на telephony.complete веб-хук — најбржи начин да сазнате да је позив завршен. Ако не можете да примате долазне веб-хукове, периодично проверавајте GET /v1/calls/{call_id} сваких неколико секунди; запис укључује end_reason, duration_seconds и URL снимка када се позив заврши.

Грешке које треба обрадити

Управљање временом чекања

Одлазни позиви који трају дуго јер прималац споро одговара (IVR стабла, редови чекања) могу се ограничити помоћу max_hold_seconds:

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

Агент прекида позив ако у последњих N секунди није примљен људски аудио. Подразумевана вредност је 900 (15 минута).

Следећи кораци