מושגי יסוד

מפה של כל מה שבמערכת — מה עושה כל אובייקט, היכן הוא נמצא בלוח הבקרה ואיזה API נוגע בו.

ThunderPhone היא פלטפורמה מלאה לבניית סוכני קול מבוססי AI, להפעלתם ולשיפורם. דף זה הוא המפה: כל מושג שתפגשו, בקטע קצר משלו, עם ממשק לוח הבקרה וה-API שתומך בו. עברו עליו פעם אחת, ואז חזרו אליו בכל פעם שמונח דורש הבהרה.

סרגל הצד בלוח הבקרה משקף מבנה זה:

ארגונים#

ארגון הוא יחידת הדיירות. כל משאב אחר — סוכנים, מספרי טלפון, שיחות ומפתחות — שייך לארגון אחד בלבד. החשבון שלכם יכול להשתייך לארגונים רבים; לכל אחד מהם יתרה משלו, מפתחות משלו ורשימת חברים משלו.

מפתח ה-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, שכפול, העברה, היסטוריית גרסאות ועזרי הנחיות.

קולות#

ספריית הקולות כוללת את הקולות שסוכן יכול להשתמש בהם, את הדוגמאות שניתן להשמיע, השפות התואמות, קבוצות המגדר והמבטא, וכל תוספת תשלום עבור קול או שפה פרימיום. כלי דגימה בתשלום יכול לסנתז משפט משלכם באורך של 1–500 תווים לפני שתבחרו.

ארגונים זכאים יכולים גם ליצור קולות מותאמים אישית מדוגמת WAV או MP3 קצרה. לקולות מותאמים אישית יש מכסה וסטטוס יצירה אסינכרוני; לאחר שהם מוכנים, הם מופיעים באותו בורר סוכנים כמו קולות מהספרייה.

בלוח הבקרה: קולות (/dashboard/voices). ראו ספריית קולות וקולות מותאמים אישית.

ב-API: /v1/voices, דוגמאות קול, ו- קולות מותאמים אישית.

מספרי טלפון#

מספר טלפון שייך לארגון ומנתב שיחות נכנסות לסוכן (ויכול לשמש גם לשיחות יוצאות). שני מקורות:

• מספרי ThunderPhone — מספרים אמיתיים בארה״ב שמוקצים ממאגר המספרים של ThunderPhone, פעילים בתוך שניות, $1/לחודש בתוספת 1¢/דקה תשלום נוסף. הם מתחילים עם שיחות נכנסות בלבד. מנהל מערכת בארגון יכול לבקש שיחות יוצאות מדף מספרי הטלפון; ThunderPhone בוחנת כל בקשה ידנית, ומספרים מאושרים יכולים לבצע שיחות ולהריץ קמפיינים. ארגון יכול להחזיק 25 מספרים כברירת מחדל.
• מספרי VoIP — מובאים מהספק שלכם דרך חיבור VoIP. Twilio ו-Telnyx מתחברים ישירות באמצעות מפתח API (ל-Telnyx יש גם תהליך מודרך להגדרת חשבון חדש); SignalWire, Vonage, Plivo וכל קו SIP אחר מתחברים באמצעות הגדרת SIP, תצורת SIP ידנית. לאחר ייבוא ואימות, מספרי 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.

פורטלי לקוחות#

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

בלוח הבקרה: פורטלי לקוחות (/dashboard/client-portals). ראו פורטלי לקוחות.

ב-API: /v1/client-portals עבור ממשק הניהול למנהלים.

וידג'טים לאינטרנט#

ה־וידג'ט האינטרנט מעניק למבקרים באתר שלכם שיחה מבוססת מיקרופון עם סוכן — ללא צורך במספר טלפון. הוא מאומת באמצעות מפתח לפרסום (pk_live_...) שבו דפדפנים יכולים להשתמש רק מהדומיינים המורשים שלכם, ולכן הוא בטוח לשימוש בקוד בצד הלקוח. רשימת הדומיינים אינה אימות, והגדרות ההפעלה שדף עשוי לשלוח מושבתות עד שתאפשרו אותן במפתח.

מפתחות פועלים באחד משני מצבים: agent (מקושר באופן קבוע לסוכן אחד) או webhook (השרת שלכם בוחר את התצורה לכל מבקר — ראו תצורה דינמית לכל שיחה). מפגשי וידג'ט זורמים דרך אותה תשתית שיחות כמו שיחות טלפון.

בלוח הבקרה: וידג'טים לאינטרנט (/dashboard/web-widgets) — צרו וידג'טים, הגדירו את המצב והסוכן, נהלו דומיינים מורשים והעתיקו את מקטע ההטמעה. ראו יצירת וידג'ט אינטרנט.

