Įterpkite žiniatinklio valdiklį

Žiniatinklio valdiklis suteikia jūsų svetainės lankytojams galimybę spustelėti ir kalbėtis su DI agentu naudojant naršyklės mikrofoną. Tai atskiras JavaScript / React SDK su savo SDK nuorodomis — šiame vadove aptariama valdikliui reikalinga ThunderPhone pusės konfigūracija.

Būtinos sąlygos

1. Sukurkite agentą

   Agentas, kurio užklausa ir balsas bus naudojami valdiklio seanse. Nustatykite widget_enabled: true (numatytoji reikšmė).

2. Pasirinkite nukreipimo režimą
   • mode="agent" — vienas statinis agentas kiekvienam raktui. Paprasčiausias variantas.
   • mode="webhook" — jūsų serveris parenka agentą kiekvienam lankytojui per web.incoming žiniatinklio kablį. Naudokite tai prisijungusiems naudotojams, A/B testams arba nukreipimui 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 localhost / 127.0.0.1 visada leidžiami.

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ų sąsajos paketą. Visus laukus rasite viešinamų raktų nuorodose.

Įterpkite valdiklį į savo svetainę

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 įprasto angliško teksto leksemų) ir įskaičiuojamas į priemoką už užklausos dydį.

Žiniatinklio kabliai valdiklio režimu

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

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

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

Stebėkite sesijas

Valdiklio sesijos rodomos GET /v1/calls su direction="widget" — tas pats transkriptas, įrašas, vertinimas ir atsiskaitymas kaip ir telefono skambučių. Filtruokite pagal direction, kad sukurtumėte tik valdiklio sesijoms skirtą valdymo skydelį.

Tolesni veiksmai