Skip to main content
Tīmekļa logrīks sniedz jūsu vietnes apmeklētājiem iespēju sākt sarunu ar balss aģentu, noklikšķinot, izmantojot pārlūkprogrammas mikrofonu. Tā ir atsevišķa JavaScript / React SDK ar savu SDK atsauci — šajā ceļvedī galvenā uzmanība pievērsta ThunderPhone puses iestatīšanai, kas nepieciešama logrīkam.
To visu varat izdarīt bez cURL: informācijas paneļa lapa Tīmekļa logrīki (/dashboard/web-widgets) izveido logrīku, iestata tā režīmu un aģentu, pārvalda atļautos domēnus un sniedz jums iegulšanas fragmentu.

​
Priekšnosacījumi

1

Izveidojiet aģentu

Aģents, kura uzvedne un balss darbosies logrīka sesijā. Iestatiet widget_enabled: true (noklusējuma vērtība).
2

Izvēlieties maršrutēšanas režīmu

  • mode="agent" — viens statisks aģents katrai atslēgai. Vienkāršākais variants.
  • mode="webhook" — jūsu serveris izvēlas aģentu katram apmeklētājam, izmantojot web.incoming tīmekļa aizķeri. Izmantojiet to pieteiktiem lietotājiem, A/B testiem vai maršrutēšanai katrai lapai.
3

Norādiet atļautos domēnus

Publicējamās atslēgas ir piesaistītas izcelsmei. Jānorāda katrs resursdatora nosaukums, kurā tiks iegults logrīks. Lokālās izstrādes laikā localhost / 127.0.0.1 vienmēr ir atļauti.

​
Izveidojiet publicējamu atslēgu

Atbildē ir iekļauta key, kas sākas ar pk_live_.... Publicējamās atslēgas pēc būtības ir publiskas — tās var droši iekļaut jūsu priekšgala komplektā. Visus laukus skatiet publicējamo atslēgu atsaucē.
allowed_domains jāietver vismaz viens ieraksts. *.example.com atbilst apakšdomēniem (piemēram, api.example.com), bet neatbilst pamata domēnam. Pamata aizstājējzīmes, piemēram, * vai *.*, tiek noraidītas.

​
Pievienojiet logrīku savai vietnei

Trīs integrācijas iespējas ir aprakstītas logrīka SDK dokumentācijā:

React komponents

<ThunderPhoneWidget publishableKey="pk_live_..." />.

Headless āķis

useThunderPhone() pielāgotām lietotāja saskarnēm.

CDN skripta tags

ThunderPhone.mount({...}) vietnēm bez komplektēšanas rīka.
Visas trīs pieņem vienu un to pašu publishableKey un attēlo mikrofona pogu kopā ar zvana audio elementu. Logrīka context tiek saīsināts līdz 12 000 rakstzīmēm (aptuveni 3400 tipiska angļu valodas teksta tokeniem) un tiek ieskaitīts uzvednes lieluma piemaksā.

​
Logrīka režīma tīmekļa aizķeres

Kad mode="webhook", ThunderPhone katras sesijas sākumā izsauc jūsu webhook_url ar web.incoming slodzi. Atgrieziet aģenta konfigurāciju, kuru vēlaties palaist šim apmeklētājam — tā izmanto to pašu atbildes shēmu kā tālruņa zvani:
Uzvednē varat iekļaut kontekstu no savas sesijas (kurš klients pārlūko vietni, kurā lapā viņš atrodas) un mainīt aģentus katrā ieviešanas posmā.

​
Pārraugiet sesijas

Logrīka sesijas tiek rādītas sadaļā GET /v1/calls ar direction="widget" — ar tādu pašu transkriptu, ierakstu, vērtēšanu un norēķiniem kā tālruņa zvaniem. Filtrējiet pēc direction, lai izveidotu tikai logrīkam paredzētu paneli.

​
Nākamās darbības

Logrīka SDK atsauce

React / hook / CDN integrācijas informācija.

Dinamiska konfigurācija katram zvanam

Ieviesiet mode="webhook" plūsmu no sākuma līdz beigām.

Publicējamo atslēgu atsauce

Katrs atslēgas resursa lauks.

Mikrofona sesiju API

Izlaidiet logrīku; izmantojiet LiveKit tieši pielāgotām lietotāja saskarnēm.