Skip to main content
Pagina Widgeturi web (/dashboard/web-widgets) creează și gestionează cheile publicabile care alimentează widgetul vocal integrabil ThunderPhone. Tot ce face versiunea API a acestui ghid cu cURL, această pagină face printr-un formular — în plus, generează codul de încorporare pentru dumneavoastră.

​
Creați un widget

1

Faceți clic pe Widget nou și alegeți un mod

  • Mod agent vocal — widgetul rulează întotdeauna un agent vocal ales de dumneavoastră din lista derulantă. Cea mai simplă configurare.
  • Mod webhook — la fiecare sesiune de widget, ThunderPhone apelează URL-ul webhookului dumneavoastră, iar serverul returnează configurația agentului vocal pentru acel vizitator (rutare per pagină, utilizatori autentificați, lansări treptate). Lăsați URL-ul necompletat pentru a utiliza webhookul implicit al organizației; când introduceți un URL nou, îl puteți seta și ca implicit pentru organizație.
2

Enumerați domeniile permise

Cheile publicabile sunt restricționate la origini: este necesar cel puțin un domeniu, iar widgetul funcționează numai pe numele de gazdă pe care le enumerați. Sunt permise caracterele wildcard pentru subdomenii, precum *.example.com (acestea corespund subdomeniilor, nu domeniului fără subdomeniu); caracterele wildcard fără domeniu, precum *, sunt respinse. localhost și 127.0.0.1 sunt întotdeauna permise, astfel încât dezvoltarea locală funcționează fără a le enumera.
3

Denumiți-l, activați-l, creați-l

comutatorul Activați widgetul controlează dacă cheia acceptă sesiuni — puteți crea un widget dezactivat și îl puteți activa la lansare.

​
Preluați codul de încorporare

Imediat după creare (sau prin butonul Încorporați al fiecărui rând), o fereastră de încorporare generează cod gata de lipit, cu cheia publicabilă deja completată:
  • React — un fragment <ThunderPhoneWidget /> pentru aplicații cu bundler.
  • Etichetă script — o pereche CDN formată din <script> + foaie de stil pentru orice site.
Fereastra previzualizează și opțiunile de aspect de bază — titlu, culoare principală, poziție în colț și temă deschisă/închisă — și include alegerile dumneavoastră în fragment. Pentru referința completă a proprietăților, hookurile de stilizare și opțiunea headless, consultați documentația SDK-ului pentru widget.
Cheile publicabile (pk_live_…) sunt publice prin concepție — pot fi incluse în siguranță în codul front-end. Copiați oricând una folosind butonul de copiere din rândul său.

​
Gestionați widgeturile din listă

Fiecare rând se editează direct:
  • Mod / Agent vocal — comutați între modul agent vocal și modul webhook sau schimbați agentul vocal folosind selectoare inline.
  • Domenii — adăugați sau eliminați domenii permise sub formă de etichete.
  • Activare/dezactivare — un comutator pentru fiecare widget; widgeturile dezactivate nu mai acceptă sesiuni imediat.
  • Transferați către organizație — copiați sau mutați widgetul într-o altă organizație din care faceți parte (mutarea îl elimină de aici).
  • Ștergeți — revocă cheia publicabilă; widgetul nu mai funcționează imediat pe toate domeniile. Această acțiune nu poate fi anulată.
Sesiunile de widget apar în istoricul apelurilor cu aceeași transcriere, înregistrare și evaluare ca apelurile telefonice.

​
Pașii următori

Referință SDK pentru widget

Detalii despre componenta React, hookul headless și scriptul CDN.

Rutare în modul webhook

Returnați configurația agentului vocal pentru fiecare vizitator de pe serverul dumneavoastră.