Įterpkite žiniatinklio valdiklį

Įtraukite balso agentą į savo rinkodaros ar palaikymo svetainę naudodami vieną scenarijaus žymą — lankytojai gali su juo kalbėtis tiesiai naršyklėje, telefono numerio nereikia.

Žiniatinklio valdiklis suteikia jūsų svetainės lankytojams galimybę spustelėjus kalbėti su balso agentu, naudojant naršyklės mikrofoną. Tai atskiras JavaScript / React SDK su savo SDK nuoroda — šiame vadove aptariamas ThunderPhone pusės nustatymas, kurio reikia valdikliui.

Būtinosios sąlygos#

1. Sukurkite agentą

   Agentas, kurio raginimas ir balsas bus naudojami valdiklio sesijoje. Nustatykite widget_enabled: true (numatytoji reikšmė).

2. Pasirinkite maršruto parinkimo režimą
   • mode="agent" — vienas statinis agentas kiekvienam raktui. Paprasčiausia parinktis.
   • mode="webhook" — jūsų serveris kiekvienam lankytojui parenka agentą per web.incoming žiniatinklio kabliuką. Naudokite tai prisijungusiems naudotojams, A/B testams arba maršrutų parinkimui pagal puslapį.
3. Nurodykite leidžiamus domenus

   Viešinami raktai yra susieti su kilme. Turite nurodyti kiekvieną prieglobos vardą, kuriame bus įterptas valdiklis. Vietinio kūrimo metu visada leidžiami localhost / 127.0.0.1.

Sukurkite viešinamą raktą#

curl -X POST https://api.thunderphone.com/v1/publishable-key \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name":            "Marketing site (prod)",
    "mode":            "agent",
    "agent_id":        12,
    "allowed_domains": ["example.com", "*.example.com"]
  }'

curl -X POST https://api.thunderphone.com/v1/publishable-key \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name":            "Support (dynamic)",
    "mode":            "webhook",
    "webhook_url":     "https://example.com/thunderphone/widget-hook",
    "allowed_domains": ["support.example.com"]
  }'

Atsakyme pateikiamas key, prasidedantis pk_live_.... Viešinami raktai pagal paskirtį yra vieši — juos saugu įtraukti į jūsų naudotojo sąsajos paketą. Visus laukus rasite viešinamų raktų nuorodoje.

Įdiekite valdiklį savo svetainėje#

Valdiklio SDK dokumentacijoje aprašytos trys integravimo parinktys:

Visos trys parinktys priima tą patį publishableKey ir pateikia mikrofono mygtuką bei garso elementą pokalbio metu.

Valdiklio context sutrumpinamas iki 12 000 simbolių (maždaug 3 400 tipinio angliško teksto žetonų) ir įskaičiuojamas į raginimo dydžio priemoką.

Valdiklio režimo žiniatinklio kabliukai#

Kai mode="webhook", ThunderPhone kiekvienos sesijos pradžioje iškviečia jūsų webhook_url su web.incoming turiniu. Grąžinkite agento konfigūraciją, kurią norite paleisti tam lankytojui — ji atitinka tą pačią atsakymo schemą, kaip ir telefono skambučiams:

{
  "prompt":  "You are a VIP concierge for Jane Doe.",
  "voice":   "john",
  "product": "storm-base",
  "tools":   [ /* per-customer tools */ ]
}

Į raginimą galite įtraukti kontekstą iš savo sesijos (kuris klientas naršo, kuriame puslapyje jis yra) ir keisti agentus pagal diegimo etapą.

Stebėkite sesijas#

Valdiklio sesijos rodomos GET /v1/calls, kai direction="widget" — su tuo pačiu nuorašu, įrašu, vertinimu ir atsiskaitymu kaip telefono skambučiai. Filtruokite pagal direction, kad sukurtumėte tik valdikliui skirtą ataskaitų sritį.

Kiti veiksmai#