# יצירת שלוחה חדשה: מסוג מוכן, מתבנית או מאפס

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

כתובת: https://ivr.pitronai.com/help/extensions/create-extension/ · עודכן: 2026-10-11

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

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

## צעדים

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

![החלון "שלוחה חדשה" עם שלוש הלשוניות, תיבת החיפוש והסוגים שבשימוש נפוץ.](https://ivr.pitronai.com/help/_assets/shot-create-extension-dialog-d91b3be782.webp)

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

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

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

## איך מוצאים את הסוג הנכון

בלשונית **סוגי שלוחות** הסוגים מסודרים כך שהנפוצים מופיעים ראשונים:

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

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

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

## מספר ושם לשלוחה

בחלון **יצירת שלוחה חדשה** יש שני שמות:

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

בשם הטכני מותרים אותיות, ספרות, מקף, קו-תחתון וגרשיים, עד 40 תווים. רווח אסור, כי ימות לא מקבלת אותו. מחברים מילים במקף או בקו-תחתון. למקש # כותבים `Hash`, ולמקש * כותבים `Star`.

### שלוחה בשם עברי

אפשר לתת לשלוחה שם טכני בעברית, למשל `שיעורים`. לשלוחה כזו מגיעים בתפריט קולי או בהפניה מההגדרות של שלוחה אחרת, ולא בהקשה. [ההסבר של ימות בפורום](https://f2.freeivr.co.il/post/11).

> **לתשומת לבכם:**
> **הגדרות מתקדמות** — השדה **הגדרות מתקדמות** בחלון היצירה אינו חובה. את כל ההגדרות אפשר לקבוע אחר כך, בטופס המונחה של **הגדרות שלוחה**. ראו [עריכת הגדרות של שלוחה](https://ivr.pitronai.com/help/extensions/edit-settings/).

### כשהמספר כבר תפוס

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

## כשהשלוחה שמעל היא לא תפריט

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

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

בשלוחה הראשית השאלה לא מופיעה.

## תבניות מוכנות

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

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

## בנייה מאפס

בלשונית **בנייה מאפס** יש שלוש דרכים להתחיל:

| הכרטיס | הכפתור | מה קורה |
|---|---|---|
| **מפה ריקה** | **פתיחת הסטודיו** | הסטודיו נפתח עם בלוק פתיחה, ומוסיפים צעד אחר צעד |
| **מתבנית מוכנה** | **ללשונית התבניות** | עוברים ללשונית **תבניות מוכנות** |
| **לתאר במילים ל-AI** | **פתיחה עם AI** | כותבים מה המערכת צריכה לעשות, וה-AI בונה את מפת השיחה |

גם כאן השלוחה נוצרת כשלוחת API בתוך השלוחה שבה אתם נמצאים, והסטודיו נפתח מיד. ההדרכה המלאה: [בניית תהליך שיחה בסטודיו](https://ivr.pitronai.com/help/studio/build-a-flow/) ו[צור עם AI](https://ivr.pitronai.com/help/ai/create-with-ai/).

## שינוי הסוג של שלוחה קיימת

אותו חלון משמש גם להחלפת סוג, אבל רק עם לשונית הסוגים:

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

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

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

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

### "שם השלוחה אינו חוקי"

בשם הטכני יש רווח או תו שאסור. ימות לא מקבלת רווחים ואת התווים `\ / ' " < > ? : | *`. חברו מילים במקף או בקו-תחתון, למשל `שיעורים_יומיים`.

### "המספר הזה כבר תפוס"

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

### "ההמרה לתפריט דולגה"

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

### "לא הצלחתי לקרוא את הגדרות השלוחה. שינוי הסוג בוטל כדי לא לאבד הגדרות — נסו שוב."

הקריאה של ההגדרות מימות נכשלה, ולכן הסוג לא הוחלף. נסו שוב בעוד רגע.

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

### אפשר לשנות את המספר או את השם אחרי היצירה?

כן. לחצו על השלוחה לחיצה ימנית ובחרו **שינוי שם ומספר**.

### יצרתי שלוחה בתפריט, אבל המתקשרים לא שומעים עליה. למה?

הודעת התפריט עדיין לא מזכירה אותה. האתר יכול לכתוב את הודעת התפריט לבד, משמות התת-שלוחות. ראו [הקראה אוטומטית של התפריט ושל שמות הקבצים](https://ivr.pitronai.com/help/extensions/menu-narration/).

### איך מבטלים יצירה של שלוחה?

מיד אחרי היצירה, בהודעה שקופצת, לחצו **בטל**. אפשר גם ללחוץ `Ctrl+Z`, או לפתוח את **יומן פעולות** בסרגל הפעולות.

### במה שונה תבנית מסוג רגיל?

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