---
title: "יצירת וידג'ט אינטרנט בלוח הבקרה"
description: "הגדירו וידג'ט לחיצה לשיחה עבור האתר שלכם מדף וידג'טים לאינטרנט — ללא צורך בקריאות API."
---

דף **וידג'טים לאינטרנט** (`/dashboard/web-widgets`) יוצר ומנהל
את המפתחות הניתנים לפרסום שמפעילים את הווידג'ט הקולי של ThunderPhone שניתן להטמיע.
כל מה ש[גרסת ה-API של המדריך הזה](/he/guides/embed-web-widget)
עושה באמצעות cURL, דף זה עושה באמצעות טופס — ובנוסף הוא יוצר עבורכם את קוד
ההטמעה.

## יצירת וידג'ט

<Steps>
  <Step title="לחצו על וידג'ט חדש ובחרו מצב">
    - **מצב סוכן** — הווידג'ט מפעיל תמיד סוכן אחד שתבחרו
      מהרשימה הנפתחת. ההגדרה הפשוטה ביותר.
    - **מצב Webhook** — בכל הפעלה של וידג'ט, ThunderPhone קורא לכתובת
      ה-Webhook שלכם והשרת שלכם מחזיר את תצורת הסוכן
      עבור אותו מבקר (ניתוב לפי דף, משתמשים מחוברים, השקות מדורגות).
      השאירו את ה-URL ריק כדי להשתמש ב-Webhook המוגדר כברירת מחדל של הארגון שלכם;
      בעת הזנת URL חדש, תוכלו גם להגדיר אותו כברירת המחדל של הארגון.
  </Step>
  <Step title="פרטו את הדומיינים המותרים">
    נדרש לפחות דומיין אחד, ודפדפנים יכולים להתחיל
    הפעלות רק משמות המארח שתפרטו. תווים כלליים של תת-דומיין, כגון
    `*.example.com`, מותרים (הם תואמים לתת-דומיינים, ולא לדומיין
    עצמו); תווים כלליים ללא דומיין, כגון `*`, נדחים. הרשימה מונעת
    שימוש חוזר מזדמן במפתח שלכם באתרים אחרים, אך אינה אמצעי אימות: סקריפט
    מחוץ לדפדפן יכול לשלוח כל כותרת `Origin`. `localhost` אינו
    מותר אוטומטית בייצור; הוסיפו אותו לרשימה כדי לבדוק מקומית מול ממשק ה-API של הייצור.
  </Step>
  <Step title="בחרו את דריסות הדפדפן">
    סמנו כל הגדרת הפעלה שהדף שלכם שולח: **הקשר הדף**,
    **משתנים**, **קול**, **שפה**. וידג'טים חדשים אינם מקבלים אף הגדרה, ובקשת
    הפעלה הכוללת הגדרה שאינה מופעלת נכשלת עם `400`.
    המפתח שלכם ציבורי, לכן אפשרו רק את מה שאתם משתמשים בו. ראו
    [דריסות דפדפן](/he/guides/embed-web-widget).
  </Step>
  <Step title="תנו לו שם, הפעילו אותו וצרו אותו">
    המתג **הפעלת וידג'ט** קובע אם המפתח מקבל
    הפעלות — תוכלו ליצור וידג'ט מושבת ולהפעיל אותו בעת ההשקה.
  </Step>
</Steps>

## קבלת קוד ההטמעה

מיד לאחר היצירה (או באמצעות לחצן **הטמעה** בכל שורה), תיבת דו-שיח
להטמעה יוצרת קוד מוכן להדבקה עם המפתח הניתן לפרסום שלכם
ממולא:

- **React** — קטע `<ThunderPhoneWidget />` עבור אפליקציות עם bundler.
- **תג script** — זוג של `<script>` מ-CDN וגיליון סגנונות עבור כל אתר.

תיבת הדו-שיח גם מציגה תצוגה מקדימה של אפשרויות מראה בסיסיות — כותרת, צבע
ראשי, מיקום בפינה ועיצוב בהיר/כהה — ומשלבת את הבחירות שלכם
בקטע הקוד. להפניה המלאה למאפיינים, לנקודות חיבור לעיצוב ולאפשרות
ללא ממשק, עיינו ב[תיעוד ה-SDK של הווידג'ט](/he/widget/overview).

<Note>
  מפתחות הניתנים לפרסום (`pk_live_…`) הם ציבוריים בכוונה — בטוחים לשילוב
  בקוד צד הלקוח. העתיקו מפתח בכל עת באמצעות לחצן ההעתקה בשורה שלו.
</Note>

## ניהול וידג'טים מהרשימה

כל שורה נערכת במקומה:

- **מצב / סוכן** — עברו בין מצב סוכן למצב webhook, או החליפו
  את הסוכן, באמצעות בחירות מוטבעות.
- **דומיינים** — הוסיפו או הסירו דומיינים מותרים כתגיות.
- **הפעלה/השבתה** — מתג לכל וידג'ט; וידג'טים מושבתים מפסיקים
  לקבל סשנים מיד.
- **העברה לארגון** — העתיקו או העבירו את הווידג'ט לארגון אחר
  שאתם שייכים אליו (העברה מסירה אותו מכאן).
- **מחיקה** — מבטלת את המפתח הניתן לפרסום; הווידג'ט מפסיק לפעול
  מיד בכל הדומיינים. לא ניתן לבטל פעולה זו.

סשנים של וידג'טים מופיעים ב[היסטוריית השיחות](/he/guides/review-calls) עם
אותו תמלול, הקלטה והערכה כמו שיחות טלפון.

## השלבים הבאים

<CardGroup cols={2}>
  <Card title="הפניית SDK של הווידג'ט" icon="window-maximize" href="/he/widget/overview">
    פרטי רכיב React, hook ללא ממשק וסקריפט CDN.
  </Card>
  <Card title="ניתוב במצב webhook" icon="bolt" href="/he/guides/dynamic-call-config">
    החזירו מהשרת שלכם תצורת סוכן לכל מבקר.
  </Card>
</CardGroup>