Извършване на изходящи обаждания (API)

Задействайте изходящо обаждане, управлявано от AI, от собствения си код — за анкети, последващи действия или потвърждения.

Изходящото обаждане ви позволява да подадете номер на получател и конфигурация на агент към ThunderPhone, а AI да извърши обаждането от ваше име. Типични случаи на употреба:

• Потвърждения на срещи
• Обратни обаждания за анкети
• Проследяване при „втори опит“ след пропуснато обаждане
• Известия в стил диспечерска система

Предварителни изисквания#

1. Осигурете VoIP номер

   За изходящи обаждания трябва да притежавате from_number чрез VoIP връзка. Номерата на ThunderPhone са само за входящи обаждания. Вижте Използване на собствени номера.

2. Създайте агент

   Подканата за изходящи обаждания обикновено започва с това агентът да се представи и да посочи целта си — „Здравейте, обажда се Acme, за да потвърди вашата среща за утре в 15:00 ч.…“ Задайте 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 минути).

Следващи стъпки#