ThunderPhone v3 sasa inapatikana.Anza mwenyewe, kuanzia 2¢/dakika.Soma tangazo

Developer cookbook

Piga simu za kutoka (API)

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

Simu za kutoka hukuruhusu kuipa ThunderPhone nambari lengwa na usanidi wa ejenti, kisha 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 isiyojibiwa
  • Arifa za aina ya utumaji

Masharti ya awali

  1. Chagua nambari iliyoidhinishwa kwa simu za kutoka

    Tumia nambari unayomiliki kupitia muunganisho wa VoIP, au omba ruhusa ya kutumia nambari zako za ThunderPhone kwa simu za kutoka kwenye ukurasa wa Phone Numbers. Nambari za ThunderPhone huanza zikiwa za kupokea simu pekee. ThunderPhone hukagua kila ombi mwenyewe; likishaidhinishwa, nambari hizo zinaweza kupiga simu hadi kufikia kikomo cha kila siku kilichoidhinishwa (kinachowekwa upya saa 00:00 UTC) na kuendesha kampeni, na unaweza kuomba kikomo cha juu zaidi. Nambari za VoIP za wateja hazina kikomo cha kila siku, kwa hiyo tunazipendekeza kwa simu za kutoka. Tazama Leta nambari zako mwenyewe.

  2. Unda ejenti

    Prompt yenye mtindo wa simu za kutoka kwa kawaida huanza ejenti ikijitambulisha na kueleza kusudi lake — "Hujambo, huyu ni Acme anayepiga 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 au wezesha ujazo wa kiotomatiki chini ya Shirika → Mipangilio ya Malipo kwenye dashibodi. Ufunguo wako wa sk_live_ unaweza kukagua salio kwa kutumia GET /v1/billing lakini hauwezi kuongeza salio au kubadilisha ujazo wa 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":   "+14155552671",
    "agent_id":    12
  }'

Jibu:

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

Piga simu kwa usanidi wa ndani

Ikiwa unataka prompt ya matumizi ya mara moja ambayo haistahili kuhifadhiwa kama ejenti, pitisha config badala yake. Muundo wake 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":   "+14155552671",
    "config": {
      "prompt":  "You are confirming Jane Doe appointment for 3pm tomorrow…",
      "voice":   "john",
      "product": "spark"
    }
  }'

Dhibiti kinachotokea baada ya ukaguzi wa mwisho wa ukimya

Unaweza pia kupitisha mipangilio ileile ya hatua ya mwisho ya ukimya katika config ya ndani inayotumiwa na ejenti zilizohifadhiwa:

{
  "from_number": "+[REDACTED_PHONE]",
  "to_number": "+[REDACTED_PHONE]",
  "config": {
    "silence_final_action": "hang_up"
  }
}

Tumia silence_final_action kuchagua kinachotokea baada ya ukaguzi wa mwisho wa ukimya. Unaweza pia kupitisha silence_final_message, na hatua ya mwisho inapokuwa uhamisho, silence_transfer_destination.

Ongeza orodha ya maneno kwenye config ya ndani

Simu za nje za ndani zinaweza kujumuisha orodha ileile ya words kama ejenti zilizohifadhiwa. Tumia hii unapotaka simu ifuate kanuni maalum za matamshi au usikilizaji bila kuhifadhi ejenti kwanza.

{
  "from_number": "+[REDACTED_PHONE]",
  "to_number": "+[REDACTED_PHONE]",
  "config": {
    "prompt": "[REDACTED_LITERAL]",
    "voice": "john",
    "product": "spark",
    "words": []
  }
}

Fuatilia simu

Jibu lenye muda wa queued_at linamaanisha uwezo wa ThunderPhone wa kupiga simu za kutoka unatumika: simu itapigwa nafasi itakapopatikana, ndani ya dakika 10, na itaisha kwa end_reason outbound_queue_timeout ikiwa hakuna nafasi. Huhitaji kujaribu tena. Tazama simu zilizo kwenye foleni.

Sambamba na hilo, jiandikishe kwa webhook ya telephony.complete — njia ya haraka zaidi ya kujua simu imekamilika. Unaweza pia kujiandikisha kwa call.status_changed ili kupata masasisho ya moja kwa moja ya maendeleo kama vile kupiga, kujibiwa, ujumbe wa sauti, na mabadiliko ya kusimamisha simu. Ikiwa huwezi kupokea webhook zinazoingia, fanya uchunguzi wa GET /v1/calls/{call_id} kila baada ya sekunde chache; rekodi inajumuisha end_reason, duration_seconds, na URL ya rekodi mara simu inapokamilika.

Ikiwa ejenti yako imesanidiwa kutoa data yenye muundo baada ya simu, data hiyo hutumwa kando baada ya ukamilishaji wa mwisho kukamilika.

Pitisha vigeu vya kila simu kwa ejenti iliyohifadhiwa

