# בניית תהליך שיחה בסטודיו — בלוקים, בדיקה והפעלה

> בסטודיו בונים שלוחה טלפונית שלמה מבלוקים על מפה — שאלות, תנאים, טבלאות, מייל ו-SMS — בודקים בסימולטור, ומפעילים בלחיצה אחת על "שמירה והפעלה".

כתובת: https://ivr.pitronai.com/help/studio/build-a-flow/ · עודכן: 2026-10-11

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

> **לפני שמתחילים:**
> - קו מחובר לאתר, והרשאה לערוך את השלוחה.
> - חשבון Cloudflare חינמי משלכם. מחברים אותו פעם אחת, בלחיצה על **חיבור ל-Cloudflare** ואישור במסך של Cloudflare. בלי חיבור אפשר לבנות ולבדוק, וההפעלה תרוץ מעצמה אחרי החיבור.
> - מומלץ לעבוד ממחשב: המפה, הגרירה וקיצורי המקלדת נוחים במסך גדול.
> - לבנייה עם AI צריך מפתח Gemini אישי (בהגדרות **AI ומפתחות**).

## צעדים

1. בסייר הקבצים, היכנסו לשלוחה שבתוכה תיבנה השלוחה החדשה. בסרגל הפעולות (צד שמאל), לחצו על **חדש** ובחרו **יצירת שלוחה**. נפתח החלון **שלוחה חדשה**.
2. בחלון, עברו ללשונית **בנייה מאפס** ולחצו על הכרטיס **מפה ריקה** (**פתיחת הסטודיו**). נפתח חלון קטן לפרטי השלוחה.
3. מלאו **שם טכני (מספר השלוחה)**, למשל 8, ו-**שם תצוגה**, למשל "רישום לשיעור". לחצו **צור ופתח את הסטודיו**. השלוחה נוצרת כשלוחת API, והסטודיו נפתח עם בלוק **התחלה**.
4. במפה הריקה, לחצו **הצעד הראשון**. נפתח חלון הכלים, מסודר בתיקיות. בחרו כלי, למשל **השמעה** מהתיקייה **שיחה עם המאזין**. הבלוק נכנס למפה, מחובר ל-**התחלה**.
5. בפאנל **בלוק** (בצד שמאל של המסך), מלאו את ההגדרות של הבלוק: את הטקסט להקראה, את השאלה, את התנאי. השינויים נכנסים למפה מיד.
6. כדי להוסיף את הצעד הבא, לחצו על ＋ ביציאה פנויה בתחתית הבלוק. המשיכו כך עד שכל השיחה בנויה. כדי לחבר יציאה לבלוק שכבר קיים, גררו אותה אל הכרטיס שלו.
7. לחצו על הלשונית **בדיקות**. אם מופיעות שגיאות, לחצו על כל אחת ותגיעו לבלוק שצריך תיקון.
8. לחצו על **שמירה והפעלה** (או `Ctrl+S`). התהליך נשמר, עולה לאוויר, והשלוחה מחוברת אליו. אפשר להתקשר.

