---
title: "Creați un widget web în tabloul de bord"
description: "Configurați un widget clic-pentru-a-vorbi pentru site-ul dumneavoastră din pagina Widgeturi web — fără apeluri API necesare."
---

Pagina **Widgeturi web** (`/dashboard/web-widgets`) creează și gestionează
cheile publicabile care alimentează widgetul vocal integrabil ThunderPhone.
Tot ce face [versiunea API a acestui ghid](/ro/guides/embed-web-widget)
cu cURL, această pagină face printr-un formular — în plus, generează codul
de încorporare pentru dumneavoastră.

## Creați un widget

<Steps>
  <Step title="Faceți clic pe Widget nou și alegeți un mod">
    - **Mod agent** — widgetul rulează întotdeauna un agent pe care îl alegeți din
      lista derulantă. Cea mai simplă configurare.
    - **Mod webhook** — la fiecare sesiune a widgetului, ThunderPhone apelează
      URL-ul webhookului dvs., iar serverul dvs. returnează configurația agentului
      pentru acel vizitator (rutare per pagină, utilizatori autentificați, lansări graduale).
      Lăsați URL-ul necompletat pentru a utiliza webhookul implicit al organizației dvs.;
      când introduceți un URL nou, îl puteți seta și ca implicit pentru organizație.
  </Step>
  <Step title="Enumerați domeniile permise">
    Este necesar cel puțin un domeniu, iar browserele pot începe sesiuni numai
    de la numele de gazdă pe care le enumerați. Sunt permise metacaractere pentru
    subdomenii, precum `*.example.com` (acestea corespund subdomeniilor, nu
    domeniului de bază); metacaracterele simple, precum `*`, sunt respinse. Lista
    împiedică reutilizarea ocazională a cheii dvs. pe alte site-uri, dar nu reprezintă
    autentificare: un script din afara unui browser poate trimite orice antet `Origin`.
    `localhost` nu este permis automat în producție; adăugați-l în listă pentru a testa
    local cu API-ul de producție.
  </Step>
  <Step title="Alegeți suprascrierile din browser">
    Bifați fiecare setare de sesiune trimisă de pagina dvs.: **Contextul paginii**,
    **Variabile**, **Voce**, **Limbă**. Widgeturile noi nu acceptă niciuna, iar
    o solicitare de sesiune care include o setare dezactivată eșuează cu `400`.
    Cheia dvs. este publică, așa că permiteți numai ceea ce utilizați. Consultați
    [Suprascrieri din browser](/ro/guides/embed-web-widget).
  </Step>
  <Step title="Denumiți-l, activați-l, creați-l">
    comutatorul **Activați widgetul** controlează dacă cheia acceptă
    sesiuni — puteți crea un widget dezactivat și îl puteți activa la lansare.
  </Step>
</Steps>

## Preluați codul de încorporare

Imediat după creare (sau prin butonul **Încorporați** al fiecărui rând), o fereastră de
încorporare generează cod gata de lipit, cu cheia publicabilă deja
completată:

- **React** — un fragment `<ThunderPhoneWidget />` pentru aplicații cu bundler.
- **Etichetă script** — o pereche CDN formată din `<script>` + foaie de stil pentru orice site.

Fereastra previzualizează și opțiunile de aspect de bază — titlu, culoare
principală, poziție în colț și temă deschisă/închisă — și include alegerile dumneavoastră
în fragment. Pentru referința completă a proprietăților, hookurile de stilizare și opțiunea
headless, consultați [documentația SDK-ului pentru widget](/ro/widget/overview).

<Note>
  Cheile publicabile (`pk_live_…`) sunt publice prin concepție — pot fi incluse în siguranță în
  codul front-end. Copiați oricând una folosind butonul de copiere din rândul său.
</Note>

## Gestionați widgeturile din listă

Fiecare rând se editează direct:

- **Mod / Agent vocal** — comutați între modul agent vocal și modul webhook sau schimbați
  agentul vocal folosind selectoare inline.
- **Domenii** — adăugați sau eliminați domenii permise sub formă de etichete.
- **Activare/dezactivare** — un comutator pentru fiecare widget; widgeturile dezactivate nu mai
  acceptă sesiuni imediat.
- **Transferați către organizație** — copiați sau mutați widgetul într-o altă organizație
  din care faceți parte (mutarea îl elimină de aici).
- **Ștergeți** — revocă cheia publicabilă; widgetul nu mai funcționează
  imediat pe toate domeniile. Această acțiune nu poate fi anulată.

Sesiunile de widget apar în [istoricul apelurilor](/ro/guides/review-calls) cu aceeași
transcriere, înregistrare și evaluare ca apelurile telefonice.

## Pașii următori

<CardGroup cols={2}>
  <Card title="Referință SDK pentru widget" icon="window-maximize" href="/ro/widget/overview">
    Detalii despre componenta React, hookul headless și scriptul CDN.
  </Card>
  <Card title="Rutare în modul webhook" icon="bolt" href="/ro/guides/dynamic-call-config">
    Returnați configurația agentului vocal pentru fiecare vizitator de pe serverul dumneavoastră.
  </Card>
</CardGroup>