Lisa veebividin oma saidile

Veebividin võimaldab sinu saidi külastajatel brauseri mikrofoni kaudu alustada klõpsuga vestlust AI-häälagendiga. See on eraldi JavaScripti / Reacti SDK koos oma SDK viitega — see juhend keskendub vidina jaoks vajalikule ThunderPhone'i-poolsele seadistusele.

Eeldused

1. Loo agent

   Agent, kelle juhis ja hääl käivitavad vidina seansi. Määra widget_enabled: true (vaikeväärtus).

2. Vali suunamisrežiim
   • mode="agent" — üks staatiline agent võtme kohta. Lihtsaim valik.
   • mode="webhook" — sinu server valib agendi iga külastaja jaoks web.incoming webhooki kaudu. Kasuta seda sisselogitud kasutajate, A/B-testide või lehepõhise suunamise jaoks.
3. Määra lubatud domeenid

   Avaldatavad võtmed on päritoludomeeniga lukustatud. Pead nimetama iga hostinime, kuhu vidin manustatakse. localhost / 127.0.0.1 on kohaliku arenduse ajal alati lubatud.

Loo avaldatav võti

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"]
  }'

Vastus sisaldab key, mis algab väärtusega pk_live_.... Avaldatavad võtmed ongi mõeldud avalikud olema — neid on turvaline lisada oma front-endi paketti. Kõigi väljade kohta vaata avaldatavate võtmete viidet.

Lisa vidin oma saidile

Kolme integratsioonivõimalust kirjeldatakse vidina SDK dokumentatsioonis:

Kõik kolm kasutavad sama publishableKey väärtust ja kuvavad mikrofoninupu ning kõnesisese audioelemendi.

Vidina context kärbitakse 12 000 tähemärgini (ligikaudu 3400 tüüpilise ingliskeelse teksti tokenit) ning see arvestatakse juhise mahu lisatasu hulka.

Vidinarežiimi webhookid

Kui mode="webhook", teeb ThunderPhone sinu webhook_url-ile iga seansi alguses päringu andmekoormusega web.incoming. Tagasta selle külastaja jaoks käivitatava agendi konfiguratsioon — see järgib sama vastuseskeemi nagu telefonikõned:

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

Saad lisada juhisesse oma seansi konteksti (milline klient sirvib, millisel lehel ta on) ning vahetada agente iga kasutuselevõtu jaoks.

Jälgi seansse

Vidina seansid kuvatakse GET /v1/calls koos direction="widget" — sama transkriptsiooni, salvestuse, hindamise ja arveldusega nagu telefonikõned. Vidinapõhise juhtpaneeli loomiseks filtreeri direction järgi.

Järgmised sammud