/dashboard/web-widgets) vytváří a spravuje
publikovatelné klíče, které zajišťují vložitelný hlasový widget ThunderPhone.
Vše, co verze tohoto průvodce pro API
provádí pomocí cURL, tato stránka provádí pomocí formuláře — navíc vám
vygeneruje kód pro vložení.
Vytvoření widgetu
1
Klikněte na Nový widget a vyberte režim
- Režim agenta — widget vždy spouští jednoho agenta, kterého vyberete z rozbalovací nabídky. Nejjednodušší nastavení.
- Režim webhooku — při každé relaci widgetu ThunderPhone zavolá vaši adresu URL webhooku a váš server vrátí konfiguraci agenta pro daného návštěvníka (směrování podle stránky, přihlášení uživatelé, nasazování). Chcete-li použít výchozí webhook organizace, nechte adresu URL prázdnou; při zadání nové adresy URL ji můžete také nastavit jako výchozí pro organizaci.
2
Uveďte povolené domény
Publikovatelné klíče jsou omezené na originy: je vyžadována alespoň jedna doména
a widget funguje pouze na hostitelských názvech, které uvedete. Zástupné znaky
pro subdomény, například
*.example.com, jsou povoleny (odpovídají subdoménám,
nikoli holé doméně); holé zástupné znaky jako * jsou odmítnuty.
localhost a 127.0.0.1 jsou vždy povoleny, takže místní vývoj
funguje, aniž byste je museli uvádět.3
Pojmenujte jej, povolte jej a vytvořte
Přepínač Povolit widget určuje, zda klíč přijímá
relace — můžete vytvořit zakázaný widget a povolit jej až při spuštění.
Získejte kód pro vložení
Ihned po vytvoření (nebo pomocí tlačítka Vložit v každém řádku) dialog pro vložení vygeneruje kód připravený k vložení s vyplněným publikovatelným klíčem:- React — fragment
<ThunderPhoneWidget />pro aplikace s bundlerem. - Značka script — dvojice CDN
<script>+ stylopis pro libovolný web.
Publikovatelné klíče (
pk_live_…) jsou záměrně veřejné — lze je bezpečně použít
v kódu front-endu. Kdykoli je zkopírujete tlačítkem kopírování v příslušném řádku.Správa widgetů ze seznamu
Každý řádek lze upravovat přímo na místě:- Režim / Agent — pomocí vložených výběrů přepínejte mezi režimem agenta a režimem webhooku nebo změňte agenta.
- Domény — přidávejte nebo odebírejte povolené domény jako štítky.
- Povolit/zakázat — přepínač pro každý widget; zakázané widgety okamžitě přestanou přijímat relace.
- Převést do organizace — zkopírujte nebo přesuňte widget do jiné organizace, jejímž jste členem (přesunutím jej odtud odeberete).
- Smazat — zruší publikovatelný klíč; widget okamžitě přestane fungovat na všech doménách. Tuto akci nelze vrátit zpět.
Další kroky
Referenční dokumentace SDK widgetu
Podrobnosti o komponentě React, bezhlavém hooku a skriptu CDN.
Směrování v režimu webhooku
Vraťte konfiguraci agenta pro každého návštěvníka ze svého serveru.