/dashboard/web-widgets) skapar och hanterar
de publicerbara nycklar som driver ThunderPhones inbäddningsbara röstwidget.
Allt som API-versionen av den här guiden
gör med cURL gör den här sidan med ett formulär — och genererar dessutom
inbäddningskoden åt dig.
Skapa en widget
1
Klicka på Ny widget och välj ett läge
- Agentläge — widgeten kör alltid en röstagent som du väljer i rullgardinsmenyn. Den enklaste konfigurationen.
- Webhook-läge — vid varje widgetsesssion anropar ThunderPhone din webhook-URL och din server returnerar agentkonfigurationen för den besökaren (sidbaserad dirigering, inloggade användare, utrullningar). Lämna URL:en tom för att använda organisationens standardwebhook; när du anger en ny URL kan du även ange den som organisationsstandard.
2
Lista tillåtna domäner
Publicerbara nycklar är låsta till ursprung: minst en domän krävs,
och widgeten fungerar bara på de värdnamn du listar. Jokertecken för
underdomäner som
*.example.com tillåts (de matchar underdomäner,
inte den nakna domänen); nakna jokertecken som * avvisas.
localhost och 127.0.0.1 är alltid tillåtna, så lokal utveckling
fungerar utan att du behöver lista dem.3
Namnge den, aktivera den, skapa den
Växeln Aktivera widget styr om nyckeln accepterar
sessioner — du kan skapa en inaktiverad widget och aktivera den vid lansering.
Hämta inbäddningskoden
Direkt efter skapandet (eller via knappen Bädda in på varje rad) genererar en inbäddningsdialog färdig kod att klistra in med din publicerbara nyckel ifylld:- React — ett
<ThunderPhoneWidget />-utdrag för appar med bundler. - Script-tagg — ett CDN-par med
<script>+ stilmall för alla webbplatser.
Publicerbara nycklar (
pk_live_…) är offentliga avsiktligt — de kan utan risk användas i
frontendkod. Kopiera en när som helst med kopieringsknappen på dess rad.Hantera widgetar från listan
Varje rad redigeras på plats:- Läge / Agent — växla mellan agent- och webhook-läge, eller ändra röstagenten, med inbäddade väljare.
- Domäner — lägg till eller ta bort tillåtna domäner som chips.
- Aktivera/inaktivera — en växel per widget; inaktiverade widgetar slutar omedelbart att acceptera sessioner.
- Överför till organisation — kopiera eller flytta widgeten till en annan organisation du tillhör (om du flyttar den tas den bort här).
- Ta bort — återkallar den publicerbara nyckeln; widgeten slutar fungera omedelbart på alla domäner. Detta kan inte ångras.
Nästa steg
Referens för widget-SDK
React-komponent, headless-hook och information om CDN-skript.
Dirigering i webhook-läge
Returnera agentkonfiguration per besökare från din server.