Vytvorte webový widget na paneli

Nastavte pre svoj web widget click-to-talk na stránke Web Widgets — bez nutnosti volaní API.

Stránka Webové widgety (/dashboard/web-widgets) vytvára a spravuje verejné kľúče, ktoré poháňajú vložiteľný hlasový widget ThunderPhone. Všetko, čo verzia tohto návodu pre API vykonáva pomocou cURL, táto stránka vykonáva pomocou formulára — navyše vám vygeneruje kód na vloženie.

Vytvorte widget#

1. Kliknite na Nový widget a vyberte režim
   • Režim agenta — widget vždy spúšťa jedného agenta, ktorého vyberiete z rozbaľovacieho zoznamu. Najjednoduchšie nastavenie.
   • Režim webhooku — pri každej relácii widgetu ThunderPhone zavolá vašu URL webhooku a váš server vráti konfiguráciu agenta pre daného návštevníka (smerovanie podľa stránky, prihlásení používatelia, postupné nasadzovanie). Ak chcete použiť predvolený webhook organizácie, ponechajte URL prázdnu; pri zadaní novej URL ju môžete tiež nastaviť ako predvolenú pre organizáciu.
2. Uveďte povolené domény

   Vyžaduje sa aspoň jedna doména a prehliadače môžu spúšťať relácie len z názvov hostiteľov, ktoré uvediete. Sú povolené zástupné znaky pre subdomény, napríklad *.example.com (zhodujú sa so subdoménami, nie so samotnou doménou); samostatné zástupné znaky, napríklad *, sa odmietnu. Zoznam bráni bežnému opätovnému použitiu vášho kľúča na iných stránkach, ale nie je overením: skript mimo prehliadača môže odoslať ľubovoľnú hlavičku Origin. localhost nie je v produkcii automaticky povolený; pridajte ho do zoznamu, aby ste mohli lokálne testovať voči produkčnému API.

3. Vyberte prepisy prehliadača

   Zaškrtnite každé nastavenie relácie, ktoré odosiela vaša stránka: Kontext stránky, Premenné, Hlas, Jazyk. Nové widgety nepovoľujú žiadne a požiadavka relácie obsahujúca vypnuté nastavenie zlyhá s 400. Váš kľúč je verejný, preto povoľte len to, čo používate. Pozrite si Prepisy prehliadača.

4. Pomenujte ho, povoľte ho a vytvorte ho

   Prepínač Povoliť widget určuje, či kľúč prijíma relácie — widget môžete vytvoriť zakázaný a pri spustení ho zapnúť.

Získajte kód na vloženie#

Ihneď po vytvorení (alebo prostredníctvom tlačidla Vložiť v každom riadku) dialóg na vloženie vygeneruje kód pripravený na vloženie s vyplneným vaším verejným kľúčom:

• React — úryvok <ThunderPhoneWidget /> pre aplikácie s bundlerom.
• Značka script — dvojica CDN <script> + štýlového súboru pre ľubovoľnú stránku.

Dialóg zároveň zobrazuje ukážku základných možností vzhľadu — názov, primárnu farbu, pozíciu v rohu a svetlú/tmavú tému — a vaše voľby zapracuje do úryvku. Úplný prehľad vlastností, možností úprav štýlov a bezhlavú možnosť nájdete v dokumentácii SDK widgetu.

Spravujte widgety zo zoznamu#

Každý riadok sa upravuje priamo na mieste:

• Režim / Agent — pomocou vložených výberov prepínajte medzi režimom agenta a webhooku alebo zmeňte agenta.
• Domény — pridávajte alebo odstraňujte povolené domény ako štítky.
• Povoliť/zakázať — prepínač pre každý widget; zakázané widgety okamžite prestanú prijímať relácie.
• Preniesť do organizácie — skopírujte alebo presuňte widget do inej organizácie, do ktorej patríte (presunutím sa odtiaľto odstráni).
• Odstrániť — zruší verejný kľúč; widget okamžite prestane fungovať na všetkých doménach. Túto akciu nemožno vrátiť späť.

Relácie widgetov sa zobrazujú v histórii hovorov s rovnakým prepisom, nahrávkou a hodnotením ako telefonické hovory.

Ďalšie kroky#