Kā tas darbojas
- Abonējiet notikumu
telephony.incoming(tālrunis) vaiweb.incoming(logrīks). Abas ir bloķējošas tīmekļa aizķeres: ThunderPhone pirms zvana turpināšanas gaida jūsu atbildi līdz 10 sekundēm. - ThunderPhone nosūta jums
{call_id, from_number, to_number}(logrīka sesijās numuru vietā tiek nosūtīti logrīkam specifiski lauki — skatiet pieprasījuma shēmu). - Jūsu serveris atbild ar balss aģenta konfigurāciju (uzvedne, balss, produkts, rīki). ThunderPhone izmanto šo konfigurāciju zvanam.
- Ja atgriežat
{}, iestājas noildze vai rodas kļūda, kā rezerves variants tiek izmantots statiski piesaistītais balss aģents. Drošs noklusējums.
Darbojas vienādi tālruņa zvaniem (
telephony.incoming) un logrīka
sesijām (web.incoming) neatkarīgi no tā, vai tās tiek piegādātas tīmekļa aizķeres galapunktam
vai mantotajai viena URL tīmekļa aizķerei.1. Konfigurējiet tīmekļa aizķeres galamērķi
- Tālruņa zvani
- Tīmekļa logrīks
Tālruņa numuriem abonējiet savu galapunktu notikumam Atbilde ietver vienreiz izmantojamu
telephony.incoming:secret — saglabājiet to; izmantosiet to
paraksta verifikācijai.2. Ieviesiet apstrādātāju
Trīs pamatnoteikumi:- Pārbaudiet parakstu katram pieprasījumam (skatiet Tīmekļa aizķeres parakstu pārbaude). Neizlaidiet to izstrādes vidē — ieviesiet pareizi vienreiz un izmantojiet atkārtoti.
- Atbildiet ātri. Desmit sekundes ir stingrs ierobežojums, un katra sekunde zvanītājam ir klusums. Ja nepieciešams, veiciet datubāzes vaicājumus, bet nesauciet pakārtotus LLM sinhroni — ja vēlaties dinamisku uzvednes ģenerēšanu, iepriekš aprēķiniet un kešojiet.
- Nodrošiniet korektu rezerves risinājumu. Jebkuram neparedzētam stāvoklim jāatgriež
{}, lai zvanu apstrādātu statiski piešķirtais balss aģents.
3. Atbildes shēma
Atbildes pamatteksts precīzi atbilst ienākošā zvana atbildes shēmai. Biežāk izmantotie lauki:Izrunas secība katram zvanam un
max_hold_seconds nav pieejami
tīmekļa aizķeres atbildē. Iestatiet tos
aģentam, uz kuru atsaucaties.Modeļi
Pieteikušās personas konteksts
Tīmekļa aizķeres režīma logrīkos apmeklētāja lapā jau ir zināms, kas viņš ir. Izsauciet savu tīmekļa aizķeri ar vaicājuma virknes parametru, ko logrīka SDK pārsūta (?customer_id=123), un atrodiet klientu servera pusē.
A/B uzvedņu ieviešana
Pirms to veidojat manuāli, ņemiet vērā, ka ThunderPhone ir iebūvēta eksperimentu funkcija (/dashboard/experiments un balss aģentu veidotāja cilne A/B), kas
definē variantus, sadala datplūsmu un salīdzina rezultātus katram variantam —
tīmekļa aizķere nav nepieciešama.
Ja tomēr nepieciešama vadība tīmekļa aizķeres pusē: jauciet call_id → grupa;
izmantojiet uzvedni A grupām 0..49 un uzvedni B grupām 50..99. Savā DB
reģistrējiet, kuru grupu izvēlējāties, un vēlāk sasaistiet to ar
pabeigtā zvana vērtējumu.
Maršrutēšana pēc laika
Darba laikā → “tiešā atbalsta” balss aģents; ārpus darba laika → “ziņojuma pieņemšanas” balss aģents. Vienkārša pārslēgšana, izmantojotnew Date().getUTCHours(), jūsu apstrādātājā.
Nākamās darbības
Ienākošā zvana tīmekļa aizķeres atsauce
Precīzas pieprasījumu un atbilžu shēmas, tostarp katra konfigurācijas atslēga.
Pārbaudiet tīmekļa aizķeres parakstus
Pareizi iestatiet HMAC vienreiz; izmantojiet to atkārtoti visur.
Izveidojiet rīku integrāciju
Apvienojiet dinamisko maršrutēšanu ar katra balss aģenta rīkiem.
Piegādes semantika
Atkārtoti mēģinājumi, secība, taimauti.