Open in
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
- 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.
- 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_orderkuwaagent_first(chaguo-msingi). - Dumisha salio chanya
Simu za kutoka hurejesha
402 Payment Requiredikiwa salio ni ≤$0.00. Ongeza salio au wezesha ujazo wa kiotomatiki chini ya Shirika → Mipangilio ya Malipo kwenye dashibodi. Ufunguo wako wask_live_unaweza kukagua salio kwa kutumiaGET /v1/billinglakini 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
| Hitilafu | Suluhisho |
|---|---|
402 Payment Required | Ongeza salio au washa kujaza salio kiotomatiki |
400 yenye code: destination_not_allowed | ThunderPhone 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 ThunderPhone | Fuata 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_reached | Shirika 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_reached | Shirika 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_full | Shirika lina simu 50 zilizo kwenye foleni zinazosubiri. Jaribu tena baada ya sekunde zilizo kwenye kichwa cha Retry-After |
429 yenye code: same_number_too_soon | Ulipiga 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 mteja | Rekebisha hali iliyotajwa na code; kwa hitilafu za uthibitishaji, endesha POST /v1/phone-numbers/{id}/verify-voip |
Mgongano wa 409 wa kutorudia athari | Tumia tena ufunguo huo tu pamoja na ombi asilia lililosawazishwa, au tuma ufunguo mpya |
404 from_number is not registered to this organization | Thibitisha 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 pekee | Hakuna trunk ya simu za kutoka iliyosanidiwa. Wasiliana na usaidizi; hili si tatizo la hali ya nambari unaloweza kurekebisha |
502 Bad Gateway | Hitilafu 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
Kila sehemu ya ombi na msimbo wa hitilafu.
Tiririsha simu za kutoka zilizokamilika kwenye mfumo wako.
Jaza salio kiotomatiki ili simu za kutoka zisishindwe kwa sababu ya salio.
Fanya majaribio bila kutekeleza ejenti yako ya kutoka kabla ya uzalishaji.