Creați un widget web în tabloul de bord

Configurați un widget clic-pentru-a-vorbi pentru site-ul dumneavoastră din pagina Widgeturi web — fără apeluri API necesare.

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 — widgetul rulează întotdeauna un agent pe care îl alegeți din lista derulantă. Cea mai simplă configurare.
   • Mod webhook — la fiecare sesiune a widgetului, ThunderPhone apelează URL-ul webhookului dvs., iar serverul dvs. returnează configurația agentului pentru acel vizitator (rutare per pagină, utilizatori autentificați, lansări graduale). Lăsați URL-ul necompletat pentru a utiliza webhookul implicit al organizației dvs.; când introduceți un URL nou, îl puteți seta și ca implicit pentru organizație.
2. Enumerați domeniile permise

   Este necesar cel puțin un domeniu, iar browserele pot începe sesiuni numai de la numele de gazdă pe care le enumerați. Sunt permise metacaractere pentru subdomenii, precum *.example.com (acestea corespund subdomeniilor, nu domeniului de bază); metacaracterele simple, precum *, sunt respinse. Lista împiedică reutilizarea ocazională a cheii dvs. pe alte site-uri, dar nu reprezintă autentificare: un script din afara unui browser poate trimite orice antet Origin. localhost nu este permis automat în producție; adăugați-l în listă pentru a testa local cu API-ul de producție.

3. Alegeți suprascrierile din browser

   Bifați fiecare setare de sesiune trimisă de pagina dvs.: Contextul paginii, Variabile, Voce, Limbă. Widgeturile noi nu acceptă niciuna, iar o solicitare de sesiune care include o setare dezactivată eșuează cu 400. Cheia dvs. este publică, așa că permiteți numai ceea ce utilizați. Consultați Suprascrieri din browser.

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

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#