פתרון תקלות
רוב הבעיות בסטודיו נופלות לשלוש קטגוריות: התהליך מעולם לא התחיל, התהליך התחיל אבל בחר במסלול שגוי, או שבלוק לא עשה את מה שציפיתם. עברו עליהן בסדר הזה.
התחילו כאן
- פתחו הרצות. זה עונה על השאלה הגדולה ביותר קודם: האם התהליך רץ בכלל?
- אין הרצות בכלל → אף טריגר לא תאם. המשיכו עם התהליך לעולם לא רץ.
- יש הרצות → פתחו את החדשה ביותר. ההצגה החוזרת מראה את המסלול שהיא עברה, ופאנל השלבים מראה בדיוק מה כל בלוק קיבל והחזיר. המשיכו עם התהליך רץ אבל בוחר מסלול שגוי.
- האם התהליך חי? תהליכי טיוטה ותהליכים מושהים לעולם אינם רצים על אירועים אמיתיים.
- האם פרסמתם אחרי העריכה האחרונה? העריכה משנה רק את הטיוטה.
- האם השיחה בבעלות אדם? סטודיו מדלג על שיחות שמשויכות לנציג.
- בצעו חזרה כללית. לצ'טבוט, הסימולטור משחזר את השיחה בשניות בלי לשלוח דבר. לכל השאר, הרצת בדיקה עוברת על הטיוטה פעם אחת עם נתוני דוגמה.
קראו את ההרצה במקום לנחש
על רוב הטבלאות שלמטה אפשר לענות ישירות מהרצה. הועבר לבלוק בפאנל השלבים מציג כל הגדרה עם המשתנים ממולאים, כך שמשתנה ריק או ענף שגוי נראים במקום להיות מנוחשים. ראו הרצות.
התהליך לעולם לא רץ
| תסמין | סיבה סבירה | תיקון |
|---|---|---|
| שום דבר לא קורה על הודעה אמיתית | התהליך עדיין בטיוטה, או שהעריכה האחרונה מעולם לא פור סמה | לחצו פרסום. |
| שום דבר לא קורה והתג מציג מושהה | מישהו השהה את התהליך, או ש‑Teloring השהתה אותו כי תלות נמחקה | פתחו ⚙ הגדרות התהליך ← חידוש התהליך. אם כרטיס התהליך מציג תג אזהרה, תקנו את הבלוק שהוא מציין ופרסמו במקום זאת. |
| שום דבר לא קורה, והתהליך כן חי | מסנן התיבות של הטריגר אינו כולל את התיבה שממנה בדקתם | פתחו את הטריגר וסמנו את התיבה הנכונה — או הסירו את כל הסימונים כדי להאזין לכולן. |
| זה עבד, ואז נעצר | נציג משויך לשיחה | סטודיו אינו מתערב בשיחות שאדם מחזיק בהן. בדקו עם שיחה חדשה. |
| זה נעצר עבור לקוח מסוים | הרצה קודמת מסרה את השיחה הזו לאדם | המסירה נשארת בתוקף עד שהשיחה מסומנת כטופלה או שתהליך מריץ סיום סשן. סמנו אותה כטופלה ונסו שוב. |
| כרטיס התהליך מציג תג אזהרה | תלות נמחקה — בדרך כלל התראת אנליטיקס | תקנו את הבלוק שהוא מציין, ואז פרסמו שוב. |
| תהליך מתוזמן לעולם אינו מופעל | אזור הזמן של שורת הלוח, או היום/השעה, אינם מה שחשבתם | בדקו את השורה. זכרו שמרווח בימים בלוח זמנים חוזר מוגבל ל‑24 שעות. |
| Webhook מחזיר שגיאה | הבקשה אינה תואמת לפורמט שנלמד | הפעילו מחדש את למיד ת הבקשה הבאה ושלחו את המבנה החדש פעם אחת. |
| תהליך שינוי בשיחה / שינוי באובייקט אינו מופעל כאשר תהליך אחר או סוכן ה‑AI ביצעו את השינוי | כברירת מחדל הטריגרים האלה מתעלמים משינויים שנעשו על ידי אוטומציות, כדי שתהליך לא ייכנס ללולאה על עצמו | פתחו את הטריגר והפעילו להגיב גם לשינויים שנעשו על ידי אוטומציות. שרשראות עדיין נעצרות אחרי 5 תהליכים לעומק. |
| רק אחד מכמה תהליכים תואמים רץ | בדרך כלל זה לא כך — כל התהליכים החיים התואמים רצים. אבל ברגע שאחד מוסר את השיחה לאדם, השאר מדולגים | בדקו אם בתהליך קודם מופעל שיוך סוכן AI / נציג אנושי. |
התהליך רץ אבל בוחר מסלול שגוי
| תסמין | סיבה סבירה | תיקון |
|---|---|---|
| תנאי לעולם אינו תואם | לשדה ערך / משתנה יש סוגריים מסולסלים סביבו | כתבו 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. |
| שליחת אימייל | אין תיבות ברשימה הנפתחת | חברו תיבת אימייל בטבעת הערוצים, או השתמשו בשולח המערכתי. |
| שליחת אימייל | הנמענים נדחו | לכל היותר 25 כתובות בסך הכול בשדות אל, CC ו‑BCC. חפשו טעות הקלדה. |
| קוד | נכשל בכל פעם | הקוד חייב להחזיר ערך עם return. גם אין לו גישה לרשת — לשם כך השתמשו בבקשת HTTP. |
| הוספה / עדכון של רשומה | בחרו אובייקט | בחרו את האובייקט; רשימת השדות נגזרת מהבחירה הזו. אי אפשר לפרסם תהליך בלעדיו. |
| הוספה / עדכון של רשומה | האימות נכשל | ערך אינו מתאים לסוג השדה, שדה חובה ריק, או רשומה מקושרת לא קיימת. בדקו את שדות האובייקט; skipped_fields מציין מה לא נשמר. |
| מחיקת רשומה | in_use | רשומות אחרות עדיין מקושרות לרשומה הזו. הסירו קודם את הקישורים. |
| עדכון איש קשר | שדה חסר ברשימה הנפתחת | מופיעים רק שדות שהוגדרו בבונה האובייקטים (אובייקט אנשי הקשר). שדות מערכת מוגנים אינם ניתנים לכתיבה. |
| זמינות נציגים | תמיד מנותק | כאשר נציגים ספציפיים נבחר ואף אחד לא סומן, התשובה היא תמיד מנותק — בכוונה. בחרו נציגים, או עברו לכל אחד בחשבון. |
| זמינות נציגים | נציג AI אינו נספר | נציגי AI לעולם אינם נחשבים מחוברים; אין להם סשן. |
| שעות פעילות | תמיד סגור | בדקו את אזור הזמן של הלוח ואת השעות השבועיות שלו בהגדרות, והאם לוח חגים סוגר את היום. |
בעיות בערוץ הקול
| תסמין | סיבה סבירה | תיקון |
|---|---|---|
| בלוקי קול חסרים בבורר | לתהליך אין טריגר שיחה נכנסת | רק תהליך שמתחיל בשיחה נכנסת הוא תהליך קול. |
| הפרסום חסום | בלוק הודעות נמצא בתהליך קול, או להפך | הסירו את הבלוק שתג האזהרה מציין. |
| ההקלטה אינה מושמעת | הקובץ אינו WAV | WAV בלב ד. הפורמט הבטוח הוא 8 kHz מונו PCM. |
| מתקשרים שומעים שקט והקו נופל | מסלול מסתיים בלי העברה או ניתוק | סיימו כל מסלול בהודעת סיום ובניתוק. |
| לחיצה על מקש אינה עושה דבר | הפורט של הספרה הזו אינו מחובר | חברו כל ספרה, וגם את פסק זמן ואת לא תקין. |
| העברה לנציג לעולם אינה מתחברת | הנציג אינו מחובר — אין רישום טלפון קבוע | שלבו אותה עם זמינות נציגים, ותמיד חברו את הפלט נדחה. |
| לא נשמרה הקלטה | ההקלטה כבויה בטריגר | ההקלטה נשלטת רק על ידי הקלטת השיחה בטריגר שיחה נכנסת. |
| הרצת בדיקה אינה מצלצלת בטלפון | הרצת בדיקה אינה יכולה לבצע שיחות | חייגו למספר באמת. |
בנייה עם AI (Hermes)
| תסמין | סיבה סבירה | תיקון |
|---|---|---|
| בנייה בעזרת AI אפור | המתג AI Studio כבוי בחשבון | מנהל חשבון מפעיל אותו בעולם AI. |
| "בתהליך הזה כבר יש בלוקים. צרו תהליך חדש כדי לבנות אחד בעזרת AI." | פתחתם את בונה ה‑AI על תהליך שכבר יש לו קנבס | Hermes בונה רק לתוך תהליך ריק, כדי שלעולם לא ימחק עבודה שמישהו עשה ידנית. צרו תהליך חדש. |
| בנה את התהליך נדחה, עם הפניה לעורך | הקנבס נערך ידנית במהלך הריאיון | העריכות שלכם מנצחות. סיימו את התהליך בעורך, או התחילו תהליך חדש וריאיון חדש. |
| תיבת ההודעה מושבתת | התהליך נבנה — השיחה נסגרת בכוונה | ערכו את התהליך על הקנבס, או צרו תהליך חדש כדי להריץ ריאיון חדש. |
| השיחה נפתחת מחדש במקום הקנבס | בתהליך עדיין מוצג ⚡ המשך עם AI | זה הריאיון שלא הושלם. השתמשו בכפתור עריכה בכרטיס כדי להגיע לקנבס. |
| Hermes בחר תיבה או צוות שגויים | נאמר לו משהו שגוי, או שהמשאב עדיין לא היה קיים | פתחו את הבלוק על הקנבס ובחרו את הנכון. צרו תיבות וצוותים חסרים לפני הריאיון. |
| לבלוק ש‑Hermes יצר יש תג ⚠ | הוא זקוק למשהו שרק אתם יכולים לספק — בדרך כלל קובץ WAV או תבנית WhatsApp | פתחו את הבלוק ומלאו אותו. רשימת דורש את תשומת ליבכם בסרגל אמרה זאת במהלך הריאיון. |
| "Hermes לא הצליח לענות על זה. שלחו את ההודעה שוב." | ה‑AI החזיר תשובה שסטודיו לא הצליח לקרוא. התור לא נשמר, כך ששום דבר אינו חורג מס נכרון | ההודעה שלכם מוחזרת לתיבה — לחצו שליחה שוב. |
| "התשובה הזו הייתה ארוכה מדי כדי ש‑Hermes יסיים." | תשובה בודדת חרגה ממה שה‑AI יכול להפיק בתור אחד | שלחו את אותו דבר בחלקים קצרים יותר, או פצלו לשתי תשובות. |
| הריאיון נעצר והודיע שהגיע למגבלה | ריאיון מוגבל ל‑60 שאלות, ולחשבונות יש הגבלת קצב הודעות קצרה | ההתקדמות נשמרת. המתינו רגע והמשיכו, או סיימו את התהליך ידנית בעורך. |
| סגרתי את הלשונית ואיבדתי את המקום | לא איבדתם — כל תשובה נשמרת | פתחו את התהליך מחדש מרשימת סטודיו ולחצו על הכרטיס. |
הסימולטור
| תסמין | סיבה סבירה | תיקון |
|---|---|---|
| 💬 בדוק את התהליך אינו בפאנל | הבלוק שנבחר אינו טריגר הודעה נכנסת | הסימולטור מתחיל רק מהטריגר הזה. לחצו עליו בקנבס קודם. |
| "בשלב זה ניתן לבדוק כך רק את הטריגר ״הודעה נכנסת״." | הבלוק שהתחלתם ממנו הוא טריגר אחר | השתמשו בהרצת בדיקה לאלה, או הוסיפו טריגר הודעה נכנסת. |
| הבוט עונה אחרת ממה שענה בייצור | אתם מדברים עם הטיוטה, לא עם הגרסה שפורסמה | זו ההתנהגות המתוכננת. פרסמו, ואז השוו להרצה אמיתית בהרצות. |
| הסימולטור שואל על ענף במקום לבחור בו | הענף תלוי בערך שהסימולציה לא הביאה — Webhook, משתנה שמור, בלוק קוד, שליפה מה‑CRM | בחרו מה המערכת החיצונית הייתה מחזירה. ראו כשהסימולטור שואל אתכם שאלה. |
| שעות פעילות או זמינות נציגים תמיד שואלים | הם קוראים מצב מערכת חי, שחזרה כללית לא אמורה להתייעץ איתו | ענו במקרה שאתם רוצים לבדוק. כך בודקים התנהגות שאחרי שעות העבודה באמצע היום. |
| כפתור ענף אומר לא מחובר לכלום | ליציאה הזו לא מחובר כלום | חברו אותה. בייצור התהליך היה נעצר שם. |
| שום דבר אינו מופיע בהרצות אחרי סימולציה | הרצה יבשה אינה הרצה | כך תוכנן — הסימולטור אינו רושם דבר. השתמשו בהרצת בדיקה אם אתם רוצים הרצה מתועדת. |
| "הסימולציה הזו פגה. התחל סימולציה חדשה." | 30 דקות של חוסר פעילות | שום דבר לא אבד, כי שום דבר לא נשמר. התחילו מחדש. |
| "הסימולציה נעצרה לאחר מספר רב של שלבים…" | התהליך הריץ מספר חריג של בלוקים בתור אחד | חפשו לופ — שני בלוקים שמצביעים זה על זה. |
| אימייל או Webhook לא התרחשו | כל פעולה חיצונית מדולגת בכוונה | התמליל קורא בשם כל אחת מהן. כדי לבדוק מסירה אמיתית, פרסמו לתיבת בדיקה. |
דברים שמפתיעים אנשים
| התנהגות | למה זה עובד כך |
|---|---|
| עריכת תהליך חי אינה משנה דבר עד שאתם מפרסמים | הטיוטה והגרסה החיה הם עותקים נפרדים בכוונה. |
| המחיקה מבקשת שתקלידו את שם התהליך | המחיקה היא לצמיתות ולוקחת איתה את הגרסאות ואת המשתנים השמורים, ולכן היא דורשת אישור מודע. |
| השהיה אינה זהה למחיקה | תהליך מושהה שומר כל בלוק וניתן לחידוש בלחיצה אחת. |
| מסנן ריק פירושו "הכול" | טריגר של הודעה נכנסת בלי תיבות מסומנות מאזין לכולן. |
| בחירת נציגים ריקה פירושה "אף אחד" | בזמינות נציגים, בלוק נציגים ספציפיים שלא הושלם לא צריך להתנהג כמו כל אחד. |
| המתנה אינה מעכבת הסתעפויות אחרות | רק ההסתעפות שההמתנה יושבת עליה מושהית. |
| משתנה שמור אינו משותף בין תהליכים | var.* מוגדר לכל תהליך בנפרד, כדי ששני תהליכים לא ידרסו זה את זה. |
| שכפול בלוק אינו מעתיק את החיבורים שלו | כמעט אף פעם אינכם רוצים שהעותק יהיה מחווט באותה צורה. |
| פתקים לעולם אינם רצים | הם הערות לעורך בלבד ואינם חלק מהתהליך שפורסם. |
| בניית תהליך AI מסיימת את השיחה | ברגע שהבלוקים שלכם לעריכה, בנייה מחדש הייתה חייבת לדרוס את השינויים שלכם. |
| סימולציה לעולם אינה מופיעה בהרצות | חזרה כללית אינה הרצה. שום דבר אינו נשלח ושום דבר אינו נרשם — זו כל הנקודה שלה. |
| בלוק שנמחק עדיין מופיע בהרצה ישנה | הרצה מוצגת שוב מול צילום מצב של התהליך כפי שהיה, כדי שההיסטוריה תישאר קריאה אחרי שבניתם מחדש. |
| הרצות ישנות נעלמות מעצמן | כל תהליך שומר את מספר ההרצות שהחבילה שלכם מאפשרת, הישנה יוצאת. הרצה חדשה לעולם אינה נזרקת כדי להישאר מתחת למגבלה. |
איך להשיג יותר פרטים
| היכן | מה זה מספר לכם |
|---|---|
| הרצות | מה באמת קרה בהרצה אמיתית: המסלול שנבחר, הקלט והפלט של כל בלוק, הענף שנבחר, השגיאה, התזמון. התחילו כאן. |
| הסימולטור | מה הצ'טבוט שלכם היה אומר, משוחזר בשניות, בלי לשלוח דבר. |
| הרצת בדיקה | האם מבנה הטיוטה תקין, בלי לגעת בלקוחות. |
| הערה פרטית זמנית | עדיין שימושית למעקב אחר ערך שמשתנה לאורך תהליך חי ארוך, אף שפאנל השלבים ב"הרצות" מציג עכשיו את אותו הדבר בלי לערוך את התהליך. |
| היסטוריית גרסאות (סרגל הגרסה) | מה השתנה, מתי, ומי שינה — ואת הכפתור לחזרה לאחור. |
| יומן הלוגים (הגדרות) | מי פרסם, השהה, חידש, שחזר או מחק תהליך. |
הבא
- הרצות — היסטוריית ההרצות, ואיך לקרוא הרצה אחת.
- סימולטור הצ'טבוט — חזרה כללית על שיחה בלי לשלוח אותה.
- בדיקות ופרסום — שגרת שחרור בטוחה.
- מתכוני תהליכ ים — תהליכים ידועים כתקינים להשוואה.