Iegultams balss logrīks

Pievienojiet balss AI aģentu jebkurai vietnei, izmantojot dažas koda rindas

ThunderPhone iegulstamais balss logrīks ļauj jūsu vietnes apmeklētājiem sarunāties ar balss aģentu tieši pārlūkprogrammā. Tālruņa zvans nav nepieciešams — lietotāji noklikšķina uz pogas un sāk reāllaika balss sarunu, ko nodrošina ThunderPhone.

Logrīks tiek attēlots kā stiklam līdzīga josla, kas pielāgojas gaišajām un tumšajām tēmām, ar pielāgojamām akcenta krāsām un izvietojumu. Tas tiek izplatīts kā @thunderphone/widget npm pakotne un ir pieejams arī, izmantojot CDN vidēs bez pakotņu komplektētāja.

Priekšnosacījumi#

Pirms logrīka iegulšanas izpildiet šīs trīs darbības ThunderPhone panelī:

1. Izveidojiet tīmekļa logrīku

   Informācijas panelī atveriet sadaļu Tīmekļa logrīki un izveidojiet logrīku. Atlasiet balss aģentu, kuru vēlaties padarīt pieejamu. Katram logrīkam ir sava publicējamā atslēga (pk_live_...), kuru ir droši iekļaut klienta puses kodā; balss aģents tiek noteikts pēc atslēgas.

2. Konfigurējiet atļautos domēnus

   Tajā pašā logrīkā pievienojiet domēnus, kuros tas tiks iegults. Tiek atbalstītas aizstājējzīmes (piemēram, *.example.com). Šis saraksts neļauj logrīkam darboties, ja kāds nokopē jūsu atslēgu uz citu vietni; tā nav autentifikācija, jo skripts ārpus pārlūka var nosūtīt jebkuru Origin galveni. localhost ražošanas vidē netiek atļauts automātiski: pievienojiet to sarakstam, lai lokāli testētu pret ražošanas API.

3. Izvēlieties pārlūka pārrakstīšanas iestatījumus

   Ja jūsu lapa iestata language, voice vai context, ieslēdziet katru no tiem sadaļā Pārlūka pārrakstīšanas iestatījumi. Jauni logrīki nepieņem nevienu no tiem, un sesijas pieprasījums ar izslēgtu iestatījumu neizdodas ar 400 override_not_allowed. Skatiet Pārlūka pārrakstīšanas iestatījumi.

Ātrais sākums#

Instalējiet pakotni:

npm install @thunderphone/widget

Pievienojiet logrīku savai lietotnei:

import { ThunderPhoneWidget } from '@thunderphone/widget'
import '@thunderphone/widget/style.css'
 
function App() {
  return (
    <ThunderPhoneWidget
      publishableKey="pk_live_your_publishable_key"
      theme="dark"
      primaryColor="#8b5cf6"
    />
  )
}

Tas arī viss. Jūsu lietotāji redzēs stiklam līdzīgu zvana joslu, kas ar vienu klikšķi savienos viņus ar jūsu balss aģentu.

Pielāgošana#

Logrīkam ir četri izskata rekvizīti:

<ThunderPhoneWidget
  publishableKey="pk_live_your_publishable_key"
/>

<ThunderPhoneWidget
  publishableKey="pk_live_your_publishable_key"
  theme="dark"
  primaryColor="#8b5cf6"
  title="Ask our AI"
/>

Vēl trīs parametri pielāgo sesiju, nevis izskatu — visi tiek pārsūtīti sesijas pieprasījumam, kad sākas zvans. Katrs darbojas tikai tad, ja logrīka publicējamā atslēga to atļauj sadaļā Pārlūka pārrakstījumi; pretējā gadījumā sesijas pieprasījums neizdodas ar 400 override_not_allowed:

Pilnu rekvizītu tabulu skatiet React komponenta atsaucē.

Lai izveidotu pilnībā pielāgotu lietotāja saskarni, izmantojiet headless āķi, lai pārvaldītu balss sesiju, kamēr veidojat savu saskarni. Āķis nodrošina reāllaika audio līmeņus audio reaģējošu vizualizāciju veidošanai.

Katra logrīka saruna ir zvans. Tā tiek ieskaitīta jūsu organizācijas vienlaicīgo zvanu limitā (pēc noklusējuma 20 notiekoši zvani, kopīgs ar tālruņa un citiem zvaniem) un logrīka limitā — 25 aktīvas sesijas (vai jūsu vienlaicīgo zvanu limitā, ja tas ir lielāks). Sasniedzot jebkuru no limitiem, jaunu sarunu nevar sākt, kamēr nav beidzies kāds zvans.

Integrācijas iespējas#

Izvēlieties integrācijas metodi, kas atbilst jūsu tehnoloģiju stekam:

Stils#

Logrīkam ir iebūvētas gaišā un tumšā tēma, ko kontrolē ar theme rekvizītu, kā arī akcenta krāsa, ko kontrolē ar primaryColor rekvizītu. Plašākai pielāgošanai varat pārrakstīt CSS pielāgotās īpašības un klases. Detalizētu informāciju skatiet stilu ceļvedī.