עמוד קנוני: https://docs.teloring.com/he/docs/product/studio/troubleshooting עודכן לאחרונה: 2026-08-20T20:49:57.000Z # פתרון תקלות רוב הבעיות בסטודיו נופלות לשלוש קטגוריות: התהליך מעולם לא התחיל, התהליך התחיל אבל בחר במסלול שגוי, או שבלוק לא עשה את מה שציפיתם. עברו עליהן בסדר הזה. ## התחילו כאן 1. **האם התהליך חי?** תהליכי טיוטה ותהליכים מושהים לעולם אינם רצים על אירועים אמיתיים. 2. **האם פרסמתם אחרי העריכה האחרונה?** העריכה משנה רק את הטיוטה. 3. **האם השיחה בבעלות אדם?** ‏סטודיו מדלג על שיחות שמשויכות לנציג. 4. **הריצו בדיקה.** היא עוברת על הטיוטה עם נתוני דוגמה ומדווחת כמה בלוקים הורצו, וזו הדרך המהירה ביותר להבחין בין בעיית הגדרה לבין טריגר שמעולם לא תאם. :::note מדור **יומן ההרצה** בפאנל הצדדי מסומן **בקרוב** — היסטוריית הרצה לכל בלוק עדיין אינה זמינה. יומן ריק שם אינו עדות לכך שבלוק נכשל. ::: --- ## התהליך לעולם לא רץ | תסמין | סיבה סבירה | תיקון | | --- | --- | --- | | שום דבר לא קורה על הודעה אמיתית | התהליך עדיין בטיוטה, או שהעריכה האחרונה מעולם לא פורסמה | לחצו **פרסום**. | | שום דבר לא קורה והתג מציג **מושהה** | מישהו השהה את התהליך, או ש‑Teloring השהתה אותו כי תלות נמחקה | פתחו **⚙ הגדרות התהליך ← חידוש התהליך**. אם כרטיס התהליך מציג תג אזהרה, תקנו את הבלוק שהוא מציין ופרסמו במקום זאת. | | שום דבר לא קורה, והתהליך *כן* חי | מסנן התיבות של הטריגר אינו כולל את התיבה שממנה בדקתם | פתחו את הטריגר וסמנו את התיבה הנכונה — או הסירו את כל הסימונים כדי להאזין לכולן. | | זה עבד, ואז נעצר | נציג משויך לשיחה | ‏סטודיו אינו מתערב בשיחות שאדם מחזיק בהן. בדקו עם שיחה חדשה. | | זה נעצר עבור לקוח מסוים | הרצה קודמת מסרה את השיחה הזו לאדם | המסירה נשארת בתוקף עד שהשיחה מסומנת כטופלה או שתהליך מריץ **סיום סשן**. סמנו אותה כטופלה ונסו שוב. | | כרטיס התהליך מציג תג אזהרה | תלות נמחקה — בדרך כלל התראת אנליטיקס | תקנו את הבלוק שהוא מציין, ואז פרסמו שוב. | | תהליך מתוזמן לעולם אינו מופעל | אזור הזמן של שורת הלוח, או היום/השעה, אינם מה שחשבתם | בדקו את השורה. זכרו שמרווח ב**ימים** בלוח זמנים חוזר מוגבל ל‑24 שעות. | | ‏Webhook מחזיר שגיאה | הבקשה אינה תואמת לפורמט שנלמד | הפעילו מחדש את **למידת הבקשה הבאה** ושלחו את המבנה החדש פעם אחת. | | רק אחד מכמה תהליכים תואמים רץ | בדרך כלל זה לא כך — כל התהליכים החיים התואמים רצים. אבל ברגע שאחד מוסר את השיחה לאדם, השאר מדולגים | בדקו אם בתהליך קודם מופעלת **התערבות אנושית**. | ## התהליך רץ אבל בוחר מסלול שגוי | תסמין | סיבה סבירה | תיקון | | --- | --- | --- | | תנאי לעולם אינו תואם | לשדה **ערך / משתנה** יש סוגריים מסולסלים סביבו | כתבו `message.content`, לא `{{message.content}}`, באופרנד של תנאי. | | תנאי לעולם אינו תואם, חלק שני | שימוש ב**שווה ל** על טקסט חופשי | עברו ל**מכיל**. אנשים אמיתיים מקלידים "מכירות בבקשה", לא "מכירות". | | השוואה מספרית תמיד נכשלת | הערך אינו מספר | `גדול מ` וחבריו עובדים רק על מספרים. ערך שאינו מספרי לעולם אינו תואם. | | שתי הסתעפויות רצו כשציפיתם לאחת | מצב ההתאמה הוא **כל ההסתעפויות התואמות** | עברו ל**ההתאמה הראשונה בלבד**, וסדרו את הכללים מהספציפי ביותר לכללי ביותר. | | שום דבר אחרי התנאי לא רץ | אף כלל לא תאם ואין הסתעפות ELSE | הוסיפו הסתעפות ELSE. | | התהליך תקוע אחרי שאלה | תנאי שאחרי המתנה לא תאם לדבר ואין ELSE | התהליך ממתין להודעה הבאה ומעריך מחדש. הוסיפו הסתעפות ELSE או בלוק **סיום סשן**. | | הסתעפות רצה אבל לא עושה כלום | פורט הפלט שלה אינו מחובר | גררו מחבר מהפורט הזה. | | בלוק לעולם אינו רץ | אין לו חיבור נכנס | הבלוק מציג *הבלוק הזה אינו מחובר לשום דבר*. חברו אותו. | | שתי הודעות הגיעו באותו זמן למרות המתנה | ההמתנה מעכבת רק את ההסתעפות שלה | הסתעפויות אחיות רצות מיד, בכוונה. שימו את ההמתנה על המסלול המשותף אם אתם רוצים לעכב הכול. | ## משתנה ריק | תסמין | סיבה סבירה | תיקון | | --- | --- | --- | | `{{some.variable}}` מופיע כפשוטו בהודעה | המפתח אינו קיים בנקודה הזו בתהליך | גררו אותו מ**המשתנים הזמינים** במקום להקליד אותו. אם הוא אינו ברשימה, הבלוק שמפיק אותו אינו לפניו. | | `{{contact.name}}` ריק | איש הקשר חדש לגמרי ועדיין אין לו שם | הסתעפו על `contact.name` עם **קיים**, או כתבו ברכה שנקראת היטב גם בלעדיו. | | `{{conversation.id}}` ריק | לטריגר אין שיחה — לוח זמנים, ‏Webhook, התראת אנליטיקס, סטטוס נציג | ספקו מזהה שיחה בעצמכם, מהמטען או מחיפוש. | | `{{http.json.something}}` ריק | לכידת התגובה כבויה, או שהשדה אינו בתגובה | הפעילו את **לכידת התגובה לפעולות הבאות**, ואז שלחו את `{{http.body}}` להערה פרטית כדי לראות בדיוק מה חזר. | | `{{answers.my_field}}` ריק | **מזהה השדה** בטופס אינו `my_field` | מזהי השדות הם שמות המשתנים. בדקו את הטופס. | | `{{webhook.body.x}}` ריק | המטען אינו מכיל `x`, או שהפורמט מעולם לא נלמד | השתמשו ב**למידת הבקשה הבאה** וקראו את צ׳יפי המשתנים שנלמדו. | | `{{var.something}}` ריק | משתנים שמורים הם לכל תהליך בנפרד | ערך `var.*` שנשמר על ידי תהליך אחד אינו גלוי לתהליך אחר. | ## בלוק נכשל | בלוק | תסמין | תיקון | | --- | --- | --- | | **מענה בהודעה** | שום דבר אינו נשלח | בדקו שמזהה השיחה מתפענח, ושהערוץ עדיין יכול לשלוח (חלון WhatsApp שפג, תיבה מנותקת). | | **בקשת HTTP** | נכשלת תמיד | ‏סטודיו קורא רק לכתובות ציבוריות. ‏localhost, רשתות פרטיות ושמות מארח פנימיים חסומים. | | **בקשת HTTP** | תיבת JSON אדומה | הגוף אינו JSON תקין אחרי מילוי המשתנים. חפשו פסיק חסר או מחרוזת ללא מרכאות. | | **שליחת אימייל** | *בחרו מאיזו תיבת אימייל לשלוח* | בחרו תיבה, או העבירו את **שליחה מ** לשולח המערכתי של Teloring. | | **שליחת אימייל** | אין תיבות ברשימה הנפתחת | חברו תיבת אימייל ב[טבעת הערוצים](../ring/email.md), או השתמשו בשולח המערכתי. | | **שליחת אימייל** | הנמענים נדחו | לכל היותר 25 כתובות בסך הכול בשדות **אל**, **CC** ו‑**BCC**. חפשו טעות הקלדה. | | **קוד** | נכשל בכל פעם | הקוד חייב להחזיר ערך עם `return`. גם אין לו גישה לרשת — לשם כך השתמשו בבקשת HTTP. | | **רשומת לקוח** | *בחרו לאיזה סוג אובייקט הרשומה שייכת* | בחרו סוג אובייקט; רשימת השדות נגזרת מהבחירה הזו. | | **רשומת לקוח** | האימות נכשל | ערך אינו מתאים לסוג השדה. בדקו את הגדרות השדות של האובייקט. | | **עדכון איש קשר** | שדה חסר ברשימה הנפתחת | מופיעים רק שדות שהוגדרו בעורך השדות של איש הקשר. שדות מערכת מוגנים אינם ניתנים לכתיבה. | | **זמינות נציגים** | תמיד **מנותק** | כאשר **נציגים ספציפיים** נבחר ואף אחד לא סומן, התשובה היא תמיד מנותק — בכוונה. בחרו נציגים, או עברו ל*כל אחד בחשבון*. | | **זמינות נציגים** | נציג AI אינו נספר | נציגי AI לעולם אינם נחשבים מחוברים; אין להם סשן. | | **שעות פעילות** | תמיד **סגור** | בדקו את אזור הזמן של הלוח ואת השעות השבועיות שלו בהגדרות, והאם לוח חגים סוגר את היום. | ## בעיות בערוץ הקול | תסמין | סיבה סבירה | תיקון | | --- | --- | --- | | בלוקי קול חסרים בבורר | לתהליך אין טריגר **שיחה נכנסת** | רק תהליך שמתחיל בשיחה נכנסת הוא תהליך קול. | | הפרסום חסום | בלוק הודעות נמצא בתהליך קול, או להפך | הסירו את הבלוק שתג האזהרה מציין. | | ההקלטה אינה מושמעת | הקובץ אינו WAV | ‏WAV בלבד. הפורמט הבטוח הוא 8 kHz מונו PCM. | | מתקשרים שומעים שקט והקו נופל | מסלול מסתיים בלי העברה או ניתוק | סיימו כל מסלול בהודעת סיום וב**ניתוק**. | | לחיצה על מקש אינה עושה דבר | הפורט של הספרה הזו אינו מחובר | חברו כל ספרה, וגם את **פסק זמן** ואת **לא תקין**. | | העברה לנציג לעולם אינה מתחברת | הנציג אינו מחובר — אין רישום טלפון קבוע | שלבו אותה עם **זמינות נציגים**, ותמיד חברו את הפלט **נדחה**. | | לא נשמרה הקלטה | ההקלטה כבויה בטריגר | ההקלטה נשלטת רק על ידי **הקלטת השיחה** בטריגר שיחה נכנסת. | | הרצת בדיקה אינה מצלצלת בטלפון | הרצת בדיקה אינה יכולה לבצע שיחות | חייגו למספר באמת. | ## בנייה עם AI‏ (Hermes) | תסמין | סיבה סבירה | תיקון | | --- | --- | --- | | **בנייה בעזרת AI** אפור | המתג **AI Studio** כבוי בחשבון | מנהל חשבון מפעיל אותו ב[עולם AI](../ai-world.md). | | *"בתהליך הזה כבר יש בלוקים. צרו תהליך חדש כדי לבנות אחד בעזרת AI."* | פתחתם את בונה ה‑AI על תהליך שכבר יש לו קנבס | ‏Hermes בונה רק לתוך תהליך ריק, כדי שלעולם לא ימחק עבודה שמישהו עשה ידנית. צרו תהליך חדש. | | **בנה את התהליך** נדחה, עם הפניה לעורך | הקנבס נערך ידנית במהלך הריאיון | העריכות שלכם מנצחות. סיימו את התהליך בעורך, או התחילו תהליך חדש וריאיון חדש. | | תיבת ההודעה מושבתת | התהליך נבנה — השיחה נסגרת בכוונה | ערכו את התהליך על הקנבס, או צרו תהליך חדש כדי להריץ ריאיון חדש. | | השיחה נפתחת מחדש במקום הקנבס | בתהליך עדיין מוצג **⚡ המשך עם AI** | זה הריאיון שלא הושלם. השתמשו בכפתור **עריכה** בכרטיס כדי להגיע לקנבס. | | ‏Hermes בחר תיבה או צוות שגויים | נאמר לו משהו שגוי, או שהמשאב עדיין לא היה קיים | פתחו את הבלוק על הקנבס ובחרו את הנכון. צרו תיבות וצוותים חסרים *לפני* הריאיון. | | לבלוק ש‑Hermes יצר יש תג ⚠ | הוא זקוק למשהו שרק אתם יכולים לספק — בדרך כלל קובץ WAV או תבנית WhatsApp | פתחו את הבלוק ומלאו אותו. רשימת **דורש את תשומת ליבכם** בסרגל אמרה זאת במהלך הריאיון. | | *"Hermes לא הצליח לענות על זה. שלחו את ההודעה שוב."* | ה‑AI החזיר תשובה שסטודיו לא הצליח לקרוא. התור **לא** נשמר, כך ששום דבר אינו חורג מסנכרון | ההודעה שלכם מוחזרת לתיבה — לחצו שליחה שוב. | | *"התשובה הזו הייתה ארוכה מדי כדי ש‑Hermes יסיים."* | תשובה בודדת חרגה ממה שה‑AI יכול להפיק בתור אחד | שלחו את אותו דבר בחלקים קצרים יותר, או פצלו לשתי תשובות. | | הריאיון נעצר והודיע שהגיע למגבלה | ריאיון מוגבל ל‑60 שאלות, ולחשבונות יש הגבלת קצב הודעות קצרה | ההתקדמות נשמרת. המתינו רגע והמשיכו, או סיימו את התהליך ידנית בעורך. | | סגרתי את הלשונית ואיבדתי את המקום | לא איבדתם — כל תשובה נשמרת | פתחו את התהליך מחדש מרשימת סטודיו ולחצו על הכרטיס. | ## דברים שמפתיעים אנשים | התנהגות | למה זה עובד כך | | --- | --- | | עריכת תהליך חי אינה משנה דבר עד שאתם מפרסמים | הטיוטה והגרסה החיה הם עותקים נפרדים בכוונה. | | המחיקה מבקשת שתקלידו את שם התהליך | המחיקה היא לצמיתות ולוקחת איתה את הגרסאות ואת המשתנים השמורים, ולכן היא דורשת אישור מודע. | | השהיה אינה זהה למחיקה | תהליך מושהה שומר כל בלוק וניתן לחידוש בלחיצה אחת. | | מסנן ריק פירושו "הכול" | טריגר של הודעה נכנסת בלי תיבות מסומנות מאזין לכולן. | | בחירת נציגים ריקה פירושה "אף אחד" | בזמינות נציגים, בלוק **נציגים ספציפיים** שלא הושלם לא צריך להתנהג כמו *כל אחד*. | | המתנה אינה מעכבת הסתעפויות אחרות | רק ההסתעפות שההמתנה יושבת עליה מושהית. | | משתנה שמור אינו משותף בין תהליכים | `var.*` מוגדר לכל תהליך בנפרד, כדי ששני תהליכים לא ידרסו זה את זה. | | שכפול בלוק אינו מעתיק את החיבורים שלו | כמעט אף פעם אינכם רוצים שהעותק יהיה מחווט באותה צורה. | | פתקים לעולם אינם רצים | הם הערות לעורך בלבד ואינם חלק מהתהליך שפורסם. | | בניית תהליך AI מסיימת את השיחה | ברגע שהבלוקים שלכם לעריכה, בנייה מחדש הייתה חייבת לדרוס את השינויים שלכם. | ## איך להשיג יותר פרטים | היכן | מה זה מספר לכם | | --- | --- | | **הרצת בדיקה** | האם מבנה הטיוטה תקין, בלי לגעת בלקוחות. | | **הערה פרטית זמנית** | שתלו אחת בהסתעפות עם המשתנים שאתם לא בטוחים לגביהם — זו הדרך המהירה ביותר לראות מה בלוק באמת הפיק. | | **היסטוריית גרסאות** (סרגל הגרסה) | מה השתנה, מתי, ומי שינה — ואת הכפתור לחזרה לאחור. | | **יומן הלוגים** (הגדרות) | מי פרסם, השהה, חידש, שחזר או מחק תהליך. | ## הבא - [בדיקות ופרסום](./publishing.md) — שגרת שחרור בטוחה. - [מתכוני תהליכים](./examples.md) — תהליכים ידועים כתקינים להשוואה.