# פיתוחים חיצוניים — התקנה מקישור, ושיתוף פיתוח משלכם

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

כתובת: https://ivr.pitronai.com/help/extensions/shared-addons/ · עודכן: 2026-11-01

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

> **לפני שמתחילים:**
> - אתם בעלי הקו שבו מתקינים. חבר שהקו שותף איתו לא יכול להתקין פיתוחים.
> - קיבלתם קישור לפיתוח, או שיש לכם שלוחה שאתם רוצים לשתף.

## התקנת פיתוח מקישור

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

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

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

## פיתוח שפועל בקו בשבילכם

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

- באשף מופיעה כל פעולה שהפיתוח מבקש, במשפט אחד. פעולה שעולה כסף — SMS או צינתוק — מסומנת באדום, ויש לה תקרה יומית לכל התקנה: עד 200 נמענים ב-SMS ועד 20 צינתוקים.
- הפיתוח לא מקבל את הטוקן של הקו. הטוקן נשמר בחשבון שחיברתם ב-**פיתוחים אישיים**, ושם נבדקת כל בקשה: רק הפעולות שאישרתם, ורק בשלוחות של הפיתוח או בשלוחה שבחרתם בשבילו. את ext.ini הפיתוח לא יכול לכתוב.
- במקום הטוקן אפשר לתת מפתח ייעודי מוגבל שיצרתם בימות. אז גם ימות עצמה מגבילה אותו.
- בסיכום מופיע אם הפיתוח שומר נתונים, ובאיזו תדירות הוא רץ. בעדכון, פעולה חדשה, שמירת נתונים או הרצה מתוזמנת מסומנות כהרשאה חדשה ומחכות לאישור שלכם.

## עדכון לגרסה חדשה

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

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

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

## הגדרות ההתקנה

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

פיתוח שהושעה ע"י פתרון AI אי אפשר לעדכן ואי אפשר לשנות את ההגדרות שלו. אפשר רק להסיר אותו.

## הסרה

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

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

## החלפת כתובת (פיתוח עם קוד)

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

## קטלוג הפיתוחים

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

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

## דיווח על פיתוח

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

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

## שיתוף פיתוח משלכם

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

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

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