Skip to main content
דף וידג’טים לאינטרנט (/dashboard/web-widgets) יוצר ומנהל את המפתחות הניתנים לפרסום שמפעילים את הווידג’ט הקולי של ThunderPhone שניתן להטמיע. כל מה שגרסת ה-API של המדריך הזה עושה באמצעות cURL, דף זה עושה באמצעות טופס — ובנוסף הוא יוצר עבורכם את קוד ההטמעה.

יצירת וידג’ט

1

לחצו על וידג'ט חדש ובחרו מצב

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

פרטו את הדומיינים המותרים

מפתחות הניתנים לפרסום מוגבלים למקור: נדרש לפחות דומיין אחד, והווידג’ט פועל רק בשמות המארח שתפרטו. תווים כלליים לתת-דומיינים כמו *.example.com מותרים (הם תואמים לתת-דומיינים, ולא לדומיין הבסיס); תווים כלליים לדומיין בסיס כמו * נדחים. localhost ו-127.0.0.1 מותרים תמיד, כך שפיתוח מקומי פועל ללא צורך לפרט אותם.
3

תנו לו שם, הפעילו אותו וצרו אותו

המתג הפעלת הווידג’ט קובע אם המפתח מקבל סשנים — תוכלו ליצור וידג’ט מושבת ולהפעיל אותו בעת ההשקה.

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

מיד לאחר היצירה (או באמצעות לחצן הטמעה בכל שורה), תיבת דו-שיח להטמעה יוצרת קוד מוכן להדבקה עם המפתח הניתן לפרסום שלכם ממולא:
  • React — קטע <ThunderPhoneWidget /> עבור אפליקציות עם bundler.
  • תג script — זוג של <script> מ-CDN וגיליון סגנונות עבור כל אתר.
תיבת הדו-שיח גם מציגה תצוגה מקדימה של אפשרויות מראה בסיסיות — כותרת, צבע ראשי, מיקום בפינה ועיצוב בהיר/כהה — ומשלבת את הבחירות שלכם בקטע הקוד. להפניה המלאה למאפיינים, לנקודות חיבור לעיצוב ולאפשרות ללא ממשק, עיינו בתיעוד ה-SDK של הווידג’ט.
מפתחות הניתנים לפרסום (pk_live_…) הם ציבוריים בכוונה — בטוחים לשילוב בקוד צד הלקוח. העתיקו מפתח בכל עת באמצעות לחצן ההעתקה בשורה שלו.

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

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

השלבים הבאים

הפניית SDK של הווידג'ט

פרטי רכיב React, hook ללא ממשק וסקריפט CDN.

ניתוב במצב webhook

החזירו מהשרת שלכם תצורת סוכן לכל מבקר.