---
title: "Unda wijeti ya wavuti kwenye dashibodi"
description: "Sanidi wijeti ya kubofya ili kuzungumza kwa tovuti yako kutoka ukurasa wa Wijeti za Wavuti — hakuna miito ya API inayohitajika."
---

Ukurasa wa **Wijeti za Wavuti** (`/dashboard/web-widgets`) huunda na kusimamia
funguo zinazoweza kuchapishwa zinazoendesha wijeti ya sauti inayoweza kupachikwa ya ThunderPhone.
Kila kitu ambacho [toleo la API la mwongozo huu](/sw/guides/embed-web-widget)
hufanya kwa cURL, ukurasa huu hufanya kwa fomu — pamoja na kukuundia msimbo wa
kupachika.

## Unda wijeti

<Steps>
  <Step title="Bofya Wijeti mpya na uchague hali">
    - **Hali ya ejenti** — wijeti huendesha ejenti mmoja unayechagua kila wakati kutoka
      kwenye orodha kunjuzi. Usanidi rahisi zaidi.
    - **Hali ya webhook** — katika kila kipindi cha wijeti, ThunderPhone hupiga simu
      URL yako ya webhook na seva yako hurudisha usanidi wa ejenti
      kwa mgeni huyo (uelekezaji kwa kila ukurasa, watumiaji walioingia, uzinduzi wa hatua kwa hatua).
      Acha URL wazi ili utumie webhook chaguomsingi ya shirika lako;
      unapoingiza URL mpya, unaweza pia kuiweka kama chaguomsingi la shirika.
  </Step>
  <Step title="Orodhesha domeni zinazoruhusiwa">
    Funguo zinazoweza kuchapishwa zimefungwa kwa origin: angalau domeni moja inahitajika,
    na wijeti hufanya kazi tu kwenye majina ya hosti unayoorodhesha. Wildcard za
    subdomain kama `*.example.com` zinaruhusiwa (zinalingana na subdomain,
    si domeni tupu); wildcard tupu kama `*` hukataliwa.
    `localhost` na `127.0.0.1` zinaruhusiwa kila wakati, kwa hivyo maendeleo ya ndani
    hufanya kazi bila kuyaorodhesha.
  </Step>
  <Step title="Ipe jina, iwashe, iunde">
    Kigeuzi cha **Washa wijeti** hudhibiti ikiwa ufunguo unakubali
    vipindi — unaweza kuunda wijeti ikiwa imezimwa na kuiwasha wakati wa uzinduzi.
  </Step>
</Steps>

## Chukua msimbo wa kupachika

Mara tu baada ya kuunda (au kupitia kitufe cha **Pachika** cha kila mstari), kidirisha cha
kupachika hutengeneza msimbo ulio tayari kubandikwa wenye ufunguo wako unaoweza kuchapishwa
uliojazwa:

- **React** — kijisehemu cha `<ThunderPhoneWidget />` kwa programu za bundler.
- **Lebo ya script** — jozi ya CDN ya `<script>` + stylesheet kwa tovuti yoyote.

Kidirisha pia huonyesha awali chaguo za msingi za mwonekano — kichwa, rangi
kuu, nafasi ya kona, na mandhari ya mwanga/giza — na kujumuisha chaguo zako
kwenye kijisehemu. Kwa marejeleo kamili ya prop, hooks za urembo, na chaguo
lisilo na kiolesura, angalia [nyaraka za SDK ya wijeti](/sw/widget/overview).

<Note>
  Funguo zinazoweza kuchapishwa (`pk_live_…`) ni za umma kimakusudi — ni salama kuweka katika
  msimbo wa front-end. Nakili moja wakati wowote kwa kitufe cha kunakili kwenye mstari wake.
</Note>

## Simamia wijeti kutoka kwenye orodha

Kila mstari huhaririwa mahali pake:

- **Hali / Ejenti** — badilisha kati ya hali ya ejenti na webhook, au elekeza upya
  ejenti, kwa viteuzi vya ndani ya mstari.
- **Domeni** — ongeza au ondoa domeni zinazoruhusiwa kama chips.
- **Washa/zima** — kigeuzi kwa kila wijeti; wijeti zilizozimwa huacha
  kukubali vipindi mara moja.
- **Hamisha kwa shirika** — nakili au hamisha wijeti hadi shirika lingine
  unaloshiriki (kuhamisha huiondoa hapa).
- **Futa** — hubatilisha ufunguo unaoweza kuchapishwa; wijeti huacha kufanya kazi
  mara moja kwenye domeni zote. Hili haliwezi kutenduliwa.

Vipindi vya wijeti huonekana katika [historia ya simu](/sw/guides/review-calls) pamoja na
transkripti, rekodi, na upimaji sawa na simu za kawaida.

## Hatua zinazofuata

<CardGroup cols={2}>
  <Card title="Marejeleo ya SDK ya wijeti" icon="window-maximize" href="/sw/widget/overview">
    Maelezo ya kipengele cha React, hook isiyo na kiolesura, na script ya CDN.
  </Card>
  <Card title="Uelekezaji wa hali ya webhook" icon="bolt" href="/sw/guides/dynamic-call-config">
    Rudisha usanidi wa ejenti kwa kila mgeni kutoka kwenye seva yako.
  </Card>
</CardGroup>