Skip to main content
רכיב הווידג’ט הקולי המוטמע של ThunderPhone מאפשר למבקרים באתר שלכם לדבר עם סוכן AI ישירות מהדפדפן. אין צורך בשיחת טלפון — המשתמשים לוחצים על לחצן ומתחילים שיחה קולית בזמן אמת המופעלת באמצעות ThunderPhone. הווידג’ט מוצג כסרגל במראה זכוכית המותאם לערכות נושא בהירות וכהות, עם צבעי הדגשה ומיקום הניתנים להתאמה אישית. הוא מופץ כחבילת npm @thunderphone/widget וזמין גם דרך CDN עבור סביבות ללא מאגד מודולים.
ווידג'ט ThunderPhone בערכות נושא בהירות וכהות עם מגוון צבעי הדגשה

דרישות מקדימות

לפני הטמעת הווידג’ט, השלימו את שלושת השלבים הבאים ב-לוח הבקרה של ThunderPhone:
1

צרו מפתח API שניתן לפרסום

עברו אל מפתחים בהגדרות לוח הבקרה וצרו מפתח שניתן לפרסום. מפתחות שניתנים לפרסום מתחילים ב-pk_live_ ובטוחים לשילוב בקוד בצד הלקוח.
2

הגדירו דומיינים מורשים

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

צרו ווידג'ט Web

עברו אל ווידג’טים של Web בלוח הבקרה וצרו ווידג’ט. בחרו את הסוכן שברצונכם לחשוף ואת המפתח שניתן לפרסום שבו תרצו להשתמש. הסוכן נפתר אוטומטית מתצורת המפתח שניתן לפרסום.
מפתחות שניתנים לפרסום (pk_live_...) אינם זהים לאסימוני ה-API הסודיים שלכם. מפתחות שניתנים לפרסום מיועדים לשימוש בצד הלקוח ומוגבלים להפעלות ווידג’ט בדומיינים המורשים שלכם. לעולם אל תשתמשו באסימון ה-API הסודי שלכם בקוד בצד הלקוח.

התחלה מהירה

התקינו את החבילה:
הוסיפו את הווידג’ט לאפליקציה שלכם:
זה הכול. המשתמשים שלכם יראו סרגל שיחה במראה זכוכית שמחבר אותם לסוכן ה-AI שלכם בלחיצה אחת.

התאמה אישית

לווידג’ט יש ארבעה מאפייני מראה:
שלושה מאפיינים נוספים מתאימים את ההפעלה במקום את המראה — כולם מועברים לבקשת ההפעלה כאשר מתחילה שיחה: עיינו ב-הפניה לרכיב React לקבלת טבלת המאפיינים המלאה. לממשק משתמש מותאם אישית לחלוטין, השתמשו ב-hook ללא ממשק כדי לנהל את ההפעלה הקולית בזמן שאתם בונים ממשק משלכם. ה-hook חושף רמות שמע בזמן אמת לבניית תצוגות חזותיות המגיבות לשמע.

אפשרויות שילוב

בחרו את שיטת השילוב המתאימה למערך שלכם:

רכיב React

רכיב ממשק משתמש מוכן מראש עם בקרות שיחה מובנות ותצוגת סטטוס. ייבאו, העבירו מאפיינים, וסיימתם.

Hook ללא ממשק

שליטה מלאה בממשק המשתמש. ה-Hook useThunderPhone מנהל את סשן הקול בזמן שאתם בונים ממשק משלכם.

CDN / תגית Script

אין צורך ב-bundler. טענו את הווידג’ט באמצעות תגית script עבור אתרים סטטיים, WordPress וסביבות אחרות שאינן React.

עיצוב

הווידג’ט כולל ערכות נושא בהירות וכהות מובנות, הנשלטות באמצעות המאפיין theme, וצבע הדגשה הנשלט באמצעות המאפיין primaryColor. להתאמה אישית מעמיקה יותר, תוכלו לדרוס מאפיינים מותאמים אישית ומחלקות CSS. לפרטים, עיינו במדריך העיצוב.
זקוקים לעזרה? צרו איתנו קשר בכתובת support@thunderphone.com