![הסטודיו במסך מלא עם התהליך "רישום לשיעור": בלוקים מחוברים על המפה, והגדרות הבלוק "קבוצה גדולה?" בפאנל שבצד.](https://ivr.pitronai.com/help/_assets/shot-build-a-flow-studio-c75cc767dc.webp)

1. הלשוניות של הפאנל: **בלוק**, **בדיקות**, **הכנה**, **סימולטור**, **שיחות**, **AI**, **תבניות** ו-**נתונים**.
2. בלוק במפה. לחיצה עליו פותחת את ההגדרות שלו, ומהיציאות שבתחתיתו ממשיכים לבלוק הבא.
3. ההגדרות של הבלוק שנבחר — כאן תנאי שבודק כמה משתתפים נרשמו.
4. **שמירה והפעלה** — שומר את התהליך ומפעיל את השלוחה בלחיצה אחת.

## מה רואים בסוף

- ההודעה "הקוד באוויר וההגדרות נשמרו בשלוחה ✓".
- בסייר הקבצים, השלוחה מופיעה מסוג API. הלשונית הראשית שלה היא **הגדרת API**, ובראשה הלשונית **סטודיו** עם המפה ששמרתם.
- שיחה לשלוחה עוברת בבלוקים לפי הסדר במפה. אחרי השיחה הראשונה היא מופיעה בלשונית **שיחות**.

## איפה נמצא הסטודיו

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

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

## סרגל הכלים

| כפתור | מה הוא עושה |
|---|---|
| **שם המערכת** | השם של התהליך. הוא גם הכותרת שלפיה הקוד נשמר |
| **ביטול (Ctrl+Z)** ו-**ביצוע מחדש (Ctrl+Y)** | מבטל ומחזיר שינויים במפה |
| **פשוט** / **מתקדם** | **פשוט** מציג רק את בלוקי הבסיס. **מתקדם** מציג את כל היכולות |
| **ייצוא התהליך לקובץ (לשיתוף)** | שומר את התהליך כקובץ, כדי לגבות או לשתף אותו |
| **ייבוא תהליך מקובץ** | טוען תהליך מקובץ. אם במפה כבר יש בלוקים, בוחרים אם להוסיף אותו או להחליף |
| **שמירה והפעלה** | שומר ומפעיל את השלוחה (`Ctrl+S`) |
| **מסך מלא** | הסטודיו על כל המסך |

## הלשוניות של הפאנל

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

| לשונית | מה יש בה |
|---|---|
| **בלוק** | ההגדרות של הבלוק שנבחר במפה. בלי בלוק נבחר — **הגדרות המערכת**: מה קורה בסוף התהליך, הודעה לתקלה, ושמירת השיחות והסטטיסטיקה |
| **בדיקות** | בדיקות אוטומטיות של התהליך: יציאה לא מחוברת, משתנה שלא נאסף, בלוק שאף שיחה לא מגיעה אליו. על הלשונית מופיע **תקין** או מספר השגיאות |
| **הכנה** | מה התהליך צריך מבחוץ כדי לעבוד, והאם זה כבר מוגדר. ראו [הכנה](https://ivr.pitronai.com/help/studio/build-a-flow/#הכנה-מה-התהליך-צריך-כדי-לעבוד) |
| **סימולטור** | שיחה לדוגמה בדפדפן, בלי טלפון |
| **שיחות** | השיחות האמיתיות שעברו בתהליך, והמסלול של כל אחת על המפה |
| **AI** | בנייה או שיפור של התהליך מתיאור במילים |
| **תבניות** | תבניות מוכנות, לטעינה או לצירוף לתהליך הקיים |
| **נתונים** | כמה שיחות הגיעו לכל בלוק ב-30 הימים האחרונים |

## תיקיות הבלוקים

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

- **שיחה עם המאזין**
- **לוגיקה ומשתנים**
- **נתונים (טבלאות)**
- **שליחה החוצה**
- **שירותי Google**
- **מודולים של ימות**
- **פקודות של ימות בשיחה**
- **פעולות בקו (API של ימות)**
- **סיום ומעברים**
- **תת־תהליכים מוכנים**
- **תבניות שלמות**

> **לתשומת לבכם:**
> בלוק מהתיקייה **מודולים של ימות** (למשל תא קולי או תור) יוצר תת-שלוחה בתוך שלוחת התהליך כשלוחצים **שמירה והפעלה**. אחרי המודול, השיחה חוזרת לתהליך וממשיכה מהיציאה **בחזרה לתהליך**.

## עבודה על המפה

- **הזזה:** גוררים כרטיס של בלוק לכל מקום במפה. גרירה על מקום ריק מזיזה את כל המפה, ו-`Ctrl` עם הגלגלת מגדיל ומקטין.
- **חיבור:** גוררים יציאה של בלוק אל כרטיס של בלוק אחר.
- **ניתוק:** לוחצים על קו ובוחרים **ניתוק הקו**. לחיצה על ＋ שבאמצע הקו מוסיפה בלוק באמצע.
- **לחיצה ימנית** על בלוק: **הגדרות הבלוק**, **שכפול** ו-**מחיקת הבלוק**. על מקום ריק: **סידור אוטומטי** ו-**התאמה למסך**.
- **בחירת כמה בלוקים:** גרירה עם `Shift` על מקום ריק מסמנת מסגרת, ו-`Ctrl` עם לחיצה מוסיף בלוק לבחירה. אחר כך אפשר לשכפל או למחוק את כולם יחד.

## בדיקה לפני הפעלה: "סימולטור"

1. בסטודיו, לחצו על הלשונית **סימולטור**. בשדה הראשון אפשר לשנות את מספר המתקשר, ובשני את מועד השיחה (למשל כדי לבדוק שעות פעילות).
2. לחצו **התקשרות**. מה שהמאזין היה שומע מופיע כבועות טקסט.
3. כשהשיחה מחכה להקשה, הקישו במקשים או הקלידו בשדה ולחצו ✓. **לא הקשתי** מדמה מאזין שלא הקיש כלום.
4. בסוף השיחה, בדקו את **פעולות חוץ שבוצעו (מדומה)** ואת **משתנים**.

הסימולטור מריץ את אותו תהליך, אבל לא שולח באמת: SMS ומיילים רק נרשמים ברשימה, ומה שנשמר בטבלאות נשמר בסימולטור בלבד. **מה ימות מקבלת?** מציג את התשובה המדויקת שהשלוחה תחזיר בכל צעד.

## "הכנה": מה התהליך צריך כדי לעבוד

חלק מהבלוקים צריכים פרטי גישה, שנשמרים כ"סוד" בחשבון Cloudflare שלכם. למשל, SMS צריך את הטוקן של הקו בימות, ומייל צריך מפתח של Resend. בלשונית **הכנה** רואים כל סוד שהתהליך צריך, למה הוא נדרש, והאם הוא כבר מוגדר. מגדירים סוד פעם אחת, והוא משמש את כל התהליכים והקודים שלכם.

1. בסטודיו, לחצו על הלשונית **הכנה**. אם חסר משהו, מופיעה הודעה אדומה, למשל "חסרים 1 סודות לפני שהתהליך יעבוד בשיחה אמיתית."
2. בכרטיס **הטוקן של הקו בימות**, לחצו **להגדיר מהקו המחובר בלחיצה**. הטוקן של הקו שפתוח באתר נשמר כסוד. אם הכפתור לא זמין, לחצו **הזנה ידנית** והדביקו מפתח API של המערכת ([איך יוצרים מפתח](https://ivr.pitronai.com/help/getting-started/connect-first-line/#יצירת-מפתח-api)).
3. בכרטיס של סוד אחר, לחצו **הזנה ידנית**, הדביקו את הערך ולחצו **שמירת הסוד**.
4. כשהכול מוגדר, מופיע **הכול מוכן.**, ועל הלשונית **הכנה** מופיע ✓.

![הלשונית "הכנה" בסטודיו: הודעה שחסר סוד אחד, כרטיס של מפתח המייל שכבר מוגדר, וכרטיס של הטוקן של הקו עם הכפתור להגדרה בלחיצה.](https://ivr.pitronai.com/help/_assets/shot-build-a-flow-setup-efa93ae817.webp)

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

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

## "שיחות" ו"נתונים": מה קרה בשיחות אמיתיות

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

1. בסטודיו, לחצו על הלשונית **שיחות**. מופיעה רשימת השיחות האחרונות. מספר המתקשר מוסתר בחלקו, למשל 052•••68.
2. אפשר לסנן: **הכול**, **נכשלו**, **נותקו**, **פעילות** או **הסתיימו**. אפשר גם לחפש לפי ספרות מהמספר.
3. לחצו על שיחה. המסלול שלה מסומן על המפה, עם מספר הצעד על כל בלוק, והבלוקים שהשיחה לא עברה בהם דוהים.
4. לחצו על צעד ברשימה **המסלול** כדי לראות את הפרטים שלו: מה המאזין שמע, מה הקיש, אילו משתנים השתנו. שיחה שנכשלה נפתחת ישר על הצעד שנפל.

![הלשונית "שיחות" בסטודיו עם שיחה פתוחה: הפרטים של השיחה, רשימת הצעדים שלה, והמסלול שלה מסומן על המפה.](https://ivr.pitronai.com/help/_assets/shot-build-a-flow-calls-5870dfdc84.webp)

1. פרטי השיחה: מתי התחילה, המספר המוסתר, כמה זמן נמשכה וכמה צעדים היו בה.
2. **המסלול** — כל צעד של השיחה לפי הסדר, ומה קרה בו.
3. המפה: הבלוקים שהשיחה עברה בהם מסומנים לפי הסדר.

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

## בנייה ושיפור עם AI

1. בסטודיו, לחצו על הלשונית **AI**. נפתח הפאנל **AI לתהליך**.
2. כתבו במילים מה המערכת צריכה לעשות, למשל "מערכת רישום לשיעור — שואלים כמה משתתפים, שומרים, ושולחים SMS אישור".
3. לחצו **בניית התהליך**. כשבמפה כבר יש תהליך, הכפתור הוא **שיפור התהליך**, ואפשר להשאיר את התיאור ריק כדי לקבל הצעות שיפור.
4. בדקו את ההצעה: שם התהליך, הבלוקים, וכמה שגיאות ואזהרות יש בה. לחצו **הכנסה למפה**, או **ביטול**.

שאלה ל-AI, למשל "איך מחליפים את קול ההקראה?", מקבלת תשובה בכותרת **תשובת ה-AI**, והמפה לא משתנה.

## תבניות: התחלה מוכנה, או צירוף לתהליך קיים

בלשונית **תבניות** יש 45 תבניות, בקטגוריות "מערכת שלמה", "שירות למתקשר", "רישום ואיסוף נתונים", "ניהול הקו", "חיבור למערכות אחרות" ו"התחלה". אפשר לחפש לפי שם או תיאור.

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

> **טיפ:**
> אם תבנית משתמשת בטבלה שכבר קיימת בתהליך, החלון מסביר מה יקרה לפני ההוספה, ומאפשר לבחור אם הבלוקים החדשים ישמרו באותה טבלה. גם הוספה וגם החלפה מתבטלות ב-`Ctrl+Z`.

## שירותי Google: Gmail בשיחה

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

את חשבון Google מחברים פעם אחת, בלשונית **הכנה** ← **חיבור לחשבון Google**. יש שתי דרכים:

| דרך | מה עושים |
|---|---|
| **Apps Script — הכי פשוט** | מעתיקים סקריפט מוכן, מדביקים אותו ב-Apps Script בחשבון Google שלכם, פורסים, ומדביקים כאן את הכתובת שקיבלתם |
| **OAuth אישי — מהיר יותר** | יוצרים OAuth Client בפרויקט Google Cloud שלכם, מעלים כאן את קובץ ה-JSON ומאשרים בחלון של Google |

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

## קיצורי מקלדת

| מקשים | מה הם עושים |
|---|---|
| `Ctrl+S` | **שמירה והפעלה** |
| `Ctrl+Z` / `Ctrl+Y` | ביטול וביצוע מחדש של שינוי במפה |
| `Delete` | מחיקת הבלוק שנבחר (או הקו שנבחר) |
| `Ctrl+D` | שכפול הבלוק שנבחר |
| `Ctrl+A` | בחירת כל הבלוקים |
| `Esc` | ביטול הבחירה, סגירת חלון הכלים, או יציאה ממסך מלא |

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

## אם משהו לא עבד

### "הקוד וההגדרות מוכנים — חברו Cloudflare (בתיבה שמעל) וההפעלה תרוץ מעצמה"

עוד לא חובר חשבון Cloudflare. מעל הסטודיו מופיעה תיבה עם **חיבור ל-Cloudflare**. לחצו, אשרו במסך של Cloudflare, וההפעלה תרוץ מעצמה כשתחזרו.

### "יש שגיאות חוסמות — תקנו אותן לפני ההפעלה"

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

### "הוסיפו לפחות בלוק אחד אחרי ההתחלה כדי לשמור"

במפה יש רק את **התחלה**. הוסיפו בלוק אחד לפחות.

### חלון "חסרים … סודות לפני שהתהליך יעבוד"

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

### "הטוקן של הקו הזה שמור בשרת האתר ואינו זמין בדפדפן"

הקו מחובר עם מפתח שנשמר **מוצפן בשרת**, ולכן אי אפשר להעתיק אותו בלחיצה. לחצו **הזנה ידנית** והדביקו מפתח API של המערכת ([איך יוצרים מפתח](https://ivr.pitronai.com/help/getting-started/connect-first-line/#יצירת-מפתח-api)).

> **זהירות:**
> אפשר להזין גם מספר מערכת וסיסמת ניהול, מופרדים בנקודתיים — אבל אז כל פעולה של התהליך היא כניסה חדשה לימות. כניסות רבות עלולות לנעול את החשבון בימות. מפתח API לא נועל, ואינו פג.

### "אין מפתח AI פעיל. הוסיפו מפתח Gemini אישי בהגדרות ה-AI של האתר."

הוסיפו מפתח Gemini אישי ב-**AI ומפתחות**, ונסו שוב. תבניות, סימולטור וכל שאר הסטודיו עובדים גם בלי מפתח.

### "עדיין אין שיחות לתהליך הזה."

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

## שאלות נפוצות

### צריך לדעת לתכנת?

לא. כל בלוק מוגדר בטופס בעברית, והסטודיו כותב את הקוד בעצמו. מי שרוצה יכול להוסיף **פעולה מותאמת (קוד)** במצב **מתקדם**.

### כמה עולה חשבון Cloudflare?

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

### איפה רואים את מה שהמתקשרים השאירו?

בלוק **נתונים** שומר בטבלה. את הטבלה רואים ועורכים בלשונית **טבלת הנתונים** של השלוחה. [שלוחת API: עורך הקוד, טבלת הנתונים ושיחה מדומה](https://ivr.pitronai.com/help/studio/api-extension/#טבלת-הנתונים-וצפייה-בנתונים).

### איך מעבירים תהליך לשלוחה אחרת, או משתפים אותו?

בסרגל הכלים של הסטודיו, לחצו **ייצוא התהליך לקובץ (לשיתוף)**. בשלוחה האחרת, פתחו את הסטודיו ולחצו **ייבוא תהליך מקובץ**. אם במפה שם כבר יש בלוקים, בוחרים אם להוסיף את התהליך או להחליף בו את הקיים.