ב-API: /v1/publishable-key, /v1/mic-session, וכן תיעוד ה-SDK של הווידג'ט.

מאגרי ידע#

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

בלוח הבקרה: ידע (/dashboard/knowledge) עבור ספריית המסמכים; סעיף ידע בבונה כדי לצרף מאגר לסוכן. ראו הוספת מאגר ידע לסוכן שלכם.

חיבורים#

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

• יישומים (/dashboard/app-connections) — חיבורי OAuth אל Slack, HubSpot, Salesforce, Google Calendar, Google Sheets ו- Cal.com. התחברו פעם אחת, ולאחר מכן הפעילו לכל פעולה כלים נפרדים (פרסום הודעה ב-Slack, יצירה או עדכון של איש קשר ב-HubSpot, קביעת משבצת ב-Cal.com…) עבור כל סוכן. ראו חיבור יישומים.
• ממשקי API (/dashboard/api-connections) — הפכו כל API מסוג HTTP לפעולת סוכן. הדביקו פקודת cURL ואשף ה-AI ינסח את הגדרת הכלי, או בנו אותה ידנית; לחצן בקשת בדיקה מפעיל שיחת ארגז חול לפני שתפרסמו. ראו חיבורי API — הממשק בלוח הבקרה של /v1/integrations.
• MCP (/dashboard/mcp-connections) — הוסיפו שרת Model Context Protocol באמצעות כתובת URL ואפשרו לסוכן להשתמש בכלים שהוא חושף. ראו הוספת שרת MCP.
• VoIP (/dashboard/voip-connections) — פרטי גישה של ספקים עבור הבאת מספרי הטלפון שלכם. ראו חיבור ספק VoIP.

ThunderPhone חושפת גם נקודת קצה MCP משלה, כך שלקוח MCP חיצוני יכול לרשום סוכנים, לבדוק שיחות ותמלילים ולבצע שיחות. ראו שימוש ב-ThunderPhone כשרת MCP.

ב-API: /v1/integrations, /v1/mcp-servers, וכן /v1/voip-connections; ראו גם בניית שילוב כלי.

קמפיינים#

קמפיין מבצע שיחות יוצאות בהיקף רחב: העלו קובץ CSV של אנשי קשר, בחרו את הסוכן ואת מספר המוצא, והגדירו את חלון החיוג (ימים ושעות, בהתאמה לאזור זמן), מקביליות ומדיניות ניסיונות חוזרים (מספר ניסיונות מרבי ואילו תוצאות — ללא מענה, תא קולי, כשל — יקבלו ניסיון חוזר). הקמפיין עובר על הרשימה ומתעד כל שיחה בהיסטוריית השיחות.

בלוח הבקרה: קמפיינים (/dashboard/campaigns). ראו הפעלת קמפיין שיחות יוצאות.

לשיחות פרוגרמטיות חד-פעמיות: ה- API לשיחות יוצאות.

ניטור בזמן אמת#

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

בלוח הבקרה: בזמן אמת (/dashboard/live). ראו צפייה ופיקוח על שיחות בזמן אמת.

סימולציות#

סימולציה היא מתקשר מבוסס AI שמנהל שיחה אמיתית עם הסוכן שלכם — אותו נתיב טלפוניה, תמליל אמיתי והערכה אמיתית — כך שתוכלו לבדוק לפני (ואחרי) שתפרסמו. הפנו אותה לסוכן או למספר טלפון, כתבו בעצמכם את תרחיש המתקשר או צרו תרחישים באמצעות AI מההנחיה של הסוכן (כולל מקרי קצה, אם תבקשו), וצפו בשיחה בזמן אמת.

תרחישים מתאגדים לחבילות שקובעות שיעור מעבר מינימלי ויכולות לחסום מהדורות ב-CI; רגרסיות ביחס לקו הבסיס המאושר מדווחות עבור כל תרחיש.

בלוח הבקרה: סימולציות (/dashboard/simulations), וכן לחצן סימולציה בתוך בונה הסוכנים. ראו סימולציית שיחה.

ב-API: /v1/test-calls ומריץ החבילות — ראו בדיקת סוכן מקצה לקצה.

ערכות אימות#

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

בלוח הבקרה: ערכות אימות (/dashboard/validation) עבור מערך הנתונים של הארגון, ולשונית אימות בבונה הסוכנים עבור הרצות. ראו ערכות אימות.

