Open in
Pachika wijeti ya wavuti
Weka ejenti ya sauti kwenye tovuti yako ya uuzaji au usaidizi kwa tagi moja ya script — wageni wanaizungumza moja kwa moja kutoka kwenye kivinjari, bila nambari ya simu kuhitajika.
Wijeti ya wavuti huwapa wageni wa tovuti yako mazungumzo ya kubofya ili kuzungumza na ejenti wa AI, kwa kutumia maikrofoni ya kivinjari. Ni SDK tofauti ya JavaScript / React yenye marejeleo yake ya SDK — mwongozo huu unaangazia usanidi wa upande wa ThunderPhone unaohitajika na wijeti.
Mahitaji ya awali
- Unda ejenti
Ejenti ambaye prompt na sauti yake itaendesha kipindi cha wijeti. Weka
widget_enabled: true(chaguomsingi). - Amua hali ya uelekezaji
mode="agent"— ejenti mmoja wa kudumu kwa kila ufunguo. Rahisi zaidi.mode="webhook"— seva yako huchagua ejenti kwa kila mgeni kupitiaweb.incomingwebhook. Tumia hii kwa watumiaji walioingia, majaribio ya A/B, au uelekezaji wa kila ukurasa.
- Orodhesha vikoa vinavyoruhusiwa
Taja kila jina la mpangishi litakalopachika wijeti. Vivinjari hutuma asili ya ukurasa pamoja na kila ombi la kipindi, hivyo orodha huzuia ufunguo wako kufanya kazi mtu anapounakili kwenye tovuti nyingine. Hii si uthibitishaji: hati iliyo nje ya kivinjari inaweza kutuma kichwa chochote cha
Origin.localhosthairuhusiwi kiotomatiki kwenye uzalishaji; ili kufanya majaribio ya ndani dhidi ya API ya uzalishaji, ongezalocalhostkwenye orodha. - Chagua ubatilishaji wa kivinjari
Amua ni mipangilio ipi ya kipindi ambayo ukurasa wako unaweza kutuma. Funguo mpya hazikubali yoyote; angalia Ubatilishaji wa kivinjari.
Unda ufunguo unaoweza kuchapishwa
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"],
"allowed_overrides": ["context"]
}'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"]
}'Jibu linajumuisha key inayoanza na pk_live_.... Funguo zinazoweza kuchapishwa
ni za umma kimakusudi — ni salama kujumuisha katika kifurushi chako cha front-end.
Angalia marejeleo ya funguo zinazoweza kuchapishwa kwa
sehemu zote.
Ongeza wijeti kwenye tovuti yako
Chaguo tatu za ujumuishaji zimeelezwa katika nyaraka za SDK ya wijeti:
<ThunderPhoneWidget publishableKey="pk_live_..." />.
useThunderPhone() kwa UI maalum.
ThunderPhone.mount({...}) kwa tovuti zisizotumia bundler.
Zote tatu zinakubali publishableKey sawa na huonyesha kitufe cha maikrofoni
pamoja na kipengele cha sauti wakati wa simu.
Mabatilisho ya kivinjari
Wijeti inaweza kutuma mipangilio minne kwa kila kipindi kutoka kwenye ukurasa:
| Mpangilio | Prop ya wijeti | Kinachobadilishwa |
|---|---|---|
context | context | Maandishi kutoka kwenye ukurasa, yanayoambatishwa kwenye prompt ya ejenti kama rejeleo |
variables | hakuna (kwa POST /v1/widget/session ghafi pekee) | Thamani za vishikilia nafasi vya {{variable}} katika prompt |
voice | voice | Sauti ya ejenti kwa kipindi hiki |
language | language | Lugha ambayo kipindi huanza nayo |
Ufunguo wako wa kuchapishwa ni wa umma, kwa hivyo mtu yeyote aliye nao anaweza kutuma
mipangilio hii, ikiwemo kutoka kwenye script inayoghushi kikoa chako. Kwa hiyo kila mpangilio
umezimwa hadi uuruhusu kwenye ufunguo: weka alama chini ya Ubatilishaji wa kivinjari
unapounda au kuhariri wijeti kwenye dashibodi, au weka
allowed_overrides kupitia
API ya funguo za kuchapishwa. Ruhusu tu kile ambacho
ukurasa wako unatuma.
Ombi la kipindi lenye mpangilio ambao ufunguo haurusu hushindwa kwa 400 na kuutaja:
{
"error": "override_not_allowed",
"fields": ["voice"],
"message": "This publishable key does not allow the browser to set `voice`. ..."
}Ukaguzi huu hutumika katika hali zote mbili. Katika hali ya webhook, mpangilio unaoruhusiwa pia hutumwa kwa webhook yako ya web.incoming (context hufika kama website_context). Funguo zilizoundwa kabla ya mpangilio huu kuwepo huruhusu zote nne, kwa hivyo upachikaji uliopo unaendelea kufanya kazi; zima usichotumia.
Muktadha wa wijeti context hupunguzwa hadi herufi 12,000 (takriban
tokeni 3,400 za maandishi ya kawaida ya Kiingereza) na ni sehemu ya prompt ambayo miundo ya AI husoma, hivyo
muktadha mrefu zaidi hugharimu zaidi kwa dakika.
Ejenti inaelekezwa kuuchukulia kama maudhui ya ukurasa, si kama maagizo.
Webhook za hali ya wijeti
Wakati mode="webhook", ThunderPhone hupiga webhook_url yako kila
kipindi kinapoanza kwa payload ya web.incoming. Rudisha usanidi wa ejenti
unaotaka kuendesha kwa mgeni huyo — unafuata schema sawa ya jibu kama
simu za kawaida:
{
"prompt": "You are a VIP concierge for Jane Doe.",
"voice": "john",
"product": "storm-base",
"tools": [ /* per-customer tools */ ]
}Unaweza kuchanganya muktadha kutoka kwenye kipindi chako mwenyewe (ni mteja gani anavinjari, yuko kwenye ukurasa gani) kwenye prompt, na kubadilisha ejenti kwa kila utoaji.
Fuatilia sesheni
Sesheni za wijeti huonekana katika
GET /v1/calls kwa
direction="widget" — zikiwa na nakala sawa ya mazungumzo, kurekodi, tathmini na
utozaji kama simu. Chuja kwa direction ili kutengeneza dashibodi ya
wijeti pekee.
Hatua zinazofuata
Maelezo ya muunganisho wa React / hook / CDN.
Tekeleza mtiririko wa mode="webhook" kutoka mwanzo hadi mwisho.
Kila sehemu kwenye rasilimali ya ufunguo.
Ruka wijeti; endesha LiveKit moja kwa moja kwa UI maalum.