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

Widget

CDN / Lebo ya script

Ongeza wijeti ya sauti ya ThunderPhone kwenye tovuti yoyote bila bundler

Muundo wa CDN hujumuisha React ndani yake, kwa hivyo unaweza kutumia wijeti kwenye tovuti tuli, WordPress, Webflow, au ukurasa wowote ambapo unaweza kuongeza HTML. Huhitaji npm, bundler, wala framework.

URL za CDN

Latest (recommended)
<link rel="stylesheet" href="https://cdn.thunderphone.com/widget/latest/style.css" />
<script src="https://cdn.thunderphone.com/widget/latest/widget.js"></script>
Pinned version
<!-- Each stable release also publishes an immutable /widget/vX.Y.Z/ path
     matching the @thunderphone/widget npm version (v1.1.2 at the time of
     writing). If you pin, you own updating the URL for new releases. -->
<link rel="stylesheet" href="https://cdn.thunderphone.com/widget/v1.1.2/style.css" />
<script src="https://cdn.thunderphone.com/widget/v1.1.2/widget.js"></script>

Matumizi ya Msingi

<!DOCTYPE html>
<html>
<head>
  <link rel="stylesheet" href="https://cdn.thunderphone.com/widget/latest/style.css" />
</head>
<body>
 
  <div id="thunderphone"></div>
 
  <script src="https://cdn.thunderphone.com/widget/latest/widget.js"></script>
  <script>
    ThunderPhone.mount({
      element: '#thunderphone',
      publishableKey: 'pk_live_your_publishable_key',
    })
  </script>
 
</body>
</html>

Wijeti hujipachika kwenye elementi lengwa na huonyeshwa kama upau wa nafasi isiyobadilika katika kona ya eneo la kuonyesha (chaguomsingi bottom-right, inadhibitiwa na chaguo la position). Elementi ya kupachika ni mzizi wa React pekee -- eneo lake kwenye ukurasa haliathiri mahali wijeti inaonekana.


Chaguo za Kupachika

ThunderPhone.mount() hukubali chaguo sawa na kijenzi cha React, pamoja na sifa ya element:

ChaguoAinaInahitajikaChaguomsingiMaelezo
elementstring | HTMLElementNdiyo--Kiteuzi cha CSS (kwa mfano, '#thunderphone') au rejeleo la elementi ya DOM.
publishableKeystringNdiyo--Ufunguo wa API unaoweza kuchapishwa (pk_live_...). Ejenti hutatuliwa kiotomatiki kutoka kwenye usanidi wa wijeti wa ufunguo.
theme'light' | 'dark'Hapana'light'Mpangilio wa rangi.
primaryColorstringHapana'#000000' (light) / '#ffffff' (dark)Mfuatano wa rangi wa CSS unaotumika kama rangi ya msisitizo.
titlestringHapana'Voice assistant'Maandishi yanayoonyeshwa kwenye upau wa wijeti.
position'bottom-right' | 'bottom-left' | 'top-right' | 'top-left'Hapana'bottom-right'Nafasi thabiti kwenye eneo la kuonyesha.
apiBasestringHapana'https://api.thunderphone.com/v1'Kubatilisha URL ya msingi ya API.
languagestringHapana--Kubatilisha lugha kwa kila sesheni -- msimbo wa lugha au lokaliti kama en, es, au fr-FR. Isipowekwa, lugha iliyosanidiwa ya ejenti hutumika. Inahitaji language chini ya ubatilishaji wa kivinjari wa ufunguo.
voicestringHapana--Kubatilisha sauti kwa kila sesheni -- jina la sauti kama maria. Isipowekwa, sauti iliyosanidiwa ya ejenti hutumika. Inahitaji voice chini ya ubatilishaji wa kivinjari wa ufunguo.
contextstringHapana--Muktadha wa ukweli wa ukurasa au tovuti kwa kila sesheni unaopitishwa kwa ejenti. Hupunguzwa upande wa seva hadi herufi 12,000. Inahitaji context chini ya ubatilishaji wa kivinjari wa ufunguo.
onConnect() => voidHapana--Huitwa wakati sesheni ya sauti inaunganishwa.
onDisconnect() => voidHapana--Huitwa wakati sesheni inaisha.
onError(error) => voidHapana--Huitwa kukitokea hitilafu. Hitilafu ina sehemu za error (msimbo) na message.
ringtoneboolean | stringHapanafalseCheza mlio wa simu wakati wa kuunganisha. true kwa mlio chaguomsingi wa simu, au mfuatano wa URL kwa sauti maalum.

Usafishaji

ThunderPhone.mount() hurejesha kielelezo cha wijeti chenye mbinu za usafishaji:

<script>
  var widget = ThunderPhone.mount({
    element: '#thunderphone',
    publishableKey: 'pk_live_your_publishable_key',
  })
 
  // Later, when you want to remove the widget:
  widget.unmount()
 
  // Or equivalently:
  widget.destroy()
</script>

unmount() na destroy() zote hufanya jambo lilelile -- hutenganisha kipindi chochote cha sauti kinachotumika na kuondoa wijeti kutoka kwenye DOM. Tumia yoyote inayoeleweka zaidi kwenye msimbo wako.


Mifano

Mandhari Meusi yenye Rangi Maalum

<div id="thunderphone"></div>
 
<link rel="stylesheet" href="https://cdn.thunderphone.com/widget/latest/style.css" />
<script src="https://cdn.thunderphone.com/widget/latest/widget.js"></script>
<script>
  ThunderPhone.mount({
    element: '#thunderphone',
    publishableKey: 'pk_live_your_publishable_key',
    theme: 'dark',
    primaryColor: '#8b5cf6',
    title: 'Talk to our AI',
  })
</script>

Nafasi Maalum

<div id="thunderphone"></div>
 
<script src="https://cdn.thunderphone.com/widget/latest/widget.js"></script>
<script>
  ThunderPhone.mount({
    element: '#thunderphone',
    publishableKey: 'pk_live_your_publishable_key',
    position: 'bottom-left',
  })
</script>

Yenye Vipokezi vya Tukio

<div id="thunderphone"></div>
 
<link rel="stylesheet" href="https://cdn.thunderphone.com/widget/latest/style.css" />
<script src="https://cdn.thunderphone.com/widget/latest/widget.js"></script>
<script>
  ThunderPhone.mount({
    element: '#thunderphone',
    publishableKey: 'pk_live_your_publishable_key',
    onConnect: function () {
      console.log('Call started')
    },
    onDisconnect: function () {
      console.log('Call ended')
    },
    onError: function (error) {
      console.error('Widget error:', error.error, error.message)
    },
  })
</script>

Yenye Mlio wa Simu

<div id="thunderphone"></div>
 
<link rel="stylesheet" href="https://cdn.thunderphone.com/widget/latest/style.css" />
<script src="https://cdn.thunderphone.com/widget/latest/widget.js"></script>
<script>
  ThunderPhone.mount({
    element: '#thunderphone',
    publishableKey: 'pk_live_your_publishable_key',
    ringtone: true, // or a custom URL: 'https://example.com/ringtone.mp3'
  })
</script>

Kutumia Rejeleo la Kipengele cha DOM

<div id="thunderphone"></div>
 
<script src="https://cdn.thunderphone.com/widget/latest/widget.js"></script>
<script>
  var container = document.getElementById('thunderphone')
 
  ThunderPhone.mount({
    element: container,
    publishableKey: 'pk_live_your_publishable_key',
  })
</script>

Ujumuishaji wa WordPress / CMS

Ongeza hii kwenye bloku ya HTML Maalum au sehemu ya chini ya mandhari yako:

<link rel="stylesheet" href="https://cdn.thunderphone.com/widget/latest/style.css" />
<script src="https://cdn.thunderphone.com/widget/latest/widget.js"></script>
 
<div id="thunderphone-widget"></div>
<script>
  ThunderPhone.mount({
    element: '#thunderphone-widget',
    publishableKey: 'pk_live_your_publishable_key',
  })
</script>

Utatuzi wa matatizo

Wijeti haionekani

Hakikisha faili za CSS na JS zimepakiwa. Angalia konsoli ya kivinjari kwa hitilafu za mtandao. Thibitisha kwamba elementi lengwa ipo kwenye DOM kabla ya kuita ThunderPhone.mount().

ThunderPhone haijafafanuliwa

Script bado haijapakiwa. Hakikisha lebo ya <script> ya widget.js inaonekana kabla ya mwito wako wa mount, au funga mwito wa mount katika kisikilizaji cha DOMContentLoaded.

Hitilafu ya kikoa kutoruhusiwa

Ongeza kikoa chako kwenye vikoa vinavyoruhusiwa vya wijeti kwenye ukurasa wa Wijeti za Wavuti katika app.thunderphone.com. localhost hairuhusiwi kiotomatiki katika mazingira ya uzalishaji; iongeze kwenye orodha ili kufanya majaribio ndani ya nchi.


Hatua zinazofuata