Ejenti zilizohifadhiwa zinaweza kutumia vishikilia nafasi kama {{name}} au {{name|there}} katika maandishi ya prompt. Unapopiga simu ya kutoka kwa kutumia agent_id, pitisha variables zenye thamani za simu hiyo:

{
  "from_number": "+[REDACTED_PHONE]",
  "to_number": "+[REDACTED_PHONE]",
  "agent_id": 12,
  "variables": {
    "name": "Jordan"
  }
}

Tumia thamani za mfuatano zilizo na jina la kishikilia nafasi kama ufunguo. Vigeu hivi vinatumika kwa ejenti zilizohifadhiwa; mfano wa ndani wa config katika mwongozo huu hauvitumii.

Hali za hitilafu zinazofaa kushughulikia

HitilafuSuluhisho
402 Payment RequiredOngeza salio au washa kujaza salio kiotomatiki
400 yenye code: destination_not_allowedThunderPhone haipigi nambari hiyo: nambari batili, nambari za dharura, nambari za gharama ya juu, misimbo mifupi, nchi zilizowekewa vikwazo, au jimbo la Marekani ambalo shirika lako limezuia kwa simu za kutoka. Kutoka kwa nambari za ThunderPhone, nambari za kawaida za Marekani na Kanada zinaruhusiwa, na baadhi ya maeneo ya kimataifa yanaruhusiwa na hutozwa kwa kiwango cha eneo hilo. reason hueleza ipi; tazama maeneo yaliyozuiwa
409 yenye retryable: false kwa nambari ya ThunderPhoneFuata code: omba kupiga simu za kutoka kwenye ukurasa wa Nambari za Simu, subiri ukaguzi unaosubiri, au tumia nambari nyingine inayostahiki
429 yenye code: platform_outbound_daily_limit_reachedShirika limetumia simu za kutoka za leo kutoka kwa nambari za ThunderPhone. Subiri resets_at (00:00 UTC), omba kikomo cha juu kwenye ukurasa wa Nambari za Simu, au piga simu kutoka kwa nambari kwenye muunganisho wako mwenyewe wa VoIP
429 yenye code: concurrent_call_limit_reachedShirika lina idadi ya simu zinazoendelea inayolingana na kikomo chake cha simu za wakati mmoja (20 kwa chaguo-msingi, zikijumuisha simu zinazoingia, zinazotoka, za wavuti na za majaribio). Jaribu tena baada ya sekunde zilizo kwenye kichwa cha Retry-After au simu inapomalizika; tuma barua pepe kwa support@thunderphone.com ili kuongeza kikomo
429 yenye code: outbound_queue_fullShirika lina simu 50 zilizo kwenye foleni zinazosubiri. Jaribu tena baada ya sekunde zilizo kwenye kichwa cha Retry-After
429 yenye code: same_number_too_soonUlipiga to_number ileile chini ya sekunde 10 zilizopita. Jaribu tena baada ya sekunde zilizo kwenye kichwa cha Retry-After
409 yenye retryable: false kwa nambari ya VoIP ya mtejaRekebisha hali iliyotajwa na code; kwa hitilafu za uthibitishaji, endesha POST /v1/phone-numbers/{id}/verify-voip
Mgongano wa 409 wa kutorudia athariTumia tena ufunguo huo tu pamoja na ombi asilia lililosawazishwa, au tuma ufunguo mpya
404 from_number is not registered to this organizationThibitisha kuwa from_number inalingana na nambari ya simu inayotumika katika shirika lako. Nambari ambayo tayari inaandaliwa, imeshindwa, inaondolewa, au imeondolewa pia hurejesha jibu hili
500 yenye uga wa detail pekeeHakuna trunk ya simu za kutoka iliyosanidiwa. Wasiliana na usaidizi; hili si tatizo la hali ya nambari unaloweza kurekebisha
502 Bad GatewayHitilafu ya muda ya SIP / LiveKit; ni salama kujaribu tena

Tazama marejeleo ya simu za kutoka kwa orodha kamili thabiti ya misimbo ya ustahiki na miundo yote miwili ya jibu la 409. Ikiwa nambari inayotumika haitastahiki baada ya ombi kukubaliwa lakini kabla ya simu kupigwa, ukaguzi wa mwisho hurejesha payload ya 409 isiyoruhusu kujaribu tena.

Kudhibiti muda wa kusubiri

Simu zinazopigwa kutoka nje zinazochukua muda mrefu kwa sababu anayepigiwa anachelewa kujibu (miti ya IVR, foleni) zinaweza kuwekwa kikomo kwa max_hold_seconds kwenye simu, au kwa kuiweka kwenye ejenti iliyohifadhiwa:

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

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

Ukiweka max_hold_seconds kwenye ejenti iliyohifadhiwa na kwenye ombi la simu inayopigwa kutoka nje, thamani ya kila simu itatumika kwa simu hiyo.


Hatua zinazofuata