ליבה
מעורבות
ניטור בזמן אמת ו-
קמפיינים יוצאים.
חיבורים
אפליקציות, ממשקי API, שרתי MCP וספקי VoIP שבהם
הסוכנים שלכם יכולים להשתמש.
ארגון
אירועים
Webhooks וכלי פונקציה עבור
הקוד שלכם.
ארגונים
ארגון הוא יחידת ההפרדה בין דיירים. כל משאב אחר — סוכנים, מספרי טלפון, שיחות ומפתחות — שייך לארגון אחד בדיוק. חשבונכם יכול להשתייך לארגונים רבים; לכל אחד מהם יתרה משלו, מפתחות משלו ורשימת חברים משלו. מפתח ה-API מסוגsk_live_ שתיצרו תחת ארגון → מפתחות מקושר
לארגון אחד. קישור זה הוא מה שהופך את REST API לשטוח כל כך:
לעולם לא תצטרכו להוסיף מזהה ארגון לנתיבי URL, מכיוון שהמפתח שלכם כבר
מזהה אותו.
בלוח הבקרה: מחליף הארגונים (בתחתית סרגל הצד) והגדרות
ארגון — כרטיסיות עבור כללי, מפתחות, התראות, הגדרות חיוב
והיסטוריית חיובים.
ב-API: /v1/orgs,
/v1/developer/api-keys.
סוכנים
סוכן הוא תצורת ה-AI שמפעילה שיחה. הוא כולל:- הנחיה שקובעת מה הסוכן אומר וכיצד הוא מתנהג — כולל פעולות שיחה כגון העברות, לחיצות על מקשי חיוג וניתוק, שהן שורות הנחיה רגילות ולא תצורה נפרדת.
- רמת מנוע (
spark,bolt,storm-*): Spark מותאם לעלות, Bolt למהירות ו-Storm לאינטליגנציה בהנחיות מורכבות. - קול לצד שפה ראשית ושפות נוספות אופציונליות — הסוכן עובר אוטומטית כאשר המתקשר מחליף שפה. ראו שפות נתמכות.
- יכולות מצורפות: אפליקציות מחוברות, חיבורי API, מאגרי ידע, שרתי MCP וכלי פונקציה מוטמעים.
- הגדרות התנהגות: סדר דיבור, מצב אישור, פס קול ברקע, פסק זמן להמתנה.
/dashboard/agents). ראו
בניית סוכן הקול הראשון שלכם.
ב-API: /v1/agents — CRUD,
שכפול, העברה, היסטוריית גרסאות ועזרי הנחיות.
מספרי טלפון
מספר טלפון שייך לארגון ומנתב שיחות נכנסות אל סוכן (ויכול לשמש גם לשיחות יוצאות). שני מקורות:- מספרי הדגמה — מספרים אמיתיים בארה״ב שמוקצים ממאגר ThunderPhone ומוכנים בתוך שניות. לשיחות נכנסות בלבד, הם עונים עם הודעת הבהרה קצרה בקול, ולוח הבקרה מגביל ארגון ל-10 מהם. מושלמים לבדיקה ראשונה; לא לייצור.
- מספרי VoIP — מובאים מהספק שלכם דרך חיבור VoIP. Twilio ו-Telnyx מתחברים ישירות (ל-Telnyx יש הגדרה מודרכת); SignalWire ו-Vonage יתווספו בקרוב — כיום ניתן להגיע אליהם באמצעות תצורת SIP ידנית, שמקבלת כל SIP trunk. לאחר ייבוא ואימות, מספרי VoIP תומכים בשיחות נכנסות ויוצאות.
/dashboard/phone-numbers).
ראו קבלת מספר טלפון.
ב-API: /v1/phone-numbers,
/v1/voip-connections,
/v1/phone-number-labels.
שיחות
כל שיחה נכנסת, שיחה יוצאת, סימולציה והפעלת וידג’ט הופכות ליומן שיחה. שיחה כוללת את התמליל המלא עם תגיות תפקיד, היסטוריית התורות המובנית (כולל קריאות לכלים), הקלטה, סכום החיוב, והערכה אופציונלית של AI ודוחות בעיות. בזמן ששיחה היא פעילה, אתם יכולים לפתוח אותה ולהאזין — אתם מצטרפים בשקט, ואיש בשיחה אינו שומע אתכם. לאחר תחילת ההאזנה, אתם יכולים ללחוש: הקלידו הנחיה שנשלחת ישירות לסוכן שלכם במהלך השיחה; המתקשר לעולם לא שומע אותה, והסוכן פועל לפיה בזמן אמת. בלוח הבקרה: היסטוריית שיחות (/dashboard/call-history) עבור
הארכיון ופרטי כל שיחה; פעילות עבור שיחות שמתנהלות כעת. ראו
סקירה, האזנה והדרכה של השיחות שלכם.
ב-API: /v1/calls — רשימה, תמליל,
היסטוריה, אודיו, הערכה, ייצוא;
/v1/issue-reports.
וידג’טים לאתר
הוידג’ט לאתר מעניק למבקרים באתר שלכם שיחה המבוססת על מיקרופון עם סוכן — ללא צורך במספר טלפון. הוא מאומת באמצעות מפתח שניתן לפרסום (pk_live_...) שמוגבל למקורות של הדומיינים
המותרים שלכם, ולכן בטוח לשימוש בקוד צד לקוח.
מפתחות פועלים באחד משני מצבים: agent (מקושר באופן קבוע לסוכן אחד)
או webhook (השרת שלכם בוחר את התצורה לכל מבקר — ראו
תצורה דינמית לכל שיחה). הפעלות וידג’ט
עוברות דרך אותה תשתית שיחות כמו שיחות טלפון.
בלוח הבקרה: וידג’טים לאתר (/dashboard/web-widgets) —
צרו וידג’טים, הגדירו את המצב והסוכן, נהלו דומיינים מורשים והעתיקו
את קטע ההטמעה. ראו
יצירת וידג’ט לאתר.
ב-API: /v1/publishable-key,
/v1/mic-session, וכן
תיעוד SDK של הווידג’ט.
בסיסי ידע
בסיס ידע הוא אוסף מסמכים שהסוכן שלכם יכול לחפש בו במהלך שיחה כדי לבסס את תשובותיו — העלו קבצים ישירות או ייבאו אותם מ- Google Drive, ולאחר מכן צרפו את בסיס הידע לסוכן בבונה. הסוכן מבצע בו שאילתות באמצעות כלי חיפוש מובנה בכל פעם שהשיחה דורשת זאת. בלוח הבקרה: ידע (/dashboard/knowledge) עבור
ספריית המסמכים; מקטע ידע בבונה כדי לצרף בסיס ידע לסוכן. ראו
הענקת בסיס ידע לסוכן שלכם.
חיבורים
חיבורים הם הדרך שבה סוכנים מגיעים לעולם החיצון. ארבעה סוגים, קבוצת סרגל צד אחת:- אפליקציות (
/dashboard/app-connections) — חיבורי OAuth אל Slack, HubSpot, Salesforce, Google Calendar, Google Sheets ו-Cal.com. התחברו פעם אחת, ולאחר מכן הפעילו כלים לפי פעולה (פרסום הודעת Slack, יצירה או עדכון של איש קשר ב-HubSpot, קביעת משבצת ב-Cal.com…) עבור כל סוכן. ראו חיבור אפליקציות. - ממשקי API (
/dashboard/api-connections) — הפכו כל HTTP API לפעולת סוכן. הדביקו פקודת cURL ואשף ה-AI ינסח את הגדרת הכלי, או בנו אותה ידנית; לחצן בקשת בדיקה מפעיל קריאת ארגז חול לפני ההשקה לייצור. ראו חיבורי API — הממשק בלוח הבקרה של/v1/integrations. - MCP (
/dashboard/mcp-connections) — הוסיפו שרת Model Context Protocol באמצעות כתובת URL, ואפשרו לסוכן להשתמש בכלים שהוא חושף. ראו הוספת שרת MCP. - VoIP (
/dashboard/voip-connections) — פרטי ספק עבור הבאת מספרי הטלפון שלכם. ראו חיבור ספק VoIP.
/v1/integrations ו-
/v1/voip-connections; ראו גם
בניית שילוב כלי.
קמפיינים
קמפיין מבצע שיחות יוצאות בהיקף רחב: העלו CSV של אנשי קשר, בחרו את הסוכן ואת מספר המוצא, והגדירו את חלון השיחות (ימים ושעות, עם התאמה לאזור זמן), מקביליות ומדיניות ניסיונות חוזרים (מספר ניסיונות מרבי ואילו תוצאות — אין מענה, תא קולי, כשל — יקבלו ניסיון חוזר). הקמפיין עובר על הרשימה ומתעד כל שיחה בהיסטוריית השיחות. בלוח הבקרה: קמפיינים (/dashboard/campaigns). ראו
הפעלת קמפיין שיחות יוצאות.
לשיחות חד-פעמיות באופן פרוגרמטי:
API לשיחות יוצאות.
ניטור בזמן אמת
בשידור חי מציג כל שיחה שמתנהלת בארגון, ומאפשר לכם לפתוח כל אחת מהן כדי להאזין וללחוש בזמן אמת. זהו ממשק הפיקוח: צפו בהנחיה חדשה מקבלת את התעבורה האמיתית הראשונה שלה, או עקבו אחר קמפיין פעיל. בלוח הבקרה: בשידור חי (/dashboard/live). ראו
צפייה ופיקוח על שיחות בזמן אמת.
סימולציות
סימולציה היא מתקשר AI שמנהל שיחה אמיתית עם הסוכן שלכם — אותו נתיב טלפוניה, תמלול אמיתי, הערכה אמיתית — כך שתוכלו לבדוק לפני (ואחרי) ההשקה לייצור. הפנו אותה לסוכן או למספר טלפון, כתבו את תרחיש המתקשר בעצמכם או צרו תרחישים באמצעות AI מההנחיה של הסוכן (כולל מקרי קצה, אם תבקשו), וצפו בשיחה בזמן אמת. תרחישים מתקבצים לחבילות שמגדירות שיעור מעבר מינימלי ויכולות לחסום מהדורות ב-CI; נסיגות ביחס לקו הבסיס שאושר מדווחות עבור כל תרחיש. בלוח הבקרה: סימולציות (/dashboard/simulations), וכן
לחצן סימולציה בתוך בונה הסוכנים. ראו
סימולציית שיחה.
ב-API: /v1/test-calls ומריץ
החבילות — ראו בדיקת סוכן מקצה לקצה.
ניסויים
ניסוי מבצע בדיקת A/B של תצורות סוכן על תעבורה חיה: הגדירו וריאנטים (הנחיות, מנועים או הגדרות שונים), חלקו את התעבורה ביניהם, והשוו תוצאות לכל וריאנט. השתמשו בו במקום לממש ידנית לוגיקת חלוקה לדליים ב-webhook. בלוח הבקרה: ניסויים (/dashboard/experiments) והלשונית
A/B בבונה הסוכנים. ראו
ניסויים (בדיקות A/B).
בעיות
בעיה היא בעיה שסומנה בשיחה מסוימת — שדווחה על ידי בודק אנושי או זוהתה באמצעות דירוג AI. בעיות כוללות חומרה, מקור וסטטוס, ודף הבעיות הוא תור המיון: סננו, בדקו את השיחה הבעייתית ועקבו אחר התיקונים. בלוח הבקרה: בעיות (/dashboard/issues), וכן
סימון בעיות לכל שיחה בהיסטוריית השיחות. ראו מיון בעיות.
ב-API: /v1/issue-reports.
דוחות
דוח עונה על שאלה בשפה טבעית לגבי נתוני השיחות שלכם (“מה היו שלוש הסיבות העיקריות לכך שמתקשרים ביקשו נציג אנושי בשבוע שעבר?”) באמצעות ניתוח שנכתב על ידי AI, ומוגדר לפי הסוכנים וטווח התאריכים שתבחרו. בלוח הבקרה: דוחות (/dashboard/reports). ראו
דוחות.
תצפיתיות
תצפיתיות היא ממשק המדדים: נפח שיחות, תוצאות ואיכות לאורך זמן, עם אפשרות סינון לפי סוכן וחלון זמן, וייצוא לניתוח המשכי. בלוח הבקרה: תצפיתיות (/dashboard/observability).
ראו תצפיתיות.
התראות
כלל התראה עוקב אחר מדד (שיעור הצלחה, שיעור כישלון, ציון ממוצע, נפח שיחות, נסיגות בסוויטה) לאורך חלון זמן ומופעל כשהוא חוצה את הסף שהגדרתם. התראות נשלחות לאימייל ול-Slack, ומפעילות אירועalert.triggered אל
נקודות הקצה של ה-webhook שלכם.
בלוח הבקרה: ארגון → התראות. ראו
התראות.
Webhooks
ThunderPhone שולחת webhooks מסוג HTTP POST לשרת שלכם כאשר אירועים מתרחשים במהלך שיחה ולאחריה. שני מודלי מסירה:- נקודות קצה של webhook (מומלץ): נהלו כתובות URL רבות ב-
/v1/developer/webhook-endpointsעם סודות נפרדים לכל נקודת קצה ומינויים לאירועים לכל נקודת קצה. - Webhook מדור קודם עם כתובת URL יחידה: כתובת URL אחת לכל ארגון. מנוהל ב-
/v1/webhookאו תחת ארגון → כללי. נשמר לצורך תאימות לאחור.
- אירועים חוסמים מצפים שהשרת שלכם יחזיר תצורה
שמשפיעה על השיחה המתנהלת — אלו הם
אירועי שיחה נכנסת
(
telephony.incoming/web.incoming). עומדות לרשותכם עד 10 שניות להגיב; במקרה של פסק זמן, הסוכן שהוקצה באופן סטטי מטפל בשיחה. - אירועים לא חוסמים הם התראות שנשלחות ללא המתנה, עם ניסיונות חוזרים באמצעות השהיה מעריכית — ראו סמנטיקת מסירה.
X-ThunderPhone-Signature. ראו
אימות חתימה.
כלי פונקציה
כלי פונקציה הוא נקודת קצה מסוג HTTP שהסוכן שלכם יכול לקרוא לה במהלך שיחה. אתם מספקים ל-ThunderPhone סכמת פונקציה בסגנון OpenAI יחד עם כתובת URL של נקודת קצה; הסוכן מחליט מתי לקרוא לה, ו- ThunderPhone מבצעת את בקשת ה-HTTP החתומה מהשרתים שלה ומחזירה את התוצאה לסוכן. סוכנים כוללים גם יכולות שיחה מובנות — העברת השיחה, שליחת קלט מלוח מקשים (DTMF), סיום השיחה, המתנה בהחזקה — שאותן אתם מפעילים באמצעות שורות הנחיה פשוטות במקום הגדרות כלים. בלוח הבקרה: הקטע חיבורי API של הבונה (ראו חיבורים). ב-API:/v1/integrations וכן
מפרט כלי הפונקציה.
צוות ותפקידים
לכל ארגון יש רשימת חברים עם שני תפקידים: חברים בונים ומתפעלים סוכנים; מנהלים מנהלים גם את הצוות ואת החיוב. הזמינו באמצעות אימייל — ההזמנות פגות לאחר 7 ימים וניתן לבטל אותן; תפריט ⋯ בשורת חבר משנה תפקידים או מסיר אדם. ניתן להגדיר כניסה יחידה לכל הארגון — ראו SSO. בלוח הבקרה: ארגון → כללי. ראו הזמינו את הצוות שלכם. ב-API:/v1/members,
/v1/invites.
חיוב
ThunderPhone פועל במודל תשלום מראש. לכל ארגון יש יתרה בדולר ארה״ב; שיחות מחייבות אותה לפי התעריף לדקה של הסוכן (רמת המנוע בתוספת חיובים — הבונה מציג את התעריף הכולל בזמן אמת בעת שינוי ההגדרות, ושפות פרימיום מוסיפות 2¢/דקה). כשהיתרה מגיעה לאפס, שיחות נכנסות נדחות ושיחות יוצאות מחזירות402 Payment Required.
הוסיפו כספים ידנית, או הפעילו טעינה אוטומטית עם סף יתרה, סכום טעינה ומגבלת הוצאה חודשית אופציונלית — כדי ששיחה לעולם לא תנותק באמצע משפט.
בלוח הבקרה: ארגון → הגדרות חיוב והיסטוריית חיובים. ראו
הוספת כספים והפעלת טעינה אוטומטית.
ב-API: /v1/billing.
הקופיילוט בתוך האפליקציה
לוח הבקרה כולל קופיילוט מובנה — שאלו אותו “איך עושים X” והוא עונה על סמך התיעוד הזה, מציע הדרכות מפורטות צעד אחר צעד שמדגישות את הפקדים בפועל, ויכול להפעיל מחדש כל אחד מהסיורים המודרכים. זו הדרך המהירה ביותר למצוא פקד שמוזכר בדף זה. ראו שאלו את הקופיילוט בתוך האפליקציה.סיכום
התחלה מהירה בלוח הבקרה
האשף בן חמשת השלבים: סוכן → חיוב → מספר → סימולציה → סקירה.
התחלה מהירה עם API
אותה שיחה ראשונה בארבע קריאות REST.
שימוש בלוח הבקרה
בנו סוכן, הוסיפו לו כספים, קבלו מספר, הריצו סימולציות וסקו שיחות.
חיבור כלים ונתונים
אפליקציות OAuth, ממשקי API מותאמים אישית, שרתי MCP וספקי VoIP.
ניתוח ושיפור
דוחות, תצפיתיות, ניסויים, בעיות והתראות.
צוות וחשבון
הזמנות ותפקידים, מפתחות API, אבטחה ו-SSO.
ספר מתכונים למפתחים
מתכוני API: שיחות נכנסות, שיחות יוצאות, הגדרה דינמית, כלים ובדיקות.
אימות חתימות webhook
הגדירו נכון את בדיקת ה-HMAC פעם אחת והשתמשו בה מחדש בכל מקום.