Lisa veebividin manustatud kujul

Lisa häälagent oma turundus- või tugisaidile ühe skriptisildiga — külastajad saavad sellega rääkida otse brauserist, telefoninumbrit pole vaja.

Veebividin annab sinu saidi külastajatele brauseri mikrofoni abil klõpsuga algatatava vestluse AI-häälagendiga. See on eraldi JavaScripti / Reacti SDK koos oma SDK viitega — see juhend keskendub ThunderPhone'i-poolsele seadistusele, mida vidin vajab.

Eeldused#

1. Loo agent

   Agent, kelle viip ja hääl vidina seansis töötavad. Määra widget_enabled: true (vaikeväärtus).

2. Vali marsruutimisrežiim
   • mode="agent" — üks staatiline agent võtme kohta. Kõige lihtsam.
   • 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 marsruutimise jaoks.
3. Loetle lubatud domeenid

   Avaldatavad võtmed on päritolupõhiselt 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 väärtust, mis algab tekstiga pk_live_.... Avaldatavad võtmed on kavandatult avalikud — neid on turvaline lisada sinu front-endi paketti. Kõigi väljade kohta vaata avaldatavate võtmete viidet.

Lisa vidin oma saidile#

Kolme integreerimisviisi kirjeldatakse vidina SDK dokumentatsioonis:

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

Vidina context kärbitakse 12 000 tähemärgini (ligikaudu 3400 tokenit tüüpilist ingliskeelset teksti) ja see arvestatakse viiba suuruse lisatasu hulka.

Veebividina režiimi webhookid#

Kui mode="webhook", kutsub ThunderPhone sinu webhook_url-i iga seansi alguses web.incoming payloadiga. Tagasta häälagendi konfiguratsioon, mida soovid selle külastaja jaoks käivitada — 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 viibale konteksti oma seansist (milline klient sirvib, millisel lehel ta on) ning vahetada agente iga juurutuse jaoks.

Jälgi seansse#

Vidina seansid kuvatakse GET /v1/calls kaudu koos direction="widget" — sama transkriptsioon, salvestus, hindamine ja arveldus nagu telefonikõnedel. Ainult vidina seansside armatuurlaua loomiseks filtreeri direction järgi.

Järgmised sammud#