Open in
Shughulikia simu zinazoingia (API)
Mwanzo hadi mwisho: sanidi ejenti, ipe namba ya simu, pokea simu, na kagua nakala ya mazungumzo.
Mtiririko wa kawaida wa "kujibu simu kwa AI", kutoka kwenye terminal yako. Utafanya yafuatayo:
- Unda ejenti yenye prompt na sauti.
- Andaa (au leta) nambari ya simu na umteue ejenti kuwa kishughulikiaji wake wa simu zinazoingia.
- Piga nambari hiyo. Tazama kumbukumbu ya simu, nakala ya mazungumzo, na rekodi.
Jumla ya miito ya API: minne. Jumla ya muda: chini ya dakika tano.
1. Unda ejenti
Ejenti huunganisha prompt, sauti na kiwango cha bidhaa kitakachoendesha
simu. Unaweza pia kuweka vikomo vya simu kama vile max_call_duration_seconds
na ring_duration_seconds kwenye ejenti. Kwa simu za kutoka, unaweza pia kuweka
max_hold_seconds ili kupunguza muda ambao ejenti husubiri ikiwa imesitishwa kabla ya kumaliza
simu. Ejenti za Bolt pia zinaunga mkono audio_tier, endpointing, na intelligence
ili kudhibiti jinsi zinavyosikiliza na kujibu: intelligence ni core au pro,
na audio_tier (Usikivu) ni lite, standard, plus au max (Max haipatikani
kwa ujumla). Thamani za zamani (lite na standard za
intelligence; lean, hearing na deep_hearing za usikivu) bado
zinakubaliwa. Ejenti za duplex kamili hudumisha sauti ileile katika lugha zinazoungwa mkono,
kwa hivyo kubadilisha sauti kwa kila lugha hakutumiki kwenye simu hizo. Ejenti pia
zinaunga mkono intro_clip na intro_ring_count ili kucheza utangulizi uliorekodiwa mapema na
hadi milio miwili kabla ya ejenti kuzungumza. Ejenti mpya pia zinahitaji saa za eneo. Ikiwa
ejenti yako ina lugha nyingi, unaweza kuweka language_switching ili kudhibiti
ikiwa inauliza kabla ya kubadilisha lugha au kufuata lugha ya mpigaji simu.
Unaweza pia kuweka words kwenye ejenti ili kudhibiti jinsi inavyotamka istilahi mahususi
na istilahi inazosikiliza.
Tazama Ejenti kwa kila sehemu ya usanidi; kiwango cha
chini ni:
curl -X POST https://api.thunderphone.com/v1/agents \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Acme Support",
"prompt": "You are a friendly support agent for Acme. Help callers with orders and returns. Keep answers short.",
"voice": "john",
"product": "bolt"
}'Hifadhi id inayorejeshwa — utaihitaji katika hatua ya 2.
2. Pata nambari ya simu
Ikiwa unahitaji tu kitu cha kupigia majaribio, pata nambari ya ThunderPhone kutoka kwenye bwawa la ThunderPhone:
curl -X POST https://api.thunderphone.com/v1/phone-numbers \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"area_code": "415"}'Jibu linajumuisha id na number katika E.164. Nambari za ThunderPhone
huanza katika status="provisioning" na kuwa active ndani ya sekunde chache
— fanya poll kwa
GET /v1/phone-numbers/{id}
ili kufuatilia mabadiliko hayo ikiwa ni muhimu kwako.
3. Mteue ejenti
Husisha ejenti kutoka hatua ya 1 na mwelekeo wa simu zinazoingia wa nambari:
curl -X PATCH https://api.thunderphone.com/v1/phone-numbers/{phone_id} \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"inbound_agent_id": 12}'Hiyo tu — nambari iko hewani. Baada ya upigaji simu wa kutoka kuidhinishwa kwa
shirika lako, unaweza pia kuweka outbound_agent_id katika PATCH hiyo hiyo. Hadi
wakati huo, API hukataa uteuzi huo kwa 400.
Ikiwa utaelekeza simu zinazoingia kupitia webhook ya usanidi badala ya inbound_agent_id isiyobadilika, webhook hiyo sasa inaweza kurejesha timezone kwa kila simu pamoja na agent_id na variables. Kwa ejenti za Bolt, unaweza pia kuweka audio_tier, endpointing, na intelligence kwenye ejenti katika uandishi wa API. API bado inakubali jina la zamani eagerness kama jina mbadala la endpointing. Ikiwa ejenti yako inatumia miunganisho ya API yenye trigger="call_start", ThunderPhone inaweza kuendesha zana hizo mara moja mwanzoni mwa kila simu, kabla ya salamu, kwa kutumia call_start_arguments zilizohifadhiwa.
Simu za kurudi kwa simu zako za kutoka
Mtu anapopiga tena nambari iliyompigia ndani ya siku 30 zilizopita, ejenti anayejibu hupata dokezo fupi la muktadha kuhusu simu hiyo: ilipigwa lini, na ejenti gani, pamoja na kilichotokea (hakuna jibu, ujumbe wa sauti au mazungumzo). Nambari isiyo na ejenti wa simu zinazoingia hutuma maelezo hayo hayo kwenye webhook yako ya usanidi kama returning_call. Ikiwa nambari hiyo haina webhook, au webhook inaisha muda au haiwezi kufikiwa, simu huenda kwa ejenti aliyepiga simu ya awali badala ya kukatika. Kitambulisho cha mpigaji kinaweza kughushiwa, kwa hivyo muhtasari na vigezo vya simu ya awali hushirikiwa tu ikiwa msimamizi atawasha Shiriki maelezo ya simu ya awali chini ya Shirika → Jumla → Simu za kurudi. Tazama Simu za kurudi.
4. Pokea simu
Piga nambari hiyo kutoka kwenye simu yako. Ejenti hujibu, hujitambulisha kulingana na prompt yako, na mazungumzo huanza.
Wakati simu inaendelea, huonekana katika
GET /v1/calls ikiwa na
status="in_progress". Inapoisha, rekodi husasishwa kwa
end_reason, duration_seconds, billable_minutes, na (hatimaye)
URL ya rekodi na daraja la AI.
Simu zinazoingia huhesabiwa kwenye
kikomo cha simu za wakati mmoja cha shirika lako (simu 20
zinazoendelea kwa chaguomsingi, zikishirikiwa na simu za kutoka, za wavuti na za majaribio). Simu inayofika wakati kikomo kimefikiwa hukataliwa kabla ejenti
hajajibu na hukatwa, haitoziwi, na hurekodiwa kama simu iliyoshindwa
yenye sababu ya kumalizika concurrent_call_limit_reached. Tuma barua pepe kwa support@thunderphone.com ikiwa unahitaji
kikomo cha juu zaidi.
5. Kagua matokeo
Pata orodha ya simu za hivi karibuni:
curl 'https://api.thunderphone.com/v1/calls?limit=5' \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"Pata transkripti:
curl https://api.thunderphone.com/v1/calls/{call_id}/transcript \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"Na URL ya rekodi (ya muda mfupi, iliyotiwa sahihi):
curl https://api.thunderphone.com/v1/calls/{call_id}/audio \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"Ikiwa ulijiandikisha kwa
webhook ya telephony.complete
utapokea data sawa kama POST kwenye seva yako — tazama
call.complete.
Ikiwa ejenti wako ana sehemu za uchimbaji zilizosanidiwa, payload ya simu iliyokamilika inaweza pia kujumuisha data iliyochimbwa yenye muundo. Muhtasari wa simu huandikwa katika lugha inayotumiwa na shirika lako katika ThunderPhone, isipokuwa ejenti abadilishe mpangilio huo.
Hatua zinazofuata
Chagua ejenti tofauti kwa kila mpigaji kulingana na nambari ya simu au mantiki maalum katika webhook.
Ruhusu ejenti kuita API zako katikati ya mazungumzo.
Elekeza wapigaji moja kwa moja au kagua lengwa kabla ya kuwaunganisha.
Tiririsha kila simu iliyokamilika kwenye mkondo wako wa CRM / uchanganuzi.
Panga alama za kila simu kiotomatiki na elekeza zilizoalamishwa kwa ukaguzi.