Getting Started

מושגי ליבה

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

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

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

בלוח הבקרה: פורטלי לקוחות (/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) — הפכו כל HTTP API לפעולה של סוכן. הדביקו פקודת cURL ואשף ה-AI ינסח את הגדרת הכלי, או בנו אותה ידנית; לחצן בקשת בדיקה מבצע שיחת ארגז חול לפני שתפרסו אותו. ראו חיבורי API — הממשק בלוח הבקרה של /v1/integrations.
• MCP (/dashboard/mcp-connections) — הוסיפו שרת של פרוטוקול הקשר למודל לפי 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 של תצורות סוכן על תעבורה חיה: הגדירו וריאציות (הנחיות, מנועים או הגדרות שונים), פצלו את התעבורה ביניהן והשוו תוצאות לכל וריאציה. השתמשו בו במקום לבנות ידנית לוגיקת חלוקה לדליים בוובהוק.

בלוח הבקרה: ניסויים (/dashboard/experiments) ולשונית A/B בבונה הסוכנים. ראו ניסויים (בדיקות A/B).

בעיות#

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

בלוח הבקרה: בעיות (/dashboard/issues), וכן סימון לכל שיחה בהיסטוריית השיחות. ראו מיון בעיות.

ב-API: /v1/issue-reports.

דוחות#

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

בלוח הבקרה: דוחות (/dashboard/reports). ראו דוחות.

נראות#

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

בלוח הבקרה: נראות (/dashboard/observability). ראו נראות.

התראות#

כלל התראה עוקב אחר מדד (שיעור הצלחה, שיעור כישלון, ציון ממוצע, נפח שיחות, נסיגות בחבילה) לאורך חלון זמן ומופעל כאשר הוא חוצה את הסף שלכם. התראות נשלחות לדוא"ל ול-Slack, ומפעילות אירוע alert.triggered אל נקודות הקצה של הוובהוק שלכם.

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

וובהוקים#

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

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

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

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

כל בקשה כוללת חתימת HMAC-SHA256 ב- X-ThunderPhone-Signature. עיינו ב- אימות חתימה.

כלי פונקציות#

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

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

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

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

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

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

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

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

חיוב#

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

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

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

ב-API: /v1/billing.

העוזר המובנה באפליקציה#

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

מחברים את הכול#