Skip to main content
מדריך זה מלווה אתכם בארבע קריאות REST הנדרשות כדי לענות לשיחת הטלפון הראשונה שלכם עם סוכן AI.
תזדקקו לחשבון ThunderPhone. ההרשמה בחינם ונמשכת פחות מדקה. מעדיפים ללחוץ במקום להשתמש ב-curl? המדריך המהיר בלוח הבקרה מוביל לאותה שיחה ראשונה בלי לכתוב קוד.

שלב 1: קבלת מפתח API

1

התחברות

פתחו את app.thunderphone.com.
2

ניווט אל מפתחות

עברו אל Organization → Keys בלוח הבקרה.
3

יצירת מפתח

לחצו על Create key, תנו לו שם והעתיקו את הערך sk_live_.... המפתח הגולמי מוצג פעם אחת בלבד — שמרו אותו במנהל הסודות שלכם מיד.
נתקעתם? יצירת מפתח API לשרת מסביר את התהליך הזה שלב אחר שלב, וה-copilot בתוך האפליקציה יכול להדגיש עבורכם כל פקד בזמן אמת.
לאורך מדריך זה, החליפו את sk_live_YOUR_API_KEY בערך שהעתקתם זה עתה. המפתח מזהה את הארגון שלכם אוטומטית, ולכן לעולם אינכם צריכים להוסיף מזהה ארגון לכתובות URL.

שלב 2: יצירת סוכן

סוכן מגדיר כיצד ה-AI מטפל בשיחות — הנחיה, קול, רמת מוצר, כלים וזכאות לווידג’ט.
רמות מוצר: spark מותאם לעלות, bolt למהירות, ו- storm-base / storm-extra לבינה בהנחיות מורכבות. ראו סוכנים להשוואה המלאה.

שלב 3: הקצו מספר טלפון

קריאה זו מבקשת מספר ממאגר ההדגמה של ThunderPhone ומקצה את הסוכן החדש שלכם כמטפל בשיחות נכנסות. (כדי להביא מספר משלכם מספק VoIP, עיינו במקום זאת ב-חיבורי VoIP.)
המספר החדש שלכם מתחיל במצב status="provisioning" ועובר למצב active בתוך כמה שניות; עד שתסגרו את הדפדפן, המספר יהיה מוכן לקבל שיחות.

שלב 4 (אופציונלי): הגדירו webhook

לאירועים בזמן אמת (ניתוב שיחות דינמי, עיבוד לאחר שיחה), הוסיפו נקודת קצה של webhook. הירשמו רק לאירועים שאתם צריכים.
התשובה כוללת secret חד-פעמי — העתיקו אותו למנהל הסודות שלכם. השתמשו בסוד זה כדי לאמת את הכותרת X-ThunderPhone-Signature בבקשות נכנסות (עיינו ב- סקירת Webhooks).

שלב 5: בדקו את הסוכן שלכם

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

השלבים הבאים

הוסיפו כלי פונקציות

אפשרו לסוכן שלכם לקרוא לממשקי ה-API שלכם במהלך שיחה.

בצעו שיחות יוצאות

הפעילו שיחות מהקוד שלכם.

טפלו ב-webhooks

הגיבו לאירועי שיחה בזמן אמת.

הפניית API מלאה

כל נקודת קצה ציבורית, מתועדת.