Pachika wijeti ya wavuti

Wijeti ya wavuti huwapa wageni wa tovuti yako mazungumzo ya kubofya ili kuzungumza na ejenti ya AI, kwa kutumia maikrofoni ya kivinjari. Ni SDK tofauti ya JavaScript / React yenye marejeleo yake ya SDK — mwongozo huu unalenga usanidi wa upande wa ThunderPhone unaohitajika na wijeti.

Mahitaji ya awali

1. Unda ejenti

   Ejenti ambaye prompt na sauti yake itaendesha kipindi cha wijeti. Weka widget_enabled: true (chaguomsingi).

2. Amua hali ya uelekezaji
   • mode="agent" — ejenti mmoja tuli kwa kila ufunguo. Rahisi zaidi.
   • mode="webhook" — seva yako huchagua ejenti kwa kila mgeni kupitia web.incoming webhook. Tumia hii kwa watumiaji walioingia, majaribio ya A/B, au uelekezaji kwa kila ukurasa.
3. Orodhesha vikoa vinavyoruhusiwa

   Funguo zinazoweza kuchapishwa hufungwa kwa origin. Lazima utaje kila jina la mpangishi litakalopachika wijeti. localhost / 127.0.0.1 huruhusiwa daima wakati wa usanidi wa ndani.

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

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 kwa muundo — ni salama kujumuisha katika kifurushi chako cha front-end. Tazama marejeleo ya funguo zinazoweza kuchapishwa kwa vigezo vyote.

Ongeza wijeti kwenye tovuti yako

Chaguo tatu za ujumuishaji zimeelezwa katika hati za SDK ya wijeti:

Zote tatu zinakubali publishableKey sawa na zinaonyesha kitufe cha maikrofoni pamoja na elementi ya sauti ya wakati wa simu.

context ya wijeti hukatwa hadi herufi 12,000 (takribani tokeni 3,400 za maandishi ya kawaida ya Kiingereza) na huhesabiwa katika ada ya ziada ya ukubwa wa prompt.

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 skima sawa ya majibu kama simu:

{
  "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 (mteja gani anavinjari, ukurasa gani anaotembelea) kwenye prompt, na kubadilisha ejenti kwa kila utekelezaji.

Fuatilia vipindi

Vipindi vya widget huonekana kwenye GET /v1/calls kwa direction="widget" — yenye transkripti, rekodi, tathmini na utozaji sawa na simu. Chuja kwa direction ili kuunda dashibodi ya widget pekee.

Hatua zinazofuata