ThunderPhone v3 sasa inapatikana.Anza mwenyewe, kuanzia 2¢/dakika.Soma tangazo

Developer cookbook

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 itaendesha kipindi cha wijeti. Weka widget_enabled: true (chaguomsingi).

  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 wa kila ukurasa.
  3. 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. localhost hairuhusiwi kiotomatiki kwenye uzalishaji; ili kufanya majaribio ya ndani dhidi ya API ya uzalishaji, ongeza localhost kwenye orodha.

  4. 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

Static agent
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"]
  }'
Dynamic via webhook
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.

Mabatilisho ya kivinjari

Wijeti inaweza kutuma mipangilio minne kwa kila kipindi kutoka kwenye ukurasa:

MpangilioProp ya wijetiKinachobadilishwa
contextcontextMaandishi kutoka kwenye ukurasa, yanayoambatishwa kwenye prompt ya ejenti kama rejeleo
variableshakuna (kwa POST /v1/widget/session ghafi pekee)Thamani za vishikilia nafasi vya {{variable}} katika prompt
voicevoiceSauti ya ejenti kwa kipindi hiki
languagelanguageLugha 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