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#

1. Unda ejenti

   Ejenti ambaye prompt na sauti yake zitaendesha kipindi cha wijeti. Weka widget_enabled: true (chaguo-msingi).

2. Amua hali ya uelekezaji
   • mode="agent" — ejenti mmoja wa kudumu 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 domeni zinazoruhusiwa

   Funguo zinazoweza kuchapishwa hufungwa kwa origin. Lazima utaje kila hostname itakayopachika 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 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:

Zote tatu zinakubali publishableKey sawa na huonyesha kitufe cha maikrofoni pamoja na kipengele cha sauti wakati wa simu.

context ya wijeti hukatwa hadi herufi 12,000 (takriban 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 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#