ב-API: /v1/validation-sets ונקודות הקצה להפעלה חוזרת של סוכן או דוגמה באותו דף עזר.

ניסויים#

ניסוי מבצע בדיקות 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 שלכם.

בלוח הבקרה: הארגון → התראות. ראו התראות.

קריאות חוזרות#

ThunderPhone שולח קריאות חוזרות מסוג HTTP POST לשרת שלכם כאשר דברים מתרחשים במהלך שיחה ולאחריה. שני מודלי מסירה:

• נקודות קצה לקריאות חוזרות (מומלץ): נהלו כתובות רבות ב- /v1/developer/webhook-endpoints עם סודות לכל נקודת קצה ומינויים לאירועים לכל נקודת קצה.
• קריאה חוזרת מדור קודם עם כתובת יחידה: כתובת אחת לכל ארגון. מנוהלת ב- /v1/webhook או תחת ארגון → כללי. נשמרת לתאימות לאחור.

האירועים מתחלקים לשתי קטגוריות:

• אירועים חוסמים מצפים שהשרת שלכם יגיב עם תצורה שמעצב את השיחה המתנהלת — אלה הם אירועי שיחה נכנסת (telephony.incoming / web.incoming). שיחת טלפון ממתינה עד 13 שניות, כולל ניסיון חוזר אחד, וסשן וידג'ט ממתין 10 שניות. אין סוכן גיבוי: ללא תצורה שמישה, שיחת הטלפון מסתיימת וסשן הווידג'ט נכשל.
• אירועים שאינם חוסמים הם התראות מסוג שגרו ושכחו, שמבוצעים להן ניסיונות חוזרים עם השהיה מעריכית — ראו סמנטיקת מסירה.

כל בקשה כוללת חתימת HMAC-SHA256 עם חותמת זמן ב- X-ThunderPhone-Signature-V2, בנוסף ל- X-ThunderPhone-Signature הוותיקה שפועלת על גוף הבקשה בלבד. ראו אימות חתימה.

כלי פונקציה#

כלי פונקציה הוא נקודת קצה מסוג HTTP שהסוכן שלכם יכול לקרוא לה במהלך שיחה. אתם מספקים ל-ThunderPhone סכמת פונקציה בסגנון OpenAI יחד עם כתובת של נקודת קצה; הסוכן מחליט מתי לקרוא לה, ו- ThunderPhone שולח את בקשת ה-HTTP החתומה מהשרתים שלו ומעביר את התוצאה בחזרה לסוכן.

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

בלוח הבקרה: הקטע חיבורי API של הבונה (ראו חיבורים).

ב-API: /v1/integrations ו- מפרט כלי הפונקציה.

צוות ותפקידים#

לכל ארגון יש רשימת חברים עם שני תפקידים: חברים בונים ומתפעלים סוכנים; מנהלים מנהלים גם את הצוות ואת החיוב. הזמינו באמצעות אימייל — ההזמנות פגות לאחר 7 ימים וניתן לבטלן; תפריט ⋯ בשורת חבר מאפשר לשנות תפקידים או להסיר אדם. ניתן להגדיר כניסה יחידה לכל הארגון — ראו SSO.

בלוח הבקרה: ארגון → כללי. ראו הזמנת הצוות שלכם.

ב-API: /v1/members, /v1/invites.

חיוב#

ThunderPhone פועל בתשלום מראש. לכל ארגון יש יתרה בדולרים אמריקאיים; שיחות מחייבות אותה לפי תעריף הסוכן לדקה (דרגת המנוע בתוספת היטלים — הבונה מציג את התעריף הכולל בזמן אמת כשאתם משנים הגדרות, ו- שפות נוספות נבחרות מוסיפות 3¢/דקה). כאשר היתרה מגיעה לאפס, שיחות נכנסות נדחות ושיחות יוצאות מחזירות 402 Payment Required.

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

בלוח הבקרה: ארגון → הגדרות חיוב ו- היסטוריית חיובים. ראו הוספת כספים והפעלת הוספת יתרה אוטומטית, וכן את מדריך התמחור המלא.

ב-API: /v1/billing.

הקופיילוט בתוך היישום#

לוח הבקרה כולל קופיילוט מובנה — שאלו אותו "איך מבצעים X" והוא משיב על סמך מסמכים אלה, מציע מדריכים שלב אחר שלב שמדגישים את הפקדים האמיתיים, ויכול להפעיל מחדש כל אחד מהסיורים המודרכים. זו הדרך המהירה ביותר למצוא פקד שמוזכר בדף זה. ראו שאלו את הקופיילוט בתוך היישום.

מחברים הכול יחד#