Open in
יצירת וידג
הגדירו וידג
דף וידג'טים לאינטרנט (/dashboard/web-widgets) יוצר ומנהל
את המפתחות הניתנים לפרסום שמפעילים את הווידג'ט הקולי של ThunderPhone שניתן להטמיע.
כל מה שגרסת ה-API של המדריך הזה
עושה באמצעות cURL, דף זה עושה באמצעות טופס — ובנוסף הוא יוצר עבורכם את קוד
ההטמעה.
יצירת וידג'ט
- לחצו על וידג'ט חדש ובחרו מצב
- מצב סוכן — הווידג'ט מפעיל תמיד סוכן אחד שתבחרו מהרשימה הנפתחת. ההגדרה הפשוטה ביותר.
- מצב Webhook — בכל הפעלה של וידג'ט, ThunderPhone קורא לכתובת ה-Webhook שלכם והשרת שלכם מחזיר את תצורת הסוכן עבור אותו מבקר (ניתוב לפי דף, משתמשים מחוברים, השקות מדורגות). השאירו את ה-URL ריק כדי להשתמש ב-Webhook המוגדר כברירת מחדל של הארגון שלכם; בעת הזנת URL חדש, תוכלו גם להגדיר אותו כברירת המחדל של הארגון.
- פרטו את הדומיינים המותרים
נדרש לפחות דומיין אחד, ודפדפנים יכולים להתחיל הפעלות רק משמות המארח שתפרטו. תווים כלליים של תת-דומיין, כגון
*.example.com, מותרים (הם תואמים לתת-דומיינים, ולא לדומיין עצמו); תווים כלליים ללא דומיין, כגון*, נדחים. הרשימה מונעת שימוש חוזר מזדמן במפתח שלכם באתרים אחרים, אך אינה אמצעי אימות: סקריפט מחוץ לדפדפן יכול לשלוח כל כותרתOrigin.localhostאינו מותר אוטומטית בייצור; הוסיפו אותו לרשימה כדי לבדוק מקומית מול ממשק ה-API של הייצור. - בחרו את דריסות הדפדפן
סמנו כל הגדרת הפעלה שהדף שלכם שולח: הקשר הדף, משתנים, קול, שפה. וידג'טים חדשים אינם מקבלים אף הגדרה, ובקשת הפעלה הכוללת הגדרה שאינה מופעלת נכשלת עם
400. המפתח שלכם ציבורי, לכן אפשרו רק את מה שאתם משתמשים בו. ראו דריסות דפדפן. - תנו לו שם, הפעילו אותו וצרו אותו
המתג הפעלת וידג'ט קובע אם המפתח מקבל הפעלות — תוכלו ליצור וידג'ט מושבת ולהפעיל אותו בעת ההשקה.
קבלת קוד ההטמעה
מיד לאחר היצירה (או באמצעות לחצן הטמעה בכל שורה), תיבת דו-שיח להטמעה יוצרת קוד מוכן להדבקה עם המפתח הניתן לפרסום שלכם ממולא:
- React — קטע
<ThunderPhoneWidget />עבור אפליקציות עם bundler. - תג script — זוג של
<script>מ-CDN וגיליון סגנונות עבור כל אתר.
תיבת הדו-שיח גם מציגה תצוגה מקדימה של אפשרויות מראה בסיסיות — כותרת, צבע ראשי, מיקום בפינה ועיצוב בהיר/כהה — ומשלבת את הבחירות שלכם בקטע הקוד. להפניה המלאה למאפיינים, לנקודות חיבור לעיצוב ולאפשרות ללא ממשק, עיינו בתיעוד ה-SDK של הווידג'ט.
ניהול וידג'טים מהרשימה
כל שורה נערכת במקומה:
- מצב / סוכן — עברו בין מצב סוכן למצב webhook, או החליפו את הסוכן, באמצעות בחירות מוטבעות.
- דומיינים — הוסיפו או הסירו דומיינים מותרים כתגיות.
- הפעלה/השבתה — מתג לכל וידג'ט; וידג'טים מושבתים מפסיקים לקבל סשנים מיד.
- העברה לארגון — העתיקו או העבירו את הווידג'ט לארגון אחר שאתם שייכים אליו (העברה מסירה אותו מכאן).
- מחיקה — מבטלת את המפתח הניתן לפרסום; הווידג'ט מפסיק לפעול מיד בכל הדומיינים. לא ניתן לבטל פעולה זו.
סשנים של וידג'טים מופיעים בהיסטוריית השיחות עם אותו תמלול, הקלטה והערכה כמו שיחות טלפון.