Piga simu za kutoka (API)

Kupiga simu za kutoka hukuruhusu kutoa nambari lengwa na usanidi wa ejenti kwa ThunderPhone ili AI ipige simu kwa niaba yako. Matumizi ya kawaida:

• Uthibitishaji wa miadi
• Kupiga simu tena kwa ajili ya tafiti
• Ufuatiliaji wa "jaribio la pili" baada ya simu iliyokosa kujibiwa
• Arifa za uratibu wa utumaji

Masharti ya awali

1. Leta nambari ya VoIP

   Kupiga simu za kutoka kunahitaji umiliki wa from_number kupitia muunganisho wa VoIP. Nambari za onyesho ni za simu zinazoingia pekee. Tazama Leta nambari zako mwenyewe.

2. Unda ejenti

   Prompt iliyoundwa kwa simu za kutoka kwa kawaida huanza ejenti ikijitambulisha na kueleza kusudi lake — "Hujambo, huyu ni Acme tunapiga simu kuthibitisha miadi yako ya kesho saa 3pm…" Weka outbound_speak_order kuwa agent_first (chaguo-msingi).

3. Dumisha salio chanya

   Simu za kutoka hurejesha 402 Payment Required ikiwa salio ni ≤ $0.00. Ongeza salio kupitia POST /v1/billing/top-up au wezesha kujaza salio kiotomatiki.

Piga simu kwa ejenti iliyohifadhiwa

Njia rahisi zaidi — rejelea ejenti kwa kitambulisho chake:

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

Jibu:

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

Piga simu kwa usanidi wa ndani

Ikiwa unataka prompt ya matumizi ya mara moja ambayo haifai kuhifadhiwa kama ejenti, tuma config badala yake. Muundo wake unalingana na schema ya jibu ya call.incoming webhook:

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

Fuatilia simu

Wakati huohuo, jisajili kupokea telephony.complete webhook — njia ya haraka zaidi ya kujua simu imekamilika. Ikiwa huwezi kupokea webhook zinazoingia, angalia GET /v1/calls/{call_id} kila baada ya sekunde chache; rekodi inajumuisha end_reason, duration_seconds, na URL ya rekodi ya sauti simu inapomalizika.

Hali za hitilafu zinazofaa kushughulikiwa

Kudhibiti muda wa kusubiri

Simu za kutoka zinazoendelea kwa muda mrefu kwa sababu anayepokea simu anachelewa kujibu (miti ya IVR, foleni) zinaweza kuwekwa kikomo kwa max_hold_seconds:

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

Ejenti hukata simu ikiwa hakuna sauti ya binadamu iliyopokelewa katika sekunde N zilizopita. Chaguo-msingi ni 900 (dakika 15).

Hatua zinazofuata