Opret en webwidget i dashboardet

Opsæt en klik-for-at-tale-widget til dit website fra siden Webwidgets — ingen API-kald påkrævet.

Siden Webwidgets (/dashboard/web-widgets) opretter og administrerer de publicerbare nøgler, der driver ThunderPhones integrerbare stemmewidget. Alt, hvad API-versionen af denne vejledning gør med cURL, gør denne side med en formular — og den genererer også indlejringskoden for dig.

Opret en widget#

1. Klik på Ny widget, og vælg en tilstand
   • Agenttilstand — widgetten kører altid én agent, som du vælger i rullemenuen. Den enkleste opsætning.
   • Webhooktilstand — ved hver widgetsession kalder ThunderPhone din webhook-URL, og din server returnerer agentkonfigurationen for den pågældende besøgende (routing pr. side, indloggede brugere, udrulninger). Lad URL'en være tom for at bruge organisationens standardwebhook; når du indtaster en ny URL, kan du også angive den som organisationens standard.
2. Angiv de tilladte domæner

   Der kræves mindst ét domæne, og browsere kan kun starte sessioner fra de værtsnavne, du angiver. Jokertegn for underdomæner som *.example.com er tilladt (de matcher underdomæner, ikke det nøgne domæne); nøgne jokertegn som * afvises. Listen forhindrer tilfældig genbrug af din nøgle på andre websites, men er ikke godkendelse: et script uden for en browser kan sende enhver Origin-header. localhost er ikke automatisk tilladt i produktion; føj det til listen for at teste lokalt mod produktions-API'et.

3. Vælg browseroverstyringerne

   Markér hver sessionsindstilling, som din side sender: Sidekontekst, Variabler, Stemme, Sprog. Nye widgets accepterer ingen, og en sessionsanmodning med en indstilling, der ikke er aktiveret, fejler med 400. Din nøgle er offentlig, så tillad kun det, du bruger. Se Browseroverstyringer.

4. Navngiv den, aktivér den, og opret den

   Skiftet Aktivér widget styrer, om nøglen accepterer sessioner — du kan oprette en widget deaktiveret og slå den til ved lancering.

Hent indlejringskoden#

Umiddelbart efter oprettelsen (eller via knappen Indlejr på hver række) genererer en indlejringsdialog klar-til-indsæt-kode med din publicerbare nøgle indsat:

• React — et <ThunderPhoneWidget />-udsnit til apps med bundler.
• Script-tag — et CDN-<script> + stylesheet-par til ethvert website.

Dialogen viser også en forhåndsvisning af grundlæggende udseendeindstillinger — titel, primærfarve, hjørneplacering og lyst/mørkt tema — og indbygger dine valg i uddraget. Se den widget SDK-dokumentation for den fulde reference til props, stylinghooks og den headless mulighed.

Administrer widgets fra listen#

Hver række redigeres direkte:

• Tilstand / Agent — skift mellem agent- og webhooktilstand, eller skift agenten, med integrerede vælgere.
• Domæner — tilføj eller fjern tilladte domæner som chips.
• Aktivér/deaktivér — en kontakt pr. widget; deaktiverede widgets stopper straks med at acceptere sessioner.
• Overfør til organisation — kopiér eller flyt widgetten til en anden organisation, du tilhører (flytning fjerner den her).
• Slet — tilbagekalder den publicerbare nøgle; widgetten stopper straks med at virke på alle domæner. Dette kan ikke fortrydes.

Widgetsessioner vises i opkaldshistorikken med den samme transskription, optagelse og vurdering som telefonopkald.

Næste trin#