Piga simu za kutoka (API)

Anzisha simu ya kutoka inayoendeshwa na AI kutoka kwenye msimbo wako mwenyewe — mitiririko ya utafiti, ufuatiliaji au uthibitishaji.

Kupiga simu zinazotoka hukuruhusu kuipa ThunderPhone nambari ya unakoenda na usanidi wa ejenti, kisha AI ipige simu kwa niaba yako. Matumizi ya kawaida:

• Uthibitishaji wa miadi
• Simu za kurudia kwa ajili ya tafiti
• Ufuatiliaji wa "jaribio la pili" baada ya simu iliyokosa kujibiwa
• Arifa za mtindo wa utumaji

Mahitaji ya awali#

1. Leta nambari ya VoIP

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

2. Unda ejenti

   Prompt ya simu zinazotoka kwa kawaida huanza ejenti ikijitambulisha na kueleza kusudi lake — "Habari, hapa 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 zinazotoka hurejesha 402 Payment Required ikiwa salio ni ≤ $0.00. Ongeza salio kupitia POST /v1/billing/top-up au washa kujaza upya kiotomatiki.

Piga simu kwa ejenti iliyohifadhiwa#

Njia rahisi zaidi — rejelea ejenti kwa id:

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, pitisha config badala yake. Muundo unalingana na skima 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#

Sambamba, jiandikishe kwa telephony.complete webhook — hii ndiyo njia ya haraka zaidi ya kujua simu imekamilika. Ikiwa huwezi kupokea webhook zinazoingia, kagua GET /v1/calls/{call_id} kila baada ya sekunde chache; rekodi inajumuisha end_reason, duration_seconds, na URL ya rekodi mara simu inapomalizika.

Hali za hitilafu zinazofaa kushughulikia#

Kudhibiti muda wa kusubiri#

Simu za kutoka zinazochukua muda mrefu kwa sababu anayepokea 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#