פתרון תקלות
רוב הבעיות בסטודיו נופלות לשלוש קטגוריות: התהליך מעולם לא התחיל, התהליך התחיל אבל בחר במסלול שגוי, או שבלוק לא עשה את מה שציפיתם. עברו עליהן בסדר הזה.
התחילו כאן
- האם התהליך חי? תהליכי טיוטה ותהליכים מושהים לעולם אינם רצים על אירועים אמיתיים.
- האם פרסמתם אחרי העריכה האחרונה? העריכה משנה רק את הטיוטה.
- האם השיחה בבעלות אדם? סטודיו מדלג על שיחות שמשויכות לנציג.
- הריצו בדיקה. היא עוברת על הטיוטה עם נתוני דוגמה ומדווחת כמה בלוקים הורצו, וזו הדרך המהירה ביותר להבחין בין בעיית הגדרה לבין טריגר שמעולם לא תאם.
הערה
מדור יומן ההרצה בפאנל הצדדי מסומן בקרוב — היסטוריית הרצה לכל בלוק עדיין אינה זמינה. יומן ריק שם אינו עדות לכך שבלוק נכשל.
התהליך לעולם לא רץ
| תסמין | סיבה סבירה | תיקון |
|---|---|---|
| שום דבר לא קורה על הודעה אמיתית | התהליך עדיין בטיוטה, או שהעריכה האחרונה מעולם לא פורסמה | לחצו פרסום. |
| שום דבר לא קורה והתג מציג מושהה | מישהו השהה את התהליך, או ש‑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. |
| שליחת אימייל | אין תיבות ברשימה הנפתחת | חברו תיבת אימייל בטבעת הערוצים, או השתמשו בשולח המערכתי. |
| שליחת אימייל | הנמענים נדחו | לכל היותר 25 כתובות בסך הכול בשדות אל, CC ו‑BCC. חפשו טעות הקלדה. |
| קוד | נכשל בכל פעם | הקוד חייב להחזיר ערך עם return. גם אין לו גישה לרשת — לשם כך השתמשו בבקשת HTTP. |
| רשומת לקוח | בחר ו לאיזה סוג אובייקט הרשומה שייכת | בחרו סוג אובייקט; רשימת השדות נגזרת מהבחירה הזו. |
| רשומת לקוח | האימות נכשל | ערך אינו מתאים לסוג השדה. בדקו את הגדרות השדות של האובייקט. |
| עדכון איש קשר | שדה חסר ברשימה הנפתחת | מופיעים רק שדות שהוגדרו בעורך השדות של איש הקשר. שדות מערכת מוגנים אינם ניתנים לכתיבה. |
| זמינות נציגים | תמיד מנותק | כאשר נציגים ספציפיים נבחר ואף אחד לא סומן, התשובה היא תמיד מנותק — בכוונה. בחרו נציגים, או עברו לכל אחד בחשבון. |
| זמינות נציגים | נציג 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 שאלות, ולחשבונות יש הגבלת קצב הודעות קצרה | ההתקדמות נשמרת. המתינו רגע והמשיכו, או סיימו את התהליך ידנית בעורך. |
| סגרתי את הלשונית ואיבדתי את המקום | לא איבדתם — כל תשובה נשמרת | פתחו את התהליך מחדש מרשימת סטודיו ולחצו על הכרטיס. |
דברים שמפתיעים אנשים
| התנהגות | למה זה עובד כך |
|---|---|
| עריכת תהליך חי אינה משנה דבר עד שאתם מפרסמים | הטיוטה והגרסה החיה הם עותקים נפרדים בכוונה. |
| המחיקה מבקשת שתקלידו את שם התהליך | המחיקה היא לצמיתות ולוקחת איתה את הגרסאות ואת המשתנים השמורים, ולכן היא דורשת אישור מודע. |
| השהיה אינה זהה למחיקה | תהליך מושהה שומר כל בלוק וניתן לחידוש בלחיצה אחת. |
| מסנן ריק פירושו "הכול" | טריגר של הודעה נכנסת בלי תיבות מסומנות מאזין לכולן. |
| בחירת נציגים ריקה פירושה "אף אחד" | בזמינות נציגים, בלוק נציגים ספציפיים שלא הושלם לא צריך להתנהג כמו כל אחד. |
| המתנה אינה מעכבת הסתעפויות אחרות | רק ההסתעפות שההמתנה יושבת עליה מושהית. |
| משתנה שמור אינו משותף בין תהליכים | var.* מוגדר לכל תהליך בנפרד, כדי ששני תהליכים לא ידרסו זה את זה. |
| שכפול בלוק אינו מעתיק את החיבורים שלו | כמעט אף פעם אינכם רוצים שהעותק יהיה מחווט באותה צורה. |
| פתקים לעולם אינם רצים | הם הערות לעורך בלבד ואינם חלק מהתהליך שפורסם. |
| בניית תהליך AI מסיימת את השיחה | ברגע שהבלוקים שלכם לעריכה, בנייה מחדש הייתה חייבת לדרוס את השינויים שלכם. |
איך להשיג יותר פרטים
| היכן | מה זה מספר לכם |
|---|---|
| הרצת בדיקה | האם מבנה הטיוטה תקין, בלי לגעת בלקוחות. |
| הערה פרטית זמנית | שתלו אחת בהסתעפות עם המשתנים שאתם לא בטוחים לגביהם — זו הדרך המהירה ביותר לראות מה בלוק באמת הפיק. |
| היסטוריית גרסאות (סרגל הגרסה) | מה השתנה, מתי, ומי שינה — ואת הכפתור לחזרה לאחור. |
| יומן הלוגים (הגדרות) | מי פרסם, השהה, חידש, שחזר או מחק תהליך. |
הבא
- בדיקות ופרסום — שגרת שחרור בטוחה.
- מתכוני תהליכים — תהליכים ידועים כתקינים להשוואה.