ThunderPhone v3 je tu.Začnite sami, už od 2 ¢/min.Prečítať oznámenie

Widget

CDN / Značka scriptu

Pridajte hlasový widget ThunderPhone na ľubovoľnú webovú stránku bez bundlera

Verzia CDN interne obsahuje React, takže widget môžete použiť na statických stránkach, vo WordPress, Webflow alebo na akejkoľvek stránke, na ktorú môžete pridať HTML. Nevyžaduje sa npm, bundler ani framework.

Adresy URL 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>

Základné použitie

<!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>

Widget sa pripojí do cieľového prvku a vykreslí sa ako panel s pevnou pozíciou v rohu zobrazovacej oblasti (predvolene bottom-right, ovládané voľbou position). Prvok pripojenia je iba koreň Reactu -- jeho umiestnenie na stránke nemá vplyv na to, kde sa widget zobrazí.


Možnosti pripojenia

ThunderPhone.mount() prijíma rovnaké možnosti ako komponent Reactu a navyše vlastnosť element:

MožnosťTypPovinnéPredvolenéPopis
elementstring | HTMLElementÁno--Selektor CSS (napr. '#thunderphone') alebo referencia na prvok DOM.
publishableKeystringÁno--Verejný kľúč API (pk_live_...). Agent sa automaticky určí z konfigurácie widgetu kľúča.
theme'light' | 'dark'Nie'light'Farebná schéma.
primaryColorstringNie'#000000' (svetlý) / '#ffffff' (tmavý)Reťazec farby CSS použitý ako farba zvýraznenia.
titlestringNie'Voice assistant'Text zobrazený na lište widgetu.
position'bottom-right' | 'bottom-left' | 'top-right' | 'top-left'Nie'bottom-right'Pevná pozícia vo výreze.
apiBasestringNie'https://api.thunderphone.com/v1'Prepísanie základnej adresy URL API.
languagestringNie--Prepísanie jazyka pre reláciu -- kód jazyka alebo miestne nastavenie, napríklad en, es alebo fr-FR. Ak nie je nastavené, použije sa nakonfigurovaný jazyk agenta. Vyžaduje language v prepísaniach prehliadača kľúča.
voicestringNie--Prepísanie hlasu pre reláciu -- názov hlasu, napríklad maria. Ak nie je nastavené, použije sa nakonfigurovaný hlas agenta. Vyžaduje voice v prepísaniach prehliadača kľúča.
contextstringNie--Faktický kontext stránky alebo webu pre reláciu odovzdaný agentovi. Na strane servera sa skráti na 12 000 znakov. Vyžaduje context v prepísaniach prehliadača kľúča.
onConnect() => voidNie--Volá sa po pripojení hlasovej relácie.
onDisconnect() => voidNie--Volá sa po skončení relácie.
onError(error) => voidNie--Volá sa pri chybách. Chyba má polia error (kód) a message.
ringtoneboolean | stringNiefalsePočas pripájania prehrá vyzváňací tón. true pre predvolený vyzváňací tón alebo reťazec URL pre vlastný zvuk.

Vyčistenie

ThunderPhone.mount() vracia inštanciu widgetu s metódami na vyčistenie:

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

Funkcie unmount() aj destroy() robia to isté – odpoja všetky aktívne hlasové relácie a odstránia widget z DOM. Použite tú, ktorá sa vo vašom kóde číta lepšie.


Príklady

Tmavá téma s vlastnou farbou

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

Vlastná pozícia

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

S spätnými volaniami udalostí

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

So zvonením

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

Použitie odkazu na prvok 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>

Integrácia s WordPressom / CMS

Pridajte tento kód do bloku Vlastné HTML alebo do päty svojej témy:

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

Riešenie problémov

Widget sa nezobrazuje

Uistite sa, že sú načítané súbory CSS aj JS. Skontrolujte konzolu prehliadača, či neobsahuje sieťové chyby. Overte, že cieľový prvok existuje v DOM pred volaním ThunderPhone.mount().

ThunderPhone nie je definovaný

Skript sa ešte nenačítal. Uistite sa, že značka <script> pre widget.js sa nachádza pred volaním pripojenia, alebo volanie pripojenia zabaľte do poslucháča DOMContentLoaded.

Chyba: doména nie je povolená

Pridajte svoju doménu medzi povolené domény widgetu na stránke Webové widgety v službe app.thunderphone.com. localhost nie je v produkcii automaticky povolený; pridajte ho do zoznamu na lokálne testovanie.


Ďalšie kroky