ThunderPhone v3 jau veikia.Viską atlikite savarankiškai – nuo 2 ct/min.Skaityti pranešimą

Widget

CDN / scenarijaus žyma

Pridėkite ThunderPhone balso valdiklį prie bet kurios svetainės nenaudodami rinkinio kūrimo įrankio

CDN versija viduje komplektuoja React, todėl valdiklį galite naudoti statinėse svetainėse, WordPress, Webflow arba bet kuriame puslapyje, kuriame galite pridėti HTML. Nereikia nei npm, nei paketų rinkiklio, nei sistemos.

CDN URL

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>

Pagrindinis naudojimas

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

Valdiklis prijungiamas prie tikslinio elemento ir rodomas kaip fiksuotos padėties juosta viename iš peržiūros srities kampų (numatytoji padėtis – bottom-right, valdoma parinktimi position). Prijungimo elementas yra tik React šaknis – jo vieta puslapyje neturi įtakos tam, kur rodomas valdiklis.


Prijungimo parinktys

ThunderPhone.mount() priima tas pačias parinktis kaip React komponentas ir papildomą savybę element:

ParinktisTipasPrivalomaNumatytoji reikšmėAprašas
elementstring | HTMLElementTaip--CSS parinkiklis (pvz., '#thunderphone') arba DOM elemento nuoroda.
publishableKeystringTaip--Viešinamas API raktas (pk_live_...). Agentas automatiškai nustatomas pagal rakto valdiklio konfigūraciją.
theme'light' | 'dark'Ne'light'Spalvų schema.
primaryColorstringNe'#000000' (light) / '#ffffff' (dark)CSS spalvos eilutė, naudojama kaip akcento spalva.
titlestringNe'Voice assistant'Valdiklio juostoje rodomas tekstas.
position'bottom-right' | 'bottom-left' | 'top-right' | 'top-left'Ne'bottom-right'Fiksuota padėtis peržiūros srityje.
apiBasestringNe'https://api.thunderphone.com/v1'API bazinio URL perrašymas.
languagestringNe--Sesijos kalbos perrašymas – kalbos kodas arba lokalė, pvz., en, es arba fr-FR. Jei nenustatyta, taikoma sukonfigūruota agento kalba. Reikalingas language rakto naršyklės perrašymo nustatymuose.
voicestringNe--Sesijos balso perrašymas – balso pavadinimas, pvz., maria. Jei nenustatyta, taikomas sukonfigūruotas agento balsas. Reikalingas voice rakto naršyklės perrašymo nustatymuose.
contextstringNe--Agentui perduodamas sesijos faktinis puslapio arba svetainės kontekstas. Serverio pusėje sutrumpinamas iki 12 000 simbolių. Reikalingas context rakto naršyklės perrašymo nustatymuose.
onConnect() => voidNe--Iškviečiama prisijungus prie balso sesijos.
onDisconnect() => voidNe--Iškviečiama pasibaigus sesijai.
onError(error) => voidNe--Iškviečiama įvykus klaidoms. Klaida turi laukus error (kodas) ir message.
ringtoneboolean | stringNefalseJungiantis leisti skambėjimo toną. Numatytojo skambėjimo tono reikšmė true, o pasirinktinio garso – URL eilutė.

Išvalymas

ThunderPhone.mount() grąžina valdiklio egzempliorių su išvalymo metodais:

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

Tiek unmount(), tiek destroy() atlieka tą patį veiksmą – atjungia bet kokį aktyvų balso seansą ir pašalina valdiklį iš DOM. Naudokite tą, kuris jūsų kode atrodo tinkamesnis.


Pavyzdžiai

Tamsi tema su pasirinktine spalva

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

Pasirinktinė padėtis

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

Su įvykių atgaliniais iškvietimais

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

Su skambėjimo tonu

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

Naudojant DOM elemento nuorodą

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

WordPress / CMS integracija

Pridėkite tai prie pasirinktinio HTML bloko arba savo temos poraštės:

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

Trikčių šalinimas

Valdiklis nerodomas

Įsitikinkite, kad įkelti ir CSS, ir JS failai. Naršyklės konsolėje patikrinkite, ar nėra tinklo klaidų. Prieš iškviesdami ThunderPhone.mount(), patikrinkite, ar tikslinis elementas yra DOM.

ThunderPhone neapibrėžtas

Scenarijus dar neįkeltas. Įsitikinkite, kad <script> žyma, skirta widget.js, yra prieš prijungimo iškvietimą, arba apgaubkite prijungimo iškvietimą DOMContentLoaded klausytoju.

Domenas neleidžiamas

Pridėkite savo domeną prie valdiklio leidžiamų domenų sąrašo puslapyje Žiniatinklio valdikliai adresu app.thunderphone.com. Gamybinėje aplinkoje localhost automatiškai neleidžiamas; pridėkite jį prie sąrašo, kad galėtumėte testuoti vietoje.


Tolesni veiksmai