Webes widget létrehozása a vezérlőpulton

Állítson be webhelyéhez kattintásra indítható hívási widgetet a Web Widgets oldalon – nincs szükség API-hívásokra.

A Web Widgets oldal (/dashboard/web-widgets) hozza létre és kezeli a ThunderPhone beágyazható hangalapú widgetjét működtető publikálható kulcsokat. Amit ezen útmutató API-verziója cURL-lel végez, azt ez az oldal egy űrlappal végzi el — ráadásul elkészíti Önnek a beágyazási kódot is.

Widget létrehozása#

1. Kattintson az Új widget elemre, és válasszon módot
   • Ügynök mód — a widget mindig egy, a legördülő listából kiválasztott ügynököt futtat. Ez a legegyszerűbb beállítás.
   • Webhook mód — minden widgetmunkamenetben a ThunderPhone meghívja az Ön webhook-URL-jét, a szervere pedig visszaadja az adott látogató ügynökkonfigurációját (oldalankénti útválasztás, bejelentkezett felhasználók, fokozatos bevezetések). Hagyja üresen az URL-t a szervezete alapértelmezett webhookjának használatához; új URL megadásakor azt szervezeti alapértelmezettként is beállíthatja.
2. Sorolja fel az engedélyezett domaineket

   Legalább egy domain szükséges, és a böngészők csak az Ön által felsorolt gépnevekről indíthatnak munkameneteket. Az olyan aldomainhelyettesítő karakterek, mint a *.example.com, engedélyezettek (aldomainekre illeszkednek, magára a domainre nem); az olyan önálló helyettesítő karaktereket, mint a *, a rendszer elutasítja. A lista megakadályozza a kulcs alkalmi újrafelhasználását más webhelyeken, de nem hitelesítés: egy böngészőn kívül futó szkript bármilyen Origin fejlécet küldhet. A localhost éles környezetben nincs automatikusan engedélyezve; adja hozzá a listához, ha helyileg szeretne tesztelni az éles API-val.

3. Válassza ki a böngészőbeli felülbírálásokat

   Jelölje be az oldal által küldött munkamenet-beállításokat: Oldalkörnyezet, Változók, Hang, Nyelv. Az új widgetek egyiket sem fogadják el, és a kikapcsolt beállítást tartalmazó munkamenet-kérés 400 hibával sikertelen lesz. A kulcsa nyilvános, ezért csak azt engedélyezze, amit használ. Lásd: Böngészőbeli felülbírálások.

4. Nevezze el, engedélyezze, majd hozza létre

   A Widget engedélyezése kapcsoló szabályozza, hogy a kulcs fogad-e munkameneteket — a widgetet letiltva is létrehozhatja, majd indításkor bekapcsolhatja.

Szerezze be a beágyazási kódot#

Közvetlenül a létrehozás után (vagy az egyes sorok Beágyazás gombjával) egy beágyazási párbeszédablak használatra kész kódot hoz létre, amelyben az Ön publikálható kulcsa már ki van töltve:

• React — egy <ThunderPhoneWidget /> kódrészlet csomagkezelőt használó alkalmazásokhoz.
• Script tag — egy CDN-es <script> + stíluslap páros bármely webhelyhez.

A párbeszédablak az alapvető megjelenési beállításokat is előnézetben mutatja — cím, elsődleges szín, sarokpozíció és világos/sötét téma —, és beépíti választásait a kódrészletbe. A teljes prop-referenciáért, a stílusbeállítási hookokért és a headless lehetőségért lásd a widget SDK dokumentációját.

Widgetek kezelése a listából#

Minden sor helyben szerkeszthető:

• Mód / Ügynök — váltson az ügynök és a webhook mód között, vagy módosítsa az ügynököt a soron belüli választókkal.
• Domainek — engedélyezett domaineket adhat hozzá vagy távolíthat el címkékként.
• Engedélyezés/letiltás — widgetenként egy kapcsoló; a letiltott widgetek azonnal leállítják a munkamenetek fogadását.
• Átvitel szervezethez — másolja vagy helyezze át a widgetet egy másik, Ön által is használt szervezethez (áthelyezéskor innen eltávolításra kerül).
• Törlés — visszavonja a publikálható kulcsot; a widget azonnal leáll minden domainen. Ez nem vonható vissza.

A widgetmunkamenetek a híváselőzményekben jelennek meg, ugyanazzal az átirattal, felvétellel és értékeléssel, mint a telefonhívások.

Következő